Skip to content

sporkexec/urmpc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

urmpc

urmpc is a console MPD client written in Python using the urwid library. It is
heavily influenced by ncmpcpp, but aims to be more configurable and have less
feature bloat. For example, urmpc does not aspire to have a tag editor because
this violates one of Unix's central tenets (do one thing and do it well) and
because there are already many fine tag editors on the market.

This software is still under heavy development but already accomplishes nearly
everything the author needs on a typical day. Features such as saved
playlist loading/manipulation are not yet implemented, however, so your mileage
may vary.


Installation

When available, it is recommended to use your distribution's standard packaging
system to install urmpc.

Direct Installation
# python2 setup.py install

Running urmpc In-place (without installing):
$ cd bin && ./urmpc


Usage

Almost exactly like ncmpcpp. See https://github.com/sporkexec/urmpc/blob/master/lib/urmpclib/urmpc.conf.example
for default keybindings or '0' (by default) to view configured keybindings.
Config file will be read from `~/.urmpc.conf`.

In Library panel:
	Space: enqueue
	Enter: enqueue and play

In Playlist panel:
	d, Delete: delete from playlist
	Enter: play this track
	K: move this track up
	J: move this track down
	o: jump to currently playing track

In any list:
	We support vi-like navigation (hjkl) as well as arrow keys.
	g, Home: jump to top of list
	G, End: jump to end of list
	Ctrl+f, PgDn: scroll list down one page
	Ctrl+b, PgUp: scroll list up one page
	/: search forwards
	?: search backwards
	n: jump to next search result
	N: jump to previous search result

Global Keys:
	p: play/pause
	>: next track
	<: previous track
	s: stop
	c: clear playlist
	Z: shuffle playlist
	+: raise volume
	-: lower volume
	f: seek forward
	b: seek backward

	r: toggle repeat mode
	z: toggle random mode
	y: toggle single mode
	R: toggle consume mode
	x: toggle crossfade
	u: force database update

	Tab: switch between Library and Playlist panels
	0: view live keybindings
	q, Q: quit

About

A console Python MPD client using urwid

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages