curses front-end for various audio players
Python Groff Makefile
Pull request Compare This branch is 61 commits ahead of holizz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ChangeLog
LICENSE
Makefile
README.rst
TODO
cplay
cplay.1

README.rst

Description

cplay is a minimalist music player with a textual user interface written in Python. It aims to provide a power-user-friendly interface with simple filelist and playlist control.

Dependencies

Music players supported (one of the first two provides support for most formats):

Other optional components:

  • reading metadata (tags):
  • volume control:
    • alsaaudio
    • pulseaudio-utils, specifically the pacmd command.

Installation

$ make install

Usage

$ cplay [-nrRv] [ file | dir | playlist ] ...

When in doubt, press h for a friendly help page.

Configuration

If you would like to change options passed to the actual players just edit the PLAYERS list at the end of the cplay script.

Miscellaneous

A playlist can contain URLs, but the playlist itself will have to be local. For mpeg streaming, splay is recommended.

It is also possible to pipe a playlist to cplay, as stdin will be reopened on startup unless it is attached to a tty.

Remote control via /tmp/cplay-control-$USER; see lircrc.