torrents.csv/README.md

41 lines
1.6 KiB
Markdown
Raw Normal View History

2018-10-04 23:33:33 +00:00
# Torrents.csv
2018-10-03 17:12:12 +00:00
2018-10-04 23:33:33 +00:00
`Torrents.csv` is a vetted database of torrents, consisting of a single, searchable `torrents.csv` file.
2018-10-03 17:12:12 +00:00
## Searching
To find torrents run `./search.sh "frasier s01"`
```
Frasier S01-S11 (1993-)
seeders: 33
size: 13.43 GB
link: magnet:?xt=urn:btih:3cc5142d0d139bcc9ea9925239a142770b98cf74
```
2018-10-04 20:23:57 +00:00
2018-10-05 06:48:51 +00:00
To add your own torrents, run `./add_torrents.sh MY_TORRENTS_DIR`
## Uploading
An *upload*, consists of making a pull request after running the `add_torrents.sh` script, which adds torrents from a directory to the `.csv` file, after checking that they aren't already there, and that they have seeders.
2018-10-05 06:48:51 +00:00
[Click here](https://gitlab.com/dessalines/torrents.csv/forks/new) to fork this repo.
```sh
2018-10-04 23:33:33 +00:00
git clone https://gitlab.com/[MY_USER]/torrents.csv
cd torrents.csv
./add_torrents.sh MY_TORRENTS_DIR # `MY_TORRENTS_DIR` is `~/.local/share/data/qBittorrent/BT_backup/` for qBittorrent on linux, but you can search for where your torrents are stored for your client.
git commit -am "Adding my torrents"
git push
```
2018-10-04 20:23:57 +00:00
2018-10-04 23:33:33 +00:00
Then [click here](https://gitlab.com/dessalines/torrents.csv/merge_requests/new) to do a pull/merge request to my branch.
2018-10-04 20:23:57 +00:00
## How the file looks
```sh
infohash;name;size_bytes;created_unix;seeders;leechers;completed;scraped_date
# torrents here...
```
2018-10-03 17:12:12 +00:00
## Other info
`Torrents.csv` will only store torrents with at least one seeder to keep the file small, and will be periodically purged of non-seeded torrents, and sorted by seeders descending.
2018-10-03 17:12:12 +00:00
Its initially populated with a January 2017 backup of the pirate bay, but eventually scripts will be written that pull in new torrents daily.