Metadata-Version: 1.1
Name: katcr
Version: 1.0.3.dev7
Summary: Kickasstorrents search lib with python3.5
Home-page: https://github.com/XayOn/katcr
Author: David Francos Cuartero
Author-email: opensource@davidfrancos.net
License: Apache-2
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://asciinema.org/a/139240.png
            :target: https://asciinema.org/a/139240
        
        ::
        
            Search in multiple torrent sites.
        
                Usage: katcr [options] [interactive options] <SEARCH_TERM>
        
                Currently available search engines:
        
                - Katcr
                - ThePirateBay
        
                Options:
                    -e --search-engine=<SearchEngine>  Torrent search engine to use
                                                       [default: Any].
                    -p --pages=<PAGES_NUM>             Number of pages to lookup
                                                       [default: 1]
                    -d --disable-shortener             Disable url shortener
                    -s --sortener=<SHORTENER_URL>      Use given magnet shortener to
                                                       prettify urls.
                                                       [default: http://www.shortmag.net]
        
                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
                    -d --debug                         Enable debug mode
        
        
        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
