Getting started

CISAP runs on Linux, OpenBSD and FreeBSD. It needs Python 3.11 or newer and mpv (libmpv) from your OS.

Install

Install mpv and pipx

pacman -S mpv python-pipx

Install CISAP

pipx install cisap

Play something

cisap song.mp3            # plays at once
cisap ~/Music/album/      # a whole folder
cisap                     # restores the queue from last time

OpenBSD and FreeBSD support follows their docs and packages; it has not been tested on real BSD machines yet. Reports are welcome.

First run

The first time, the queue is empty: press o to browse local files or n to add a Navidrome server. Press ? any time for the key list.

From then on, quitting saves the queue to ~/.local/state/cisap/queue.m3u, and a bare cisap restores it with the cursor on the last song. Press Space to carry on.

Man pages

cisap --man              # read cisap(1) without installing it
cisap --install-man      # install cisap(1) and cisap.conf(5)