Kickasstorrents search lib with python3.5
Project description
:tv: Python3 + KickAssTorrents | CLI | Telegram
Python3.5 library to search in kickasstorrents (kat.cr)
It’s also a telegram bot and a command line interface :wink:
:notebook: Library Usage
KATcr uses python3.5’s new async def (pep-492) syntax.
For search, it just has a simple coroutine, search_magnets, that accepts a search term, the page number to return, and a type ( type is either “torrent” or “magnet”)
Sample code for getting the first page of results:
from katcr import search_magnets loop = asyncio.get_event_loop() result = loop.run_until_complete( search_magnets("ubuntu", 1, loop, "torrent")) for url, name in result: print("{}: {}".format(name, url))
This library also comes with a command line interface and a telegram bot!
:tv: 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 (kat.cr) 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
:space_invader: 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 kat.cr Usage: katcr --token <BOT_TOKEN> Options: --token=<BOT_TOKEN> Telegram bot token Examples: katcr --token 123123:123123
:white_check_mark: 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.
:star: 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 :smile:
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
:
:star2: 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 opensource@davidfrancos.net. If you’ve got a bug to report, please use the github ticketing system
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.