sarrablo / katcr

:tv: Python3.5 library to search in kickasstorrents

📺 Python3 + KickAssTorrents | CLI | Telegram

Python3.5 library to search in kickasstorrents

It's also a telegram bot and a command line interface 😉

local

📓 Library Usage

Sample code for getting the first page of results:

from katcr import search
print(search("ubuntu"))

This library also comes with a command line interface and a telegram bot!

📺 katcr - kickasstorrents command line interface

katcr comes with a simple but powerful command line interface, able to return either magnets or torrents.

Usage

Easy-as-it-gets python3.5 library to search magnets
in kickasstorrents

Usage:
    katcr --search=<SEARCH_TERM> --pages=<PAGES_NUM> --type=<TYPE> [--interactive]

Options:
    --search=<SEARCH_TERM>   Search term(s)
    --pages=<PAGES_NUM>      Number of pages to lookup
    --type=<magnet|torrent>  Type
    -i --interactive         Activate interactive menu to torrent selection
    -s --stream              Play the torrent in streaming mode (EXPERIMENTAL)
    -h --help                Show this screen

Examples:
    katcr --search "Search terms" --pages 3
    katcr --search "Search terms" --pages 1 --interactive
    katcr --search "Search terms" --pages 1 --type=magnet
    katcr --search "Search terms" --pages 1 --type=torrent
    katcr --pages 1

👾 KATBot - Kickasstorrents telegram bot

Katcr also comes with a telegram bot entry point.

It's a simple bot that replies with search results for each message it gets. It returns links to .torrent files from KAT.cr for the first page of results.

Usage

Telegram bot to query kickasstorrents

Usage:
    katcr_bot [options]

Options:
    --token=<BOT_TOKEN> Telegram bot token

Examples:
    katcr_bot --token 123123:123123

✅ Experimental torrent streaming

This is an experimental feature!!

Using another library of mine, torrentstream I added experimental streaming support. That requires libtorrent.

Deluge guys have a good tutorial on how to get libtorrent going on multiple systems`

Support on windows / MacOs is probably not working on this feature. Please, if you've tested it on windows / MacOs contact me so we can work on that support.

⭐ Installation

This is a python3.5 package available on pypi.

On windows and mac you can download python3.5 here. On linux distros, python3.5 is already on most package managers 😄

With python3.5 installed just execute:

pip3.5 install katcr

If it asks about permissions and you don't know what to do, you should probably read Jamie Matthews's article about virtualenvs

:

🌟 Notes

This project is made with the best of intentions. For that times you need to search for somethink shared as a torrent on KAT (I.E, linux images). Logo is based on robot cat by Arsenty

If you like this project, show its appreciation by starring it, if you're using it and want to write to me personally, feel free to do so at [email protected]. If you've got a bug to report, please use the github ticketing system