How to Install Mopidy MusicBox on macOS

Mopidy MusicBox is a web client for the Mopidy music server. This tutorial will guide you through the steps to install Mopidy MusicBox on macOS.

Prerequisites

  • Homebrew package manager installed on your macOS device
  • Python 2.x or 3.x installed
  • A running instance of Mopidy music server. You can follow the official documentation to install Mopidy.

Steps to Install Mopidy MusicBox

Step 1: Install Dependencies

Before installing Mopidy MusicBox, you need to install the following dependencies:

brew install npm
brew install yarn

Step 2: Install Mopidy MusicBox

  1. Clone the Mopidy MusicBox repository:
git clone https://github.com/pimusicbox/mopidy-musicbox-webclient.git
  1. Navigate to the cloned repository:
cd mopidy-musicbox-webclient
  1. Install the required packages:
yarn install
  1. Build the client:
yarn run build

Step 3: Configure Mopidy MusicBox

  1. Create a new configuration file using:
touch ~/.config/mopidy/musicbox_webclient/settings.json
nano ~/.config/mopidy/musicbox_webclient/settings.json
  1. Copy and paste the following configuration code into the file:
{
    "host": "0.0.0.0",
    "port": "6680",
    "musicbox": true,
    "title": "MusicBox",
    "websocket_host": "",
    "websocket_port": 6681,
    "enable_hotkeys": true,
    "show_i2c_stats": false,
    "hide_albumlist": false,
    "hide_welcome_message": false,
    "library_tag_info_method": "auto",
    "use_mopidy_music_name": true,
    "webclient_path": "/",
    "albumart_size": 200,
    "history_length": 40,
    "edit_mode": false,
    "musicbox_compat": false
}
  1. Press CTRL + X to exit and save the configuration file.

Step 4: Start Mopidy MusicBox

  1. Start the Mopidy MusicBox web client:
yarn start
  1. Open your web browser and type http://localhost:6680 in the address bar. You should see the Mopidy MusicBox web client interface.

Congratulations! You have successfully installed Mopidy MusicBox on macOS. Enjoy your music!