Metadata-Version: 1.1
Name: katcr
Version: 1.0.7.dev1
Summary: Kickasstorrents search lib with python3.5
Home-page: https://github.com/XayOn/katcr
Author: David Francos Cuartero
Author-email: opensource@davidfrancos.net
License: GPL3+
Description-Content-Type: UNKNOWN
Description: .. image:: http://i.imgur.com/ofx75lO.png
        
        Easily **search torrents** in multiple providers such as KickAssTorrents and
        ThePirateBay.
        
        
        .. image:: https://travis-ci.org/XayOn/katcr.svg?branch=master
            :target: https://travis-ci.org/XayOn/katcr
        
        .. image:: https://coveralls.io/repos/github/XayOn/katcr/badge.svg?branch=master
            :target: https://coveralls.io/github/XayOn/katcr?branch=master
        
        .. image:: https://badge.fury.io/py/katcr.svg
            :target: https://badge.fury.io/py/katcr
        
        
        Command Line Interface
        ----------------------
        
        katcr comes with a simple but powerful command line interface
        
        .. image:: 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 <https://www.dabapps.com/blog/introduction-to-pip-and-virtualenv-python/>`_
        
        
        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.
        
        .. image:: 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 <https://thenounproject.com/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
        
        
Keywords: kickasstorrents
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3 :: Only
