whitey 0.4

Command-line YouTube client

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 [e-mail]: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)”

News

0.4 - 27/00/2013

• Clarify licensing.

• Add Trove classifiers in setup.py.

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