hnhx-archive/librex
1
0
Fork 0
mirror of https://github.com/hnhx/librex.git synced 2025-01-10 11:47:24 -03:00
Code Issues Projects Releases Packages Wiki Activity
Framework and javascript free privacy respecting meta search engine
40 commits 3 branches 0 tags 2.5 MiB
PHP 68.4%
CSS 17.7%
Shell 7.7%
Dockerfile 6.2%
Find a file
hnh.mtf e2b353dfc0 fixed api for text results
2022-03-02 13:15:34 +01:00
engines fixed api for text results 2022-03-02 13:15:34 +01:00
misc added bibliogram and nitter front ends , fixed the api for text results 2022-03-02 13:12:09 +01:00
static special text results are now using curl_multi , removed image from wikipedia result because it slowed down things too much 2022-03-01 17:28:37 +01:00
api.php added bibliogram and nitter front ends , fixed the api for text results 2022-03-02 13:12:09 +01:00
config.php added bibliogram and nitter front ends , fixed the api for text results 2022-03-02 13:12:09 +01:00
donate.php special text results are now using curl_multi , removed image from wikipedia result because it slowed down things too much 2022-03-01 17:28:37 +01:00
index.php special text results are now using curl_multi , removed image from wikipedia result because it slowed down things too much 2022-03-01 17:28:37 +01:00
LICENSE Create LICENSE 2022-02-23 20:56:00 +01:00
opensearch.xml first commit 2022-02-17 21:14:56 +01:00
README.md added bibliogram and nitter front ends , fixed the api for text results 2022-03-02 13:12:09 +01:00
search.php special text results are now using curl_multi , removed image from wikipedia result because it slowed down things too much 2022-03-01 17:28:37 +01:00

README.md

LibreX

A privacy respecting free as in freedom meta search engine

Online instances

If you wish to get your instance added create an issue with the new instance label and this information:

  • the URL of your instance
  • the country where your instance is being hosted

Your request will be rejected if your instance:

  • contains JavaScript
  • contains cookies
  • contains ads
  • has been heavily modified

Features

  • Ad free
  • JavaScript free
  • Cookie free
  • Torrent results
  • Supports special queries (e.g.: 1 btc to usd , what does xyz mean etc.)
  • Tracking snippets from URLs are removed
  • Image results are converted to base64 to prevent clients from connecting to Google servers
  • Supports both POST and GET requests
  • Popular social media sites (YouTube, Instagram, Twitter) are replaced with privacy friendly front-ends
  • Easy to use JSON API for developers
  • No 3rd party libs are used
  • Easy to setup

Hosting

Hosting LibreX should be easy since no 3rd party PHP libs are used.

If you want to host it just for yourself a PHP development server should be enough:

git clone https://github.com/hnhx/librex.git
cd librex
sudo php -S 127.0.0.1:80

If you want to host an online instance you should consider using a production web server (e.g.: nginx).

API

Example API request: .../api.php?q=gentoo&p=2&type=0
Where q is the keyword, p is the result page (the first page is 0) and type is the search type (0=text, 1=image, 2=video, 3=torrent)

JSON result:

  • In case of text search:
  • In case of image search:
    • base64: The result image converted to base64 format
    • alt: The description of the image
  • In case of video search:
  • In case of torrent search:
    • hash: Hash of the torrent
    • name: Name of the torrent
    • seeders: The amount of seeders
    • leechers: The amount of leechers
    • size: The size of the files in human readable format
    • source: Where the torrent was fetched from
    • magnet: The magnet link

The API also supports both GET and POST requests

Donate

Monero (XMR): 41dGQr9EwZBfYBY3fibTtJZYfssfRuzJZDSVDeneoVcgckehK3BiLxAV4FvEVJiVqdiW996zvMxhFB8G8ot9nBFqQ84VkuC