skip to navigation
skip to content

Not Logged In

Poor-Mans-Spotify 0.18.17

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

You can load a playlist when invoking pms using the following command:

pms open <playlistname>

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

File Type Py Version Uploaded on Size
Poor-Mans-Spotify-0.18.17.tar.gz (md5) Source 2013-12-18 12KB
  • Downloads (All Versions):
  • 175 downloads in the last day
  • 911 downloads in the last week
  • 5465 downloads in the last month