Musp is a command line music player with a minimalistic interface. It consists of a daemon, muspd, and a command line tool to interact with the daemon.
Currently, musp only supports playback of FLAC; however, it is rather easy to support new codecs without modifying the source code of musp itself. Instead the user can use hooks to provide additional functionality. See the manpage of muspd to see the details of how to do so, or see the file muspdec/muspdec.flac for an example.
Musp can be compiled for OSS or ALSA support. By default, it is compiled for ALSA. It is not possible to compile it for both.
In order to utilize the provided FLAC decoding hook, is necessary to have the flac command line utility installed. This is not strictly required however, as the user may choose to provide his own decoder.
For compilation with the OSS backend, there are no additional dependencies other than the inevitable: C99 compiler and POSIX-compatible make.
For compilation with the ALSA backend, there is the additional requirement of libasound2 (1.2.8).
The build system is based on (hopefully) portable Makefiles. In order to build using the ALSA backend, simply run:
$ make
If, instead, OSS be the backend desired, set the environment variable MUSPD_AUDIO to the value MUSPD_AUDIO_OSS; for example, run:
$ MUSPD_AUDIO=MUSPD_AUDIO_OSS make
If you happen to have a required library in an esoteric location, please set the environment variables CFLAGS and LDFLAGS accordingly, or simply edit the Makefile to suit your system. For example:
$ LDFLAGS=-I/usr/local/include CFLAGS=-L/usr/local/lib make
Installation can be performed with the "install" target of the Makefile; note, however, that you MUST set the environment variable DESTDIR to point to the location at which you wish to install musp:
$ DESTDIR=/my/staging/directory make install
It is recommended to not run "make install" as root and instead use some unprivileged staging location and then copy the resulting files manually as root.
Copyright © 2019-2024 B.R.S. Roso.
Musp is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.
This program is distributed in the hope that it be useful but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should receive a copy of the GNU General Public License along with Musp. If not, see https://www.gnu.org/licenses.