skip to navigation
skip to content

Not Logged In

Poor-Mans-Spotify 0.18.21

Search, Stream and Download MP3

Latest Version: 0.19.00


  • Search and stream music
  • Create playlists
  • Download music
  • Works with Python 2.7 and 3.x
  • Works with Windows, Linux and Mac OSX 10.9
  • No Python dependencies
  • Requires mplayer





Using pip:

sudo pip install Poor-Mans-Spotify

Using git:

git clone


Download zip file or tar.gz and extract:

Mac OSX installation notes

Download mplayer:

Make a link for mplayer:

ln -s /Applications/MPlayer /usr/local/bin/mplayer

Install X11:

if using MplayerX:

ln -s /Applications/ /usr/local/bin/mplayer


It is recommended you update to the latest version.

Upgrade pip installation:

sudo pip install Poor-Mans-Spotify --upgrade

Upgrade git clone:

(from within the pms directory)

git pull


pms is run on the command line using the command:


or on Linux/MacOS if you are in the same directory:


Enter h from within the program for help.


You can enter an artist/song name to search whenever the program is expecting text input. Searches must be prefixed with a . (dot) character.

When a list of songs is displayed, such as search results or a playlist, you can use the following commands:


d 3 to download song 3


all to play all displayed tracks

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

Playlist commands

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 it doesn't already exist.

ls to list your saved playlists

open <playlist_name> to open a saved playlist as the current playlist

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

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

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

rm <playlist_name> to delete a playlist from disk

mv <old_name> <new_name> to rename a playlist

q to quit

h for help

Other Commands

top show top tracks this week

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

Advanced Tips

Playlist Name Completion

When using open or view to access a playlist, you can type in the first few characters instead of the whole name. The first alphabetically matching playlist will be opened / displayed

Playlist Direct Play

Enter play <playlist_name> to access and play a saved playlist directly.


To load a saved playlist when invoking pms using the following command:

pms open <playlistname>

This also works for other commands, eg:

pms .mozart to search

pms view <playlistname> to view a saved playlist

pms ls to list saved playlists

pms top to list top tracks this week

pms play moz to open a saved playlist called mozart and start playing.

Specifying Ranges

When selecting songs for playback, removing or adding you can use 5- to select song 5 upward and -5 to select up to song 5. This can be included with other choice so for example: 5,3,7-,-2. You can also use spaces instead of commas eg. 5 3 7- -2 or a combination of both eg. 3,4 7-9, 1

Quality / Bitrate

Add +best to return high bitrate results and +good to exclude them.

File Type Py Version Uploaded on Size
Poor-Mans-Spotify-0.18.21.tar.gz (md5) Source 2013-12-23 13KB
  • Downloads (All Versions):
  • 362 downloads in the last day
  • 1627 downloads in the last week
  • 5771 downloads in the last month