2022-02-17 17:56:04 -03:00
|
|
|
<h1 align="center">LibreX</h1>
|
2022-02-20 19:06:07 -03:00
|
|
|
|
2022-04-21 05:19:35 -04:00
|
|
|
<p float="left">
|
2022-04-21 05:21:21 -04:00
|
|
|
<img src="https://user-images.githubusercontent.com/49120638/164421187-2730b9d5-d5b9-4606-b6b9-145b11cfdb55.png" width=400>
|
|
|
|
<img src="https://user-images.githubusercontent.com/49120638/164421606-3a315cca-d44a-4efe-863d-5771661e66e3.png" width=400>
|
2022-04-21 05:19:35 -04:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<p align="center">
|
2022-04-21 05:21:21 -04:00
|
|
|
<img src="https://user-images.githubusercontent.com/49120638/164422009-89fc8bab-6b36-4555-ada3-397a276bd2ce.png" width=400>
|
2022-02-17 17:56:04 -03:00
|
|
|
</p>
|
|
|
|
|
2022-03-01 13:37:56 -03:00
|
|
|
<p align="center">A privacy respecting free as in freedom meta search engine</p>
|
2022-02-17 17:56:04 -03:00
|
|
|
|
|
|
|
# Online instances
|
2022-04-20 06:58:58 -04:00
|
|
|
+ [librex.paranoid.cf](https://librex.paranoid.cf/) 🇨🇭
|
2022-02-23 08:51:35 -03:00
|
|
|
+ [search.davidovski.xyz](https://search.davidovski.xyz/) 🇬🇧
|
2022-04-20 07:01:43 -04:00
|
|
|
+ [librex.elpengu.com](https://librex.elpengu.com/) 🇫🇷
|
2022-02-17 17:56:04 -03:00
|
|
|
|
2022-03-01 13:37:56 -03:00
|
|
|
If you wish to get your instance added create an issue with the `new instance` label and this information:
|
2022-02-19 10:08:42 -03:00
|
|
|
+ the URL of your instance
|
|
|
|
+ the country where your instance is being hosted
|
|
|
|
|
|
|
|
Your request will be **rejected** if your instance:
|
|
|
|
+ contains JavaScript
|
|
|
|
+ contains ads
|
|
|
|
+ has been heavily modified
|
|
|
|
|
2022-02-17 17:56:04 -03:00
|
|
|
# Features
|
2022-03-10 07:18:07 -03:00
|
|
|
+ Ad & JavaScript free
|
2022-03-03 07:07:14 -03:00
|
|
|
+ Torrent results from popular torrent sites
|
2022-04-21 05:17:50 -04:00
|
|
|
+ Special queries (e.g.: 2.4 btc to usd)
|
2022-02-17 17:56:04 -03:00
|
|
|
+ Tracking snippets from URLs are removed
|
2022-03-30 08:18:31 -03:00
|
|
|
+ Multiple color themes
|
2022-02-17 17:56:04 -03:00
|
|
|
+ Image results are converted to base64 to prevent clients from connecting to Google servers
|
|
|
|
+ Supports both POST and GET requests
|
2022-04-21 05:17:50 -04:00
|
|
|
+ Popular social media sites (YouTube, Instagram, Twitter etc.) are replaced with privacy friendly front-ends
|
2022-03-01 13:37:56 -03:00
|
|
|
+ Easy to use JSON API for developers
|
2022-02-17 17:56:04 -03:00
|
|
|
+ No 3rd party libs are used
|
|
|
|
+ Easy to setup
|
|
|
|
|
|
|
|
# Hosting
|
2022-03-03 07:11:05 -03:00
|
|
|
Hosting LibreX should be easy since no 3rd party PHP libs are used.<br/>
|
2022-04-10 08:14:38 -04:00
|
|
|
All you need is PHP with the curl and dom extension enabled.<br/><br/>
|
2022-03-01 14:10:40 -03:00
|
|
|
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
|
2022-04-27 15:10:39 -04:00
|
|
|
mv config.php.example config.php
|
|
|
|
sed -i 's/http:\/\/localhost/https:\/\/your.domain/g' opensearch.xml
|
|
|
|
cp librex_updater.service /etc/systemd/system/ # edit the service file first
|
|
|
|
systemctl enable --now librex_updater
|
2022-03-01 14:10:40 -03:00
|
|
|
sudo php -S 127.0.0.1:80
|
|
|
|
```
|
|
|
|
<br/>
|
|
|
|
If you want to host an online instance you should consider using a production web server (e.g.: nginx).
|
2022-02-17 17:56:04 -03:00
|
|
|
|
|
|
|
# API
|
2022-03-03 07:07:14 -03:00
|
|
|
Example API request: `.../api.php?q=gentoo&p=2&type=0` <br/><br/>
|
|
|
|
`q` is the keyword<br/>`p` is the result page (the first page is `0`)<br/>`type` is the search type (`0`=text, `1`=image, `2`=video, `3`=torrent)
|
2022-02-17 17:56:04 -03:00
|
|
|
<br/><br/>
|
2022-03-03 07:11:05 -03:00
|
|
|
The API also supports both POST and GET requests.
|
2022-02-17 17:56:04 -03:00
|
|
|
|
2022-02-17 18:02:13 -03:00
|
|
|
# Donate
|
2022-03-30 08:18:31 -03:00
|
|
|
### Monero (XMR)
|
|
|
|
Address: `41dGQr9EwZBfYBY3fibTtJZYfssfRuzJZDSVDeneoVcgckehK3BiLxAV4FvEVJiVqdiW996zvMxhFB8G8ot9nBFqQ84VkuC`
|
|
|
|
|
|
|
|
QR code:
|
|
|
|
|
|
|
|
<p align="left">
|
|
|
|
<img src="https://user-images.githubusercontent.com/49120638/160815173-dea8b0ee-1b1c-4ead-868d-01313ec28350.png">
|
2022-04-10 08:14:38 -04:00
|
|
|
</p>
|