skip to navigation
skip to content

Not Logged In

Poor-Mans-Spotify 0.18.19

Search, Stream and Download MP3

Latest Version: 0.19.00

http://badge.fury.io/py/Poor-Mans-Spotify.png https://pypip.in/d/Poor-Mans-Spotify/badge.png

Features

  • 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

Screenshots

Playback

http://i.imgur.com/3sYlktI.png http://i.imgur.com/yzgQBmx.png

Playlists

http://i.imgur.com/RDEXLPW.png

Installation

Using pip:

sudo pip install Poor-Mans-Spotify

Using git:

git clone https://github.com/np1/pms.git

Manually:

Download zip file or tar.gz and extract:

https://github.com/np1/pms/archive/master.zip

https://github.com/np1/pms/archive/master.tar.gz

Mac OSX installation notes

Download mplayer:

https://www.macupdate.com/app/mac/18580/mplayer

Make a link for mplayer:

ln -s /Applications/MPlayer OSX.app/Contents/Resources/External_Binaries/mplayer.app/Contents/MacOS/mplayer /usr/local/bin/mplayer

Install X11:

http://xquartz.macosforge.org/landing/

if using MplayerX:

ln -s /Applications/MPlayerX.app/Contents/Resources/binaries/x86_64/mplayer /usr/local/bin/mplayer

Upgrading

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

Usage

pms is run on the command line using the command:

pms

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

./pms

Enter h from within the program for help.

Searching

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:

Downloading

d 3 to download song 3

Playback

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

Editing

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 playlist directly.

Invocation

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

 
File Type Py Version Uploaded on Size
Poor-Mans-Spotify-0.18.19.tar.gz (md5) Source 2013-12-20 13KB
  • Downloads (All Versions):
  • 137 downloads in the last day
  • 840 downloads in the last week
  • 5186 downloads in the last month