Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A curses front-end for various audio players

Project Description

Description

cplay-ng is a curses front-end for various audio players written in python. It aims to provide a power-user-friendly interface with simple filelist and playlist control.

The original cplay is no longer maintained. This fork aims to maintaining the original code as well as keeping it up to date with recent developments (e.g. python3) and adding new features.

Requirements

  • python
  • pyalsaaudio (optional) For Alsa mixer support
  • python-oss (optional) For OSS mixer support
  • pulseaudio-utils, specifically the pactl command (optional) For PulseAudio mixer support
  • mutagen (optional) For metadata support (IDv3 etc.)

For playback, install one or more of the following players:

Installation

pip install cplay-ng

Usage

cplay-ng [ file | dir | playlist ] ...

For a full list of command line options, see cplay-ng --help. When in doubt about runtime controls, press ‘h’ for a friendly help page.

Apart from cplay-ng, this distribution also includes the program cnq-ng to remote-control a running cplay-ng.

Configuration

If you would like to change options passed to the actual players just edit the PLAYERS list in the cplay-ng script or put the PLAYERS definition in either ~/.cplayrc or /etc/cplayrc. If one of these files is available, it is executed by cplay-ng before initialization.

Macros are defined using the MACRO dictionary, where the key is a key and the value is a string of cplay-ng input. For example, the following would make ,d delete tagged (or current) files:

MACRO['d'] = '!rm "$@"\n'

Note, there is currently no version control for the rc-file!

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-ng, as stdin will be reopened on startup unless it is attached to a tty.

The shell command gets the full path of either all tagged items or the current item as positional arguments.

Release History

Release History

This version
History Node

2.3.0

History Node

2.2.0

History Node

2.1.2

History Node

2.1.1

History Node

2.1.0

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
cplay-ng-2.3.0.tar.gz (28.6 kB) Copy SHA256 Checksum SHA256 Source Jun 5, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting