This manual page documents briefly the mps-yotube software which is based on mps, and uses YouTube as a source of content and can play and download video as well as audio.

. or / <song|artist> -Searches for song or artist

.. or // <song|artist> - Search in YouTube playlists

n|p -Next|Previous

d <number> -Downloads a song

all -Play all displayed tracks

vp -to view the current playlist (then use rm, mv and sw to modify it)

ls -to list your saved playlists

open <playlist_name or ID> -to open a saved playlist as the current playlist

view <playlist_name or ID> -to view a playlist (leaves current playlist intact)

play <playlist_name or ID> -to play a saved playlist directly.

save or save <playlist_name> -to save the currently displayed songs as a stored playlist on disk

rmp <playlist_name or ID> -to delete a playlist from disk

mv <old_name or ID> <new_name> -to rename a playlist

q -to quit

h -for help

top show -top tracks this week


Here are shown some additional examples for using mps such as:

i 3 -view info on item 3

d 3 -to download item 3 (will open new menu)

da 3-5, 7 -to download audio streams of items 3, 4, 5 and 7

dv 3-5, 7 -to download video streams of items 3, 4, 5 and 7

u 3 -to view more videos from uploader of item 3

r 3 -to view videos related to item 3

da <number

1,2,3 -to play songs 1 2 and 3

2-4,6,6-3 -to play songs 2, 3, 4, 6, 6, 5, 4, 3

Note: The commands shuffle and repeat can be inserted at the start or end of any of the above to enable those play modes: eg, shuffle 1-4 or 2-4,1 repeat

rm 1,5 -to remove songs 1 and 5.

rm 1,2,5-7 -to remove songs 1,2 and 5-7.

rm all -to remove all songs

sw 1,3 -to swap the position of songs 1 and 3

mv 1,3 -to move song 1 to postion 3

add 1,2,3 to add songs 1,2 and 3 to the current playlist.

add 1-4,6,8-10 to add songs 1-4, 6, and 8-10 to the current playlist

add 1-4,7 <playlist_name> -to add songs 1-4 and 7 to a saved playlist. A new playlist will be created if the given name doesn't already exist.

top3m -show top tracks for last 3 months

top6m -show top tracks for last 6 months

topyear -show top tracks for last year

topall -show all time top tracks


This manpage was created by Zlatan Todoric for use on Debian systems but can be used on other as well.