Torrent Cloud – A self-hosted Bittorrent client in the Cloud
The first release of version 2 is ready!
⚠️ This version is deprecated. If you'd like to be the maintainer or contributer of this version, please leave a comment here.
A torrent client in the cloud, written in Node.js
There are a various existing cloud torrent services (bitport.io, btcloud.io, put.io), though they're all subscription-based or have limits imposed. Torrent Cloud is intended to be self-hosted on your own cloud compute combined with your own cloud storage. When a file is downloaded, Torrent Cloud simultaneously downloads and uploads the file, so when a torrent is complete, you'll find it in your own storage.
Disclaimer This project was created to bring about an addition download channel to defeat unfair BitTorrent protocol restrictions imposed by enterprises and ISPs. It was intended for downloading legal, non-copywrite material, such as: public linux distributions, personal files, large public statistical datasets, public domain images and videos from archive.org, etc. This project will not take any responsibility for any illegal use, by using this software you agree to these terms.
Collect the environment variables
Setup your cloud storage (Choose one)
AWS
[Your Name] > Security Credentials
)AWS_ACCESS_KEY
Required)AWS_SECRET_KEY
Required)AWS_BUCKET
Required)AWS_REGION
Required see region codes)Mega Warning: the Mega backend is quite buggy
MEGA_EMAIL
Required)MEGA_PASS
Required)Note: See the contribute section for adding more storage backends
Consider these optional variables
HOST
Listening interface (Optional defaults to all 0.0.0.0
)PORT
Listening port (Optional default 3000
)AUTH_USER
HTTP Basic Auth (Optional default admin
)AUTH_PASSWORD
HTTP Basic Auth (Optional if set HTTP auth will be enabled)SEARCH_PROVIDERS_URL
URL to a JSON configuration file (Optional see below)Choose a cloud hosting environment
Heroku
Sign up for a free Heroku account
Click this Deploy button and fill in the variables you've considered above
Others
$ npm i -g torrent-cloud
env PORT=8080 torrent-cloud
And that's it! (On Heroku, visit https://<appname>.herokuapp.com
)
You can change these via the Heroku command-line tool or in the Heroku dashboard Apps > App > Config Variables > Reveal > Edit
.
Torrent Cloud provides an easy way to screen-scrape any of the copyright-free (legal) torrent sites. The search provider specification can be found here: https://gist.github.com/jpillora/e667f3d16a6bd403edc4. Please add your custom providers in the comment section.
Backend A Node.js app using Express, WebSockets, and many other modules. The server entry point is server.js
and the modules are inside lib/
, they're documented in the comments though questions are welcome via Issues. Currently there are only Mega and AWS storage backends, though contributions are wanted. To get started, take a look at lib/backends/_template.js
for the required interface.
Frontend An Angular app with related all files in static/
. The HTTP API is for initiating all actions (e.g. start/stop torrent), and will return an error or an empty OK. The entire app state is sent, on change, via WebSockets.
heroku logs --tail --<appname>
(heroku
tool required). You're most likely missing one of storage environment variables above.Ask questions on the Issues page.
Built around @mafintosh's awesome torrent-stream.
Copyright © 2015 Jaime Pillora <[email protected]>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.