glavin001 / torrentautomator

Automate the task of searching for Torrents and sending them to your Torrent Client to download.

TorrentAutomator

Automate the task of searching for Torrents ( Kickass, YIFY, EZTV ) and sending them to Transmission or uTorrent to download.

Installation

1. Download the Project

Clone it with Git, and update with git pull.

2. Install Node.js and Dependencies

See Node.js's website.

After installing Node.js, install Bower and CoffeeScript.

npm install -g bower
npm install -g coffee-script

Now that you have Node.js and Bower, you can install the dependencies. Change into this downloaded project directory and run:

npm install
bower install

3. Configure Your Server

Create config.json in the project's directory.

Here is a sample config.json:

{
    "server": {
      "port": 8000
    },
    "transmission": {
        "host": "localhost",
        "port": 9091,
        "username": "USERNAME",
        "password": "PASSWORD"
    },
    "twilio": {
      "phone": "15555555555",
      "accountSid": "TWILIO_ACCOUNT_SID",
      "authToken": "TWILIO_AUTH_TOKEN"
    },
    "downloadDirs": {
      "Movies": "/Media/Movies",
      "TV Shows": {
        "template": "/Media/TV Shows/{{show_name}}/Season {{season}}",
        "default": null
      }
    }
}

Setup your Transmission server and change the above Transmission configuration.

Sign up for Twilio and change the above Twilio configuration. Configure your Twilio's phone number to send text messages to your TorrentAutomator server.

Usage

After you're completely done the setup above you can start the TorrentAutomator server.

coffee server/

Or

./server/index.coffee

The you can either:

Connect to the Web app

In your web-browser go to http://localhost:8000/. Modify your address for the correct server IP address and port number as configured above.

Text the Server with Twilio

Text your Twilio phone number with commands such as the following:

Search for <torrent search keyword>

Download <selection number from previous "Search for" request>

Show downloads

Disclaimer

There are obvious legal issues, with downloading copyrighted material you do not have a license for. We do not endorse such use cases and take no responsibility for the use people make of it.

torrentautomator's Issues

YIFY Provider

See https://github.com/yify-pop/yify-pop/blob/master/app/helpers/yify.js and https://github.com/vijaysai/yify and http://www.yify-torrent.org/

Pirate Bay support

See https://github.com/t3chnoboy/thepiratebay

/cc @Frozenfire92

Add `help` command

• Each Command has optional help field that can contain help / usage details.
  • Default is to show the name of the command without example
• Recommend help command when command not found, https://github.com/Glavin001/TorrentAutomator/blob/master/server/bot/conversation.coffee#L21

Support for comma separated "Download ##" command

Support for comma separated "Download ##" command.

Example: Download 1, 2, 3. instead of Download 1., send, Download 2., send, Download 3., send.

Add uTorrent support

See https://www.npmjs.org/package/utorrent-api

• "Show downloads" / Listing current downloads
  • Download %
  • Download ETA
  • If download completed
• Add Torrent
  • Change download directory

Send Torrent URL to Transmission-Daemon

See https://github.com/FLYBYME/node-transmission

Switch to CoffeeScript

CoffeeScript supports a really nice and easy implementation of Classes in JavaScript and will make things a lot cleaner when we start to implement things more object-oriented.

Changelog

I know, I hate constantly updating Changelogs. However, they have purpose and I agree with their goal: keeping track of new features and breaking changes. It's a "necessary evil". As much as I'd wish everyone would read through my many commit messages, it's not going to happen, even by me! So, it's time to start a Changelog!

Text me when something is finished downloading

Mount network drive and install Transmission

IRC client support

See https://www.npmjs.org/package/irc

As an alternative to Twilio (SMS integration) the server connects to an IRC room that can receive commands similar to Twilio's SMS support.

Support long running async replies to SMS (Twilio)

Twilio will wait a maximum of 15 seconds before cancelling a request / waiting for reply.

Download every episode in season of a TV show

See https://github.com/SeekTheError/tbb-transmission/blob/master/lib/episodeIdIterator.js

Command example:

Download season 1 of Suits

Command regex:

^[dD]ownload [sS]eason ([0-9]*) of (.*)$

Download with link or torrent hash

• Download with link

