Skip to main content

Kickasstorrents search lib with python3.5

Project description

http://i.imgur.com/ofx75lO.png

Easily search torrents in multiple providers such as KickAssTorrents and ThePirateBay.

https://travis-ci.org/XayOn/katcr.svg?branch=master https://coveralls.io/repos/github/XayOn/katcr/badge.svg?branch=master https://badge.fury.io/py/katcr.svg

Command Line Interface

katcr comes with a simple but powerful command line interface

https://raw.githubusercontent.com/XayOn/katcr/master/screenshot.gif
Search in multiple torrent sites.

    Usage: katcr [options] [interactive options] <SEARCH_TERM>

    Currently available search engines:

    - Katcr
    - ThePirateBay
    - Nyaa
    - Skytorrents
    - Digbt

    Options:
        -e --search-engines=<SearchEngine>  Torrent search engine to use
                                            [default: All].
        -p --pages=<PAGES_NUM>              Number of pages to lookup
                                            [default: 1]
        -d --disable-shortener              Disable url shortener
        -s --shortener=<SHORTENER_URL>      Use given magnet shortener to
                                            prettify urls.
                                            [default: http://www.shortmag.net]
        -t --token=<SHORTENER_TOKEN>        Shortener token to use, if required
        -t --token_file=<S_TOKEN_FILE>      Shortener token file

    Interactive Options:
        -i --interactive                    Enable interactive mode
        -o --open                           Launch with default torrent app
                                            in interactive mode [default: True]
        -h --help                           Show this help screen
        -v --verbose                        Enable debug mode


    katcr  Copyright (C) 2017 David Francos Cuartero
    This program comes with ABSOLUTELY NO WARRANTY; This is free software, and
    you are welcome to redistribute it under certain conditions;

Installation

If you don’t already know about virtualenvs, you should read Jamie Matthews’s article about virtualenvs

This is a python package available on pypi. Just execute:

pip install katcr

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.

http://i.imgur.com/7FxplBs.gif
Run telegram bot.

    Usage: katcr_bot [options]

    Options:
        --token=<BOT_TOKEN>             Telegram bot token
        --shortener=<URL_SHORTENER>     Url shortener to use
                                    [default: http://shortmag.net]

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

katcr-1.0.7.dev1.tar.gz (1.2 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page