Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/murat/tors
⏬ Yet another torrent searching application for your command line
https://github.com/murat/tors
crawler ruby-gem torrent-downloader torrent-search-engine
Last synced: 9 days ago
JSON representation
⏬ Yet another torrent searching application for your command line
- Host: GitHub
- URL: https://github.com/murat/tors
- Owner: murat
- License: mit
- Created: 2017-08-30T19:30:15.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2017-09-18T07:26:58.000Z (about 7 years ago)
- Last Synced: 2024-10-12T10:46:11.795Z (25 days ago)
- Topics: crawler, ruby-gem, torrent-downloader, torrent-search-engine
- Language: Ruby
- Homepage: http://muratbt.com/tors
- Size: 99.6 KB
- Stars: 46
- Watchers: 3
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# TorS
[](https://github.com/muratbsts/tors/blob/master/LICENCE)
[](https://github.com/muratbsts/tors/releases)
[](https://travis-ci.org/muratbsts/tors)
[](https://github.com/muratbsts/tors/issues)
[](https://github.com/muratbsts/tors/pulls)
[](https://rubygems.org/gems/tors)
Yet another torrent searching application for your command line.
But this has an option for automatically download the best torrent.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'tors'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install tors
## Usage
Open your terminal and run this command:
$ tors 'ubuntu'
It will list torrents ordered descending by seeder from **katcr**.
**Wait! Why katcr?**
Because katcr fastest provider for scrabing currently.
**Is there another provider and how can I change it?**
Yep, there is a few provider option.
| Provider | Status | Problems |
|:------------------|:------:|:----------------------------------|
| katcr | ✅ | - |
| rarbg | ✅ | Slow Connection, Threat defensing |
| thepiratebay | ✅ | Only Magnet |
| extratorrent | ✅ | Slow Connection |
| 1337x | ✅ | Connection N+1 |
| zooqle | ✅ | Skipping some torrents |
| zamunda | ✅ | Require authentication |
| torrentfunk | ☑️ | 🙈 |
| limetorrents | ☑️ | 🙈 |
Use `-p PROVIDER` flag for scrape another providers.
$ tors 'ubuntu' -p thepiratebay
And then It will ask for **which torrent you want to download?** You can answer with a torrent number seen on list.
You can use `-a` or `--auto-download` flag for automatically download the best torrent. Example:
$ tors 'ubuntu' -p 1337x -a
You can use `-d TARGET` flag for set destination storage path. Example:
$ tors 'ubuntu' -d $HOME/Downloads -a
And you can list all active providers and usage instructions with `-h` or `--help` flag.
$ tors -h
usage: tors [options] SEARCH_STRING
-d, --directory Destination path for downloaded torrent
-p, --provider Provider name
-u, --username Username for authentication
-w, --password Password for authentication
-l, --list-providers List available providers
-a, --auto-download Auto download best choice
-o, --open Open torrent after downloading
-h, --help Print help
-v, --version Print version
[](https://asciinema.org/a/lxRQTTiTSUXVhD3dpzIwCcIs2)
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at [https://github.com/muratbsts/tors](https://github.com/muratbsts/tors). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
## Contributors
- [Murat Bastas](https://github.com/muratbsts)
- [Eren Türkay](https://github.com/eren)
- [Muhammet Dilmaç](https://github.com/muhammetdilmac)
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
## Code of Conduct
Everyone interacting in the TorS project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/muratbsts/tors/blob/master/CODE_OF_CONDUCT.md).