[dD]ownload /^(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\/?$/

• Download with Torrent hash (/cc @dreid93 )

Setup and Configure with Web Admin interface

Instead of manually configuring the config.json file, there should be an endpoint with a basic web admin interface for interactively customizing the configuration options for the server, such as Twilio, Transmission, etc.

Optimize Dockerfile

• Speeding up npm install in docker: npm/npm#8836
• Building Efficient Dockerfiles - Node.js: http://bitjudo.com/blog/2014/03/13/building-efficient-dockerfiles-node-dot-js/
• Dockerfile best practices: https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/
• Resin.io Build Optimization: http://docs.resin.io/#/pages/deployment/build-optimisation.md
• Gotchas in Writing Dockerfile: http://kimh.github.io/blog/en/docker/gotchas-in-writing-dockerfile-en/
• Docker Explained: Using Dockerfiles to Automate Building of Images: https://www.digitalocean.com/community/tutorials/docker-explained-using-dockerfiles-to-automate-building-of-images

Implement Base Classes to be reused

Base Classes:

• TorrentProvider, such as Kickass, PirateBay, IsoHunt
  • search method that returns Torrents
• Command
• TorrentClient, such as Transmission or uTorrent
• Torrent, class that represents each Torrent file
  • title
  • torrentUrl
  • link
  • date created
  • seeders
  • leechers
  • size (number in bytes)
  • verified
  • hash

Reimplement, current existing:

• Commands
  • Search for Torrents
  • Download Torrent
  • Show Downloads
• Torrent Providers
  • Kickass
• Torrent Clients
  • Transmission

/cc @dreid93 @Frozenfire92

Complex organizing of TV Shows

Variables:

• Season and episode number, https://www.npmjs.org/package/episode
• Show name
• Download date

Use Lo-Dash template: http://lodash.com/docs#template

Example directory:
/Media/TV Shows/<%- show_name %>/<%- episode_name %>/

Movie Recommendations

See http://docs.prediction.io/current/tutorials/movie-recommendation.html

Rewrite with latest Feathers, ES6, more modular

• https://gist.github.com/danielgtaylor/0b60c2ed1f069f118562
• http://feathersjs.com/

---

Services:

• SMS
  • Receive Twilio SMS message
• Conversation
  • Create handler
  • Find handler
  • Update handler
  • NeDB
• Torrent
  • Find Torrent
    • http://node-machine.org/machinepack-findtorrent
• BitTorrent Client
  • Transmission
  • uTorrent: https://github.com/Glavin001/machinepack-utorrent

Save different category downloads in different directories

Read the category field for a Torrent, and map that to different directories, with the default being empty (which will fallback to using Transmission's default).

Unit Tests and Travis CI

• Setup Travis CI
• Unit Tests
  • Bot Commands being selected correctly

IsoHunt provider support

See https://www.npmjs.org/package/node-isohunt

Add "Next" or "More" command to show more search results

Search for Torrents from web-interface

See https://www.npmjs.org/package/node-kickass-json

[Solved]Add torrent problem

Hi,
I got a little problem after fresh start to add torrent by webui, error is :
create {} { query: {} }
Error: Missing Torrent URL field.

EDIT : After I post and check your code I found the problem on app/scripts/main.js
line 15 : url: torrent.torrentLink instead of : url: torrent.torrentUrl
Well thanks for this api useable with twilio, I think I will get a closer look :D

EZTV provider

See https://www.npmjs.org/package/eztv or https://www.npmjs.org/package/eztv-query

Add documentation

• Links to Transmission Daemon
• Twilio
• How to create your config.json
• Usage, commands, etc
• Screenshots

Leading spaces causes command not found

For example, <WHITESPACE> Download 1. versus Download 1. will fail.

CLI app & reusable library

• CLI app
  • Configuration options and/or configuration file
  • Documentation
  • Publish to npm
• Node.js library for executing some of the same functionality in other apps
• Updater, https://github.com/yeoman/update-notifier

Slack integration

https://github.com/howdyai/botkit

Interesting / Catchy Name

@Glavin001 please feel free to dismiss this issue. I was hoping we could brainstorm a more interesting name.

Potentials :

• AuTorBot (pronounced Aw-Tor-Bot like Autobot)
• TxTor (pronounced Text-Tor)

Use pretty-bytes to convert bytes in number to human-readable string

See https://github.com/sindresorhus/pretty-bytes

Twilio integration

See https://www.twilio.com/

Text the query to the server and receive results. Select a result and download it. All over text messages!

Add additional trackers per torrent

Torrents can be uniquely identified by a hash. It would be good to be able to search multiple site for torrents by hash. Adding a torrent already added to your torrent client generally causes the torrent client to consolidate the list of trackers. This makes the torrent faster.

This could be done by creating a TorrentProvider class with a getByHash function used to attain torrents by their hash. This may then return a Torrent object that could be added to the TorrentClient.