Skip to content

Latest commit

 

History

History
77 lines (57 loc) · 3.04 KB

README.md

File metadata and controls

77 lines (57 loc) · 3.04 KB
Raw

TV Torrent Taker (T3)

T3 is a python script to download torrents of your favorite TV shows from the site eztv.ch. The list of the TV Shows that are supported are

  1. The Big Bang Theory
  2. Modern Family

WARNING : Downloading TV Shows without their respective owners' permission is deemed illegal in many countries. Use at your own risk.

Requirements

  1. Packages deluge, deluge-web, deluge-console
  2. Python
  3. If using Python 2.7 then modules - urllib2 , lxml, argparse, sleekxmpp, smtplib
  4. If using Python 3 then modules - urllib.request, urllib.error, urllib.parse, lxml, argparse, sleekxmpp, smtplib

Installation

Just clone the repository
git clone https://gitlab.com/balasankarc/t3.git
cd t3

Usage

The basic usage of the script is as follows
./t3.py [options]

Input file

The script uses a JSON file named nextone to find out which is the next episode to be downloaded. It can be extended to include other tv shows from eztv.ch also. Edit the file to suit your needs.

{
    "bigbangtheory": {
        "url": "https://eztv.ag/shows/23/the-big-bang-theory/",
        "nextseason": "09",
        "nextepisode": "11"
    },
    "modernfamily": {
        "url": "https://eztv.ch/shows/330/modern-family/",
        "nextseason": "11",
        "nextepisode": "10"
    }
}

Options

The various options supported by T3 are

Syntax Meaning Example
-h View the help ./t3.py -h
--email <EMAIL> Send email notifications ./t3.py --email [email protected]
--xmpp <JID> Send XMPP notifications ./t3.py --xmpp [email protected]

Note : For the notifications to work, the files .xsend and .xemail should be present inside the $HOME directory. The content of these files are

.xsend
JID=<your jabber id - used as the sender>
PASSWORD=<password>

.xemail (supports only GMail now)
USERNAME=<your email id - used as the sender>
PASSWORD=<password>

WARNING : NOTIFICATIONS REQUIRE STORING PASSWORDS IN PLAIN TEXT AND HENCE SHOULD BE USED IN OWN RESPONSIBILITY.

FAQ

1. Does this support only eztv.ch?
Well, at first I followed a method of using Torrentz to find and download the first search hit. But then I was told about the website EZTV which listed all the shows I needed then. If I need shows not listed in eztv.ch in future, I'll modify the script to get them.

2. Can you add my favorite show too?
Why not?? Just file an issue. I'll see if I can get a consistent location to pull the latest torrents. To be frank, you may yourself add them and file a pull request. I beleive the code is actually simple enough to understand. I will add comments when I get time.

Contributing

This script, as usual, was created just to solve developer's personal itch. So, it contains the quickest (which surely will be ugly) method of solving the problem. Anyone is welcome to modify the script and file pull requests and I am more than happy to merge them.

License

The software is licensed under GPLv3 and hence is free software.