This repository has been archived on 2023-10-01. You can view files and clone it, but cannot push or open issues or pull requests.
PyNyaaTa/README.md

63 lines
2.8 KiB
Markdown
Raw Normal View History

# π 😼た
2019-12-13 17:24:23 +00:00
> "PyNyaaTa", Xéfir's personal animes torrent search engine
2019-12-13 17:23:06 +00:00
2020-04-09 09:03:39 +00:00
[![Build Status](https://ci.crystalyx.net/api/badges/Xefir/PyNyaaTa/status.svg)](https://ci.crystalyx.net/Xefir/PyNyaaTa)
2020-12-08 15:45:02 +00:00
[![Docker Hub](https://img.shields.io/docker/pulls/xefir/pynyaata)](https://hub.docker.com/r/xefir/pynyaata)
2020-04-09 09:03:39 +00:00
2020-10-21 20:13:57 +00:00
I'm lazy, and I want to search across several VF and VOSTFR torrents databases in one click.
2019-12-13 17:23:06 +00:00
That's the starting point that build this app.
2019-12-19 13:27:40 +00:00
At first, it was a crappy PHP project without any good future.
2019-12-13 17:23:06 +00:00
After a good rewrite in Python, it's time to show it to the public, and here it is!
## Installing / Getting started
### With Docker
- Install Docker: https://hub.docker.com/search/?type=edition&offering=community
- Run `docker run -p 5000 xefir/pynyaata`
2019-12-13 17:23:06 +00:00
- The app is accessible at http://localhost:5000
### Without Docker
- Install Python 3: https://www.python.org/downloads/
- Install Pip: https://pip.pypa.io/en/stable/installing/
2020-04-27 12:02:38 +00:00
- Run `pip install pynyaata`
- Run `pynyaata`
2019-12-13 17:23:06 +00:00
- The app is accessible at http://localhost:5000
## Features
2019-12-13 17:28:13 +00:00
* Search on [Nyaa.si](https://nyaa.si/), [Nyaa.net (codename Pantsu)](https://nyaa.net/), [YggTorrent](https://duckduckgo.com/?q=yggtorrent) and [Anime-Ultime](http://www.anime-ultime.net/index-0-1)
2020-03-21 17:31:08 +00:00
* Provide useful links to [TheTVDB](https://www.thetvdb.com/) and [Nautiljon](https://www.nautiljon.com/) during a search
2019-12-13 17:23:06 +00:00
* Color official and bad links
* Add seeded links to a database
* Color seeded link on search
* Run a batch to list all dead link on database
## Configuration
All is managed by environment variables.
2020-04-20 17:40:11 +00:00
Please look into the `.env.dist` file to list all possible environment variables.
You have to install MariaDB (or any MySQL server) to be able to access the admin panel.
2019-12-13 17:23:06 +00:00
2020-10-21 20:13:57 +00:00
### Bypassing CloudFlare for YggTorrent
YggTorrent use CloudFlare to protect them to DDoS attacks.
This app will make abusive requests to their servers, and CloudFlare will try to detect if PyNyaaTa is a real human or not. *I think you have the answer to the question ...*
2021-01-07 20:19:50 +00:00
Over time, CloudFlare will ask you systematically to prove yourself.
To be able to see YggTorrent results, you have to have a FlareSolverr instance running.
Please refer to their [documentation](https://github.com/FlareSolverr/FlareSolverr#installation).
After that, change the `CLOUDPROXY_ENDPOINT` environment variable to refer to your CloudProxy instance.
2020-10-21 20:13:57 +00:00
If you use PyNyaaTa with Docker and the `docker-compose.yml` from this repository, you don't have to do all this, it comes pre-installed.
2019-12-13 17:23:06 +00:00
## Links
- Project homepage: https://nyaa.crystalyx.net/
2020-04-09 17:36:12 +00:00
- Source repository: https://git.crystalyx.net/Xefir/PyNyaaTa
2019-12-13 17:23:06 +00:00
- Issue tracker: https://git.crystalyx.net/Xefir/PyNyaaTa/issues
- My other projects: https://git.crystalyx.net/Xefir
2020-04-09 17:36:12 +00:00
- Docker hub: https://hub.docker.com/r/xefir/pynyaata
- Donations: https://paypal.me/Xefir
2020-11-01 13:14:37 +00:00