Skip to content

Terminal based YouTube player and downloader, patched for hd support

License

Notifications You must be signed in to change notification settings

th0rn/mps-youtube

 
 

Repository files navigation

mps-youtube-hd

https://th0rn.github.io/mps-youtube-hd/resolution.png

Added Features

  • View videos in resolutions higher than 360p, for instance 1080p or 2160p. This is done by utilizing the youtude-dl backend built into mpv, rather than extracting a single stream.
  • Works with mpv ytdl-format scripts, like mpv-youtube-quality.
  • Requires mpv.
  • Available in the AUR.
  • Important: Will not work without a (free) Youtube API key!

Original 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
  • Convert to mp3 & other formats (requires ffmpeg or avconv)
  • View video comments
  • Works with Python 3.x
  • Works with Windows, Linux and Mac OS X

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

Search

http://mps-youtube.github.io/mps-youtube/std-search.png

A standard search is performed by entering / followed by search terms.

Note: You can play all of the search results by giving 1- as input

Local Playlists

http://mps-youtube.github.io/mps-youtube/local-playlist.png

Search result items can easily be stored in local playlists.

YouTube Playlists

http://mps-youtube.github.io/mps-youtube/playlist-search.png

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

A playlist search is performed by // followed by search term.

Download

http://mps-youtube.github.io/mps-youtube/download.png

Content can be downloaded in various formats and resolutions.

Comments

http://mps-youtube.github.io/mps-youtube/comments.png

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

Music Album Matching

http://mps-youtube.github.io/mps-youtube/album-1.png

http://mps-youtube.github.io/mps-youtube/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://mps-youtube.github.io/mps-youtube/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

Arch Linux

You can install mps-youtube-hd from the AUR (mps-youtube-hd-git).

Usage

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

mpsyt

Enter h from within the program for help.

About

Terminal based YouTube player and downloader, patched for hd support

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.7%
  • Dockerfile 0.3%