MusicPlayerPlus Version 3.0.0 Release 2
MusicPlayerPlus is an open source suite of character-based/console utilities, services, and tools to ease the installation, configuration, integration, and management of a music library, music server(s), music player, spectrum visualizer, music downloads, and more.
This major new release of MusicPlayerPlus adds support for many new features and components including:
- Auto-generation of Obsidian markdown vault from Discogs collection
- Auto-generation of Obsidian markdown vault from local music library
- Auto-generation of Discogs collection from Obsidian markdown vaults
- Modular installation and configuration of supporting components
- PipeWire service management and configuration
- Integration of the Beets media library management system
- Support for the Mopidy Music Server and extensions
- Support for the Navidrome Streaming Music Server
- Several supported Operating System platforms:
- Arch Linux build and packaging support (NEW)
- CentOS Linux build and packaging support (NEW)
- Debian format packaging (tested on Ubuntu 20.04 and Raspbian bullseye)
- RPM format packaging (tested on Fedora 35, CentOS 8)
- Support for Kitty as default terminal emualator
- Custom Kitty configuration, themes, and sessions
- Support for YAMS Last.fm scrobbler activation
- Automated download of Soundcloud favorites
- Automated download of Bandcamp collections
- Automated download of YouTube playlist audio
- Automated download of audio from many other sites
- Preserve existing user configurations where appropriate
- Add
mpd-monitor
andmpd-configure
commands and man pages - Integrate
RoonCommandLine
,MirrorCommand
, andAsciiville
menus - Add
-l music_dir
option tomppinit
- To initialize a custom music library location in one step:
mppinit -l /path/to/library
- Many more improvements and features (See Changelog below)
Installation
Download the latest Debian, Arch, or RPM package format release for your platform.
Install the package on Debian based systems by executing the command:
sudo apt install ./MusicPlayerPlus_3.0.0-2.amd64.deb
or, on a Raspberry Pi:
sudo apt install ./MusicPlayerPlus_3.0.0-2.armhf.deb
Install the package on Arch Linux based systems by executing the command:
sudo pacman -U ./musicplayerplus-v3.0.0r2-1-x86_64.pkg.tar.zst
Install the package on RPM based systems by executing one of the following commands.
On Fedora Linux:
sudo yum localinstall ./MusicPlayerPlus_3.0.0-2.fc36.x86_64.rpm
On CentOS Linux:
sudo yum localinstall ./MusicPlayerPlus_3.0.0-2.el8.x86_64.rpm
PKGBUILD Installation
To install on a Raspberry Pi running Arch Linux, MusicPlayerPlus must be built from sources using the Arch PKGBUILD files provided in MusicPlayerPlus-pkgbuild-3.0.0-2.tar.gz
. This process can be performed on any x86_64
or armv7h
architecture system running Arch Linux. An x86_64
architecture precompiled package is supplied (see above). To rebuild this package from sources, extract MusicPlayerPlus-pkgbuild-3.0.0-2.tar.gz
and use the makepkg
command to download the sources, build the binaries, and create the installation package:
tar xzf MusicPlayerPlus-pkgbuild-3.0.0-2.tar.gz
cd musicplayerplus
makepkg --force --log --cleanbuild --noconfirm --syncdeps
[Note:] The full MusicPlayerPlus build from sources can be time consuming. Use a pre-built package if one is available for your platform.
Configuration
Execute the mppinit
command (Required).
If the music library is located somewhere other than $HOME/Music
or $HOME/music
then rather than mppinit
, execute the command mppinit -l /path/to/library
.
If the mppinit
MusicPlayerPlus initialization did not correctly detect the music library location then edit ~/.config/mpprc
, set the MUSIC_DIR
correctly, and run mppinit sync
.
To enable the Beets media library management system (Optional):
- Run
mppinit bandcamp
to download Bandcamp collections (Optional) - Run
mppinit soundcloud
to download Soundcloud favorites (Optional) - Run
mppinit import
to import the music library into Beets (Required) - Run
mppinit metadata
to organize and improve library metadata (Optional)
To install, configure, and activate the Mopidy music server:
- Run
mppinit mopidy
To install, configure, and activate the Navidrome streaming music server:
- Run
mppinit navidrome
See the MusicPlayerPlus README for additional configuration info.
Removal
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove musicplayerplus
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove MusicPlayerPlus
Removal of the package on Arch Linux based systems can be accomplished by issuing the command:
sudo pacman -Rs musicplayerplus
Building MusicPlayerPlus from source
MusicPlayerPlus can be compiled, packaged, and installed from the source code repository. This should be done as a normal user with sudo
privileges:
# Retrieve the source code from the repository
git clone https://github.com/doctorfree/MusicPlayerPlus.git
# Enter the MusicPlayerPlus source directory
cd MusicPlayerPlus
# Install the necessary build environment (not necessary on Arch Linux)
scripts/install-dev-env.sh
# Install Gaia
./build -i gaia
# Compile the MusicPlayerPlus components and create an installation package
./mkpkg
# Install MusicPlayerPlus and its dependencies
./Install
The mkpkg
script detects the platform and creates an installable package in the package format native to that platform. After successfully building the MusicPlayerPlus components, the resulting installable package will be found in the ./releases/<version>/
directory.
Changelog
View the full changelog for this release at https://github.com/doctorfree/MusicPlayerPlus/blob/v3.0.0r2/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every MusicPlayerPlus release