Skip to main content
http://badge.fury.io/py/mps-youtube.png https://pypip.in/d/mps-youtube/badge.png Wheel Status

Features

  • 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.

FAQ / Troubleshooting common issues

Screenshots

Local Playlists

http://np1.github.io/mpsyt-images2/local-playlists.png

Search result items can easily be stored in local playlists.

YouTube Playlists

http://np1.github.io/mpsyt-images2/playlist-search.png

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

Download

http://np1.github.io/mpsyt-images2/download.png

Content can be downloaded in various formats and resolutions.

Comments

http://np1.github.io/mpsyt-images2/comments.png

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

Music Album Matching

http://np1.github.io/mpsyt-images2/album-1.png http://np1.github.io/mpsyt-images2/album-2.png

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.

Customisation

http://np1.github.io/mpsyt-images2/customisation2.png

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

This configuration was set up using the following commands:

set order views
set columns user:14 date comments rating likes dislikes category:9 views

Type help config for help on configuration options

Installation

Using pip:

[sudo] pip install mps-youtube

Mac OS X installation notes

Install mplayer with MacPorts:

sudo port install MPlayer

Or with Homebrew:

brew 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 the folder that mpsyt.exe resides in (usually C:\PythonXX\Scripts\) or to a folder in the system path.

Alternatively to mplayer, use mpv.exe which can be downloaded from: http://mpv.io/installation/

Upgrading

Upgrade pip installation:

[sudo] pip install mps-youtube --upgrade

Usage

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

mpsyt

Enter h from within the program for help.

Release files for mps-youtube 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mps-youtube 0.2.1
File Size Uploaded
mps-youtube-0.2.1.tar.gz 45.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mps-youtube 0.2.1
File Interpreter ABI Platform
mps_youtube-0.2.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 93.1 kB

Release files / mps-youtube-0.2.1.tar.gz

Download URL mps-youtube-0.2.1.tar.gz
Size 45.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d6de39f690eca3dc6c6fd13a9576376ac784eb50dbb1b8c2e9e2722960850ccf
BLAKE2b-256 checksum
How to use checksums
ea99d4c4ccc8ecdae151ad0d2f5aa6d6ae3b094fdcbf40ae9610db45dca6af90
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / mps_youtube-0.2.1-py2.py3-none-any.whl

Download URL mps_youtube-0.2.1-py2.py3-none-any.whl
Size 47.5 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
604735d92e35689b7f1b6109bda57b56ce56b5548a78f81b5696d42d007f6ac3
BLAKE2b-256 checksum
How to use checksums
a89472b969466b12ea1928797ebdef49c64b1de64e5e415a21b6989dee4f3f35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

This release

0.2.1 This release

2 release files

0.2.0

2 release files

0.01.44

1 release file

0.01.41

1 release file

0.01.40

1 release file

0.01.39

1 release file

0.01.36

1 release file

0.01.35

1 release file

0.01.34

1 release file

0.01.33

1 release file

0.01.32

1 release file

0.01.31

1 release file

0.01.30

1 release file

0.00.00

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page