LibreX
A privacy respecting free as in freedom meta search engine
# Online instances
+ [search.davidovski.xyz](https://search.davidovski.xyz/) 🇬🇧
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:
+ If the query is a special query (e.g.: currency conversion, wikipedia result etc.):
+ `special_response`:
+ `response`
+ `source`
+ `title`
+ `url`
+ `base_url`: (e.g.: http://example.com/test.php -> http://example.com/)
+ In case of image search:
+ `base64`: the result image converted to base64 format
+ `alt`: the description of the image
+ In case of video search:
+ `title`
+ `url`
+ `base_url`: (e.g.: http://youtube.com/watch -> http://youtube.com/)
+ In case of torrent search:
+ `hash`
+ `name`
+ `seeders`
+ `leechers`
+ `size`
+ `source`
+ `magnet`
The API also supports both GET and POST requests
# Donate
Monero (XMR): `41dGQr9EwZBfYBY3fibTtJZYfssfRuzJZDSVDeneoVcgckehK3BiLxAV4FvEVJiVqdiW996zvMxhFB8G8ot9nBFqQ84VkuC`