Skip to main content

A simple curses audio player

Project 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.

Instead of building an elaborate database of your music library, cplay allows you to quickly browse the filesystem and enqueue files, directories, and playlists.

The original cplay was started by Ulf Betlehem in 1998 and is no longer maintained. This is a rewrite that aims to stay true to the original design while evolving with a shifting environment.

screenshot of cplay with file browser


  • python3
  • mpv
  • pulseaudio-utils, specifically the pactl command


$ pip install cplay-ng


$ cplay-ng

Press h to get a list of available keys.

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-5.0.1.tar.gz (8.3 kB view hashes)

Uploaded source

Built Distribution

cplay_ng-5.0.1-py3-none-any.whl (15.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page