skip to navigation
skip to content

mps-youtube 0.01.46

Terminal based YouTube jukebox with playlist management

Package Documentation

Latest Version: 0.2.8


  • Search and play audio/video from YouTube
  • Search tracks of albums by album title
  • Search and import YouTube playlists
  • Create and save local playlists
  • Download audio/video
  • View video comments
  • Works with Python 2.7+ and 3.x
  • Works with Windows, Linux and Mac OS X
  • Requires mplayer or mpv

This project is based on mps, a terminal based program to search, stream and download music. This implementation uses YouTube as a source of content and can play and download video as well as audio. The pafy library handles interfacing with YouTube.


Local Playlists

Search result items can easily be stored in local playlists.

YouTube Playlists

YouTube playlists can be searched and played or saved as local playlists.


Content can be downloaded in various formats and resolutions.


A basic comments browser is available to view YouTube user comments.

Music Album Matching

An album title can be specified and mps-youtube will attempt to find matches for each track of the album, based on title and duration. Type help search for more info.


Search results can be customised to display additional fields and ordered by various criteria.

This configuration was set up using the following commands:

set max-results 50
set console-width 130
set columns user:14 date comments rating likes dislikes category:9
set order views

Type help config for help on configuration options


Using pip:

[sudo] pip install mps-youtube

Mac OS X installation notes

Install mplayer with MacPorts:

sudo port install MPlayer

Windows installation notes

Install the python colorama module to get colors (optional):

pip install colorama

Download mplayer for your CPU type from the “Build Selection table” here.

Extract the mplayer.exe file, saving it to your mpsyt folder


Upgrade pip installation:

[sudo] pip install mps-youtube --upgrade


mps-youtube is run on the command line using the command:


Enter h from within the program for help.

File Type Py Version Uploaded on Size
mps-youtube-0.01.46.tar.gz (md5) Source 2014-05-18 39KB
mps_youtube-0.01.46-py2.py3-none-any.whl (md5) Python Wheel 2.7 2014-05-18 40KB