README.md

Katastrophe

**A Command-Line Interface for scraping Kickass torrents (kickasstorrents.to). Provides options to scrape top torrents in given categories, or searching for specific torrents. The user can select single, multiple or even specify a range for the torrent to download from any category. It has an inbuilt bittorent client, if none exist on the system then the Command line bittorent client is used for downloading. **

Installation

Using pip

$ pip install katastrophe

Get the latest build from the Source

• Clone the repo git clone https://github.com/alyakhtar/katastrophe
• Run python setup.py install

Dependencies

• BeautifulSoup4
• tabulate
• docopt
• requests
• lxml
• bencode
• bitstring

Requires

• for Linux/Mac OS X
  • Deluge/Transmission/QBitTorrent/Vuze
• for Windows
  • BitTorrent/μTorrent/Deluge

Usage:

  katastrophe.py 
  katastrophe [--verifyssl=<boolean>][-m | -t | -a | -s | -l | -g | -p | -b | -x | -M | -T | -A | -S | -B | -G | -P | -X]
  katastrophe -h | --help
  katastrophe --version

  Multi Download:
    i,j     From Serial No. i to Serial No. j
    ,i      From Serial No. 1 to Serial No. i 
    i,      From Serial No. i to serial no 25
    i,j,... Multiple Serial Numbers

Options:

Arguments	Description
-h, --help	Show this screen
--verifyssl	Change SSL setting in request package [default: True]
--version	Show version
-m, --newmovies	Show latest Movie Torrents
-t, --newtv	Show latest TV Torrents
-a, --newanime	Show latest Anime Torrents
-s, --newsongs	Show latest Music Torrents
-l, --newlosslessmusic	Show latest Lossless Music Torrents
-g, --newgames	Show latest Game Torrents
-p, --newapplications	Shoe latest Application Torrents
-b, --newbooks	Show latest Book Torrents
-x, --xxx	Show latest XXX Torrents
-M, --movies	Search by Movie Category
-T, --tv	Search by TV Category
-A, --anime	Search by Anime Category
-S, --songs	Search by Music Category
-B, --books	Search by Book Category
-G, --games	Search by Games Category
-P, --applications	Search by Applications Category
-X, --XXX	Search by XXX Category

Demo

Screenshots

Latest Movies

$ katastrophe -m

Latest TV Shows

$ katastrophe -t

Latest Games and Applications

$ katastrophe -g

Latest Music

$ katastrophe -s

Latest Anime

$ katastrophe -a

Latest Books

$ katastrophe -b

Latest Lossless Music

$ katastrophe -l

Multiple Downloads

$ Starting and Ending Torrent

$ Starting Torrent

$ Ending Torrent

SSL Verification

$ katastrophe --verifyssl=True/False

Contribute

Found a bug or want to suggest a new feature? Report it by opening an issue. Feel free to send a pull request for any improvements or feature requests ;)

Thanks

A big thanks to Lita for her bittorrent client.

License

MIT © Aly Akhtar