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)
[Your Name] > Security Credentials)
AWS_REGIONRequired see region codes)
Mega Warning: the Mega backend is quite buggy
Note: See the contribute section for adding more storage backends
Consider these optional variables
HOSTListening interface (Optional defaults to all
PORTListening port (Optional default
AUTH_USERHTTP Basic Auth (Optional default
AUTH_PASSWORDHTTP Basic Auth (Optional if set HTTP auth will be enabled)
SEARCH_PROVIDERS_URLURL to a JSON configuration file (Optional see below)
Choose a cloud hosting environment
Sign up for a free Heroku account
Click this Deploy button and fill in the variables you've considered above
$ npm i -g torrent-cloud
env PORT=8080 torrent-cloud
And that's it! (On Heroku, visit
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>(
herokutool required). You're most likely missing one of storage environment variables above.
Ask questions on the Issues page.
Copyright © 2015 Jaime Pillora <firstname.lastname@example.org>
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.