Skip to main content

A curses front-end for various audio players

Project description

Description

cplay-ng is a curses front-end for various audio players. It aims to provide a power-user-friendly interface with simple filelist and playlist control. cplay-ng is written in Python and can use either pyncurses or the standard curses module.

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

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

Installation

pip install cplay-ng

Usage

cplay-ng [-d <filename>] [-nrRm] [ file | dir | playlist ] ...

-d  Enable debugging output to <filename>.

-n  Start in restricted mode: No shell commands, changing directory,
    goto, or saving playlists.

-r  Start in repeat mode.

-R  Start in random mode.

-m  Switch channels (oss only)

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

You can also use 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.

Remote control is available via /var/tmp/cplay\_control-$USER. Create this with mkfifo and see lircrc for examples.

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

Project details


Download files

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

Source Distribution

cplay-ng-2.0.1.tar.gz (30.2 kB view details)

Uploaded Source

File details

Details for the file cplay-ng-2.0.1.tar.gz.

File metadata

  • Download URL: cplay-ng-2.0.1.tar.gz
  • Upload date:
  • Size: 30.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cplay-ng-2.0.1.tar.gz
Algorithm Hash digest
SHA256 8ee99da8be146b235d5f0ac2f7556d678386650e7af4a1123b1ba0a01316c684
MD5 bda4793341f0a86873846efca67bc98d
BLAKE2b-256 c1db49250ea9c85b0d67129a73570410aa69db091a32a80cb41fe0cdbba31db6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page