14 installing
casey langen edited this page 2023-04-19 23:08:24 -07:00

intro

pre-compiled binaries are available for many major platforms, and can be downloaded here. if you can't find information for your platform, you can always build from source.

windows

  1. download musikcube_win32_x.y.z.zip (or musikcube_win32_with_milkdrop2_x.y.z.zip if you want the milkdrop audio visualizer included) from the releases page.
  2. unzip the archive to an empty directory
  3. run musikcube.exe

note: to avoid plugin incompatibilities between versions, it's recommended to always extract new versions to an empty directory.

macos

installing musikcube via homebrew is the recommended approach:

  • brew install musikcube

there are also pre-compiled binaries on the releases page, but they will only work for some versions of macos, and don't support as many file formats because they are distributed without the ffmpeg decoder plugin.

raspberry pi

detailed instructions for setting up a raspberry pi can be found here.

linux

ubuntu

head over to the releases page and grab the .deb for your version of ubuntu.

  1. sudo dpkg -i musikcube_x.y.z_ubuntu_xxx_amd64.deb
  2. sudo apt-get install -f
  3. /usr/bin/musikcube

fedora

to begin, get the .rpm for your version of fedora from the releases page.

musikcube uses lame and ffmpeg, both of which do not exist in the main fedora package repositories.

first, enable the rpmfusion repos:

  • sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

now, install the rpm:

  • sudo dnf install musikcube-x.y.z.fcxx.x86_64.rpm

arch

the community maintains an aur package, here. you can install it via whichever tool you prefer. for example, if you use yaourt:

  • yaourt -S musikcube

systemd

you can have the musikcube daemon (musikcubed) start automatically when your system boots. these instructions, originally provided by simolev here, show you how to accomplish this with systemd.

create the service

  1. sudo touch /etc/systemd/system/musikcube.service
  2. sudo systemctl edit --full musikcube.service

update the service definition

note: (replace <user> with your username):

[Install]
WantedBy=network-online.target

[Unit]
Description=musikcube Audio Streaming Server
Before=multi-user.target
Before=graphical.target
Before=shutdown.target
After=local-fs.target
After=remote-fs.target
After=network-online.target
After=nss-lookup.target
Wants=network-online.target
Conflicts=shutdown.target

[Service]
Type=forking
User=<user>
ExecStart=/usr/bin/musikcubed --start
ExecStop=/usr/bin/musikcubed --stop

enable the service

systemctl enable musikcube

freebsd

if you haven't already installed/updates ports:

  1. portsnap fetch
  2. portsnap extract

now install:

  1. cd /usr/ports/multimedia/musikcube
  2. make install