Skip to content

MusicPlayerPlus Version 2.0.1 Release 3
Compare
Choose a tag to compare
@doctorfree doctorfree released this 18 Sep 01:32
· 208 commits to master since this release
v2.0.1r3
bb47a5a

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:

  • 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 and mpd-configure commands and man pages
  • Integrate RoonCommandLine, MirrorCommand, and Asciiville menus
  • Add -l music_dir option to mppinit
    • 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_2.0.1-3.amd64.deb

or, on a Raspberry Pi:

sudo apt install ./MusicPlayerPlus_2.0.1-3.armhf.deb

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./MusicPlayerPlus_2.0.1-3-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_2.0.1-3.fc36.x86_64.rpm

On CentOS Linux:

sudo yum localinstall ./MusicPlayerPlus_2.0.1-3.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-2.0.1-3.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-2.0.1-3.tar.gz and use the makepkg command to download the sources, build the binaries, and create the installation package:

tar xzf MusicPlayerPlus-pkgbuild-2.0.1-3.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

Changes in version 2.0.1 release 2 include:

  • Arch Linux build and packaging support
  • CentOS Linux build and packaging support
  • Integration of the Beets media library management system
  • Add support for Mopidy and Mopidy administration
  • Add support for Navidrome and Navidrome administration
  • Add new config file ~/.config/mpprc for MusicPlayerPlus preferences
  • Fixes for EWMH non-compliant window managers (e.g. DWM)
  • Add support for Kitty as default terminal emualator
    • Custom Kitty configuration, themes, and sessions
  • Add Beets web plugin service
  • Automated Beets xtractor plugin installation and configuration
    • Beets xtractor plugin performs acoustic analysis and metadata updates
    • Gaia and Essentia for audio analysis and audio-based information retrieval
    • Pre-compiled streaming_extractor_music extractor binary with Gaia
  • Support for automated WAV to MP3 conversion with mpplus -F
  • Support for automated lyrics download with mpplus -L
  • Support for YAMS Last.fm scrobbler activation with mpplus -Y
  • Help menu to mpplus
  • Man pages for scdl and bandcamp-dl
  • Script to download Soundcloud favorites
  • Script to download Bandcamp collections
  • Options to use AcousticBrainz rather than Essentia for audio information
  • Custom targets to xtractor config
  • Bandcamp and Soundcloud downloads to mppinit
  • Import and metadata retrieval to mppinit
  • Add blissify MPD library analysis and smart playlist generator
  • Add mpplus menu to manage downloads
  • Add new command 'listyt' to list YouTube video titles and urls
  • Add Sphinx docs for Read the Docs MusicPlayerPlus documentation
  • Add mppdl command and yt-dlp module for downloading audio from various sites
  • Add mppcover command to display album cover art of currently playing song
  • Only install Bliss utils if they compile successfully
  • Additional python module dependencies installed during mppinit
  • Messages in mppinit tailored to which acoustic analysis is performed
  • Remove dependencies on gnome-terminal and tilix
  • Add dependency on wmctrl and xrandr, remove dependency on dconf
  • Improved album cover art download and display
  • Preserve existing user configurations where appropriate
  • Add view service logs menu to mpplus
  • Add mpd-monitor and mpd-configure commands and man pages
  • Integrate RoonCommandLine, MirrorCommand, and Asciiville menus

See CHANGELOG.md for a full list of changes in every MusicPlayerPlus release

Assets 10
Loading