Metadata-Version: 1.0
Name: whitey
Version: 0.3
Summary: Command-line YouTube client
Home-page: UNKNOWN
Author: Rich Wareham
Author-email: rjw57@cantab.net
License: Apache-2.0
Description: ``yt``: a command-line YouTube client
        =====================================
        
        ``yt`` is a command-line front-end to YouTube which allows you to browse YouTube
        videos and play them directly from the command-line. It uses ``youtube-dl`` and
        ``mplayer`` or ``omxplayer`` to actually *play* the videos.
        
        The combination of a text based interface and ``omxplayer`` makes ``yt`` a great
        YouTube client for the Raspberry Pi.
        
        Usage
        -----
        
        Launch using ``mplayer`` with::
        
            yt
        
        or, if you're using a Raspberry Pi, using ``omxplayer``::
        
            pi-yt
        
        Installation
        ------------
        
        From PyPi (easier!)
        ~~~~~~~~~~~~~~~~~~~
        
        ::
        
            # Install dependancies
            sudo apt-get install youtube-dl
            # Ensure using latest version of youtube-dl to keep up with YouTube API changes
            sudo youtube-dl -U
        
            # Install from PyPi
            sudo apt-get install python-setuptools
            sudo easy_install whitey
        
        From GitHub
        ~~~~~~~~~~~
        
        ::
        
            # Install dependancies
            sudo apt-get install youtube-dl
            # Ensure using latest version of youtube-dl to keep up with YouTube API changes
            sudo youtube-dl -U
        
            # Install from GitHub
            sudo apt-get install python-setuptools
            git checkout git@github.com:rjw57/yt.git
            cd yt
            sudo python setup.py install
        
        One line install for the Raspberry Pi
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            curl -L https://github.com/rjw57/yt/raw/master/tools/install-pi.sh | sh
                                
        Dependancies
        ------------
        
        - youtube-dl
        - mplayer or omxplayer
                                
        Common problems
        ---------------
        
        Videos don't play when selected in interface
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Make sure you have the latest version of youtube-dl. youtube-dl has a self update
        mechanism::
        
            sudo youtube-dl -U
        
        Omxplayer starts and terminates without playing video
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        For high quality videos the default memory allocation on the Raspberry Pi doesn't
        provide enough memory to the GPU.
        
        The default 192M ARM, 64M GPU split can be changed to a 128M ARM, 128M GPU split
        using raspi-config.
        
        ::
        
            sudo raspi-config
            # Select memory-split
            # Allocate 128M to the GPU
                
        See http://elinux.org/RPi_Advanced_Setup for more information.
        
        Getting more help
        ~~~~~~~~~~~~~~~~~
        
        See https://github.com/rg3/youtube-dl and https://github.com/huceke/omxplayer for
        more detailed help.
        
        Contributors
        ------------
        
        - Rich Wareham
            - Created ``yt``.
        
        - Calum J. Eadie
            - Added OMXPlayer support and pi-yt entry point.
        
        Credits
        -------
        
        - `Distribute`_
        - `Buildout`_
        - `modern-package-template`_
        - `youtube-dl`_
        - `mplayer`_
        - `Omxplayer`_
        - Mark Baldridges's `"HOWTO: YouTube on the Raspberry Pi - sans X)"`_
        
        .. _Buildout: http://www.buildout.org/
        .. _Distribute: http://pypi.python.org/pypi/distribute
        .. _`modern-package-template`: http://pypi.python.org/pypi/modern-package-template
        .. _`youtube-dl`: http://rg3.github.com/youtube-dl/
        .. _`mplayer`: http://www.mplayerhq.hu/
        .. _`Omxplayer`: https://github.com/huceke/omxplayer
        .. _`"HOWTO: YouTube on the Raspberry Pi - sans X)"`: http://www.raspberrypi.org/phpBB3/viewtopic.php?p=97710&sid=fa3272a732353dc501cb96d38453b97c#p97710
        
        
        .. This is your project NEWS file which will contain the release notes.
        .. Example: http://www.python.org/download/releases/2.6/NEWS.txt
        .. The content of this file, along with README.rst, will appear in your
        .. project's PyPI page.
        
        News
        ====
        
        0.3 - 21/02/2013
        ----------------------
        
        * Added pi-yt entry point (Calum Eadie)
        
        
        0.2 - 29/10/2012
        ----------------
        
        * Added command-line configuration of media player and OMXPlayer support (Calum Eadie)
        
        0.1 - 29/02/2012
        ----------------
        
        * Initial version
        
Platform: UNKNOWN
