Installation and Setup

Let’s go over the steps to start using Muo.

Download

You can use the install script or set everything up manually.

Script

Note

The install script will place the Muo executable into the /usr/local/bin directory.

Make sure the process has write permissions to do so.

The simplest variant to run the install script is the following:

curl -fsSL https://muo.cesbo.com/install | sudo bash

Note

The superuser priviledges are needed only to copy the Muo binary at the system folders. If you want to keep the command in user-space - adjust the installation directory.

Tip

If needed, you can adjust used locations:

The DOWNLOAD_DIR variable declares where to download the distribution archive.

The INSTALL_DIR variable declares where Muo binary will be placed.

For example, you can call:

curl -fsSL https://muo.cesbo.com/install | \
    sudo DOWNLOAD_DIR=/var/local/muo INSTALL_DIR=$HOME/bin bash

Manual

Visit https://muo.cesbo.com/latest and download the archive to the location of your choice.

Next, we need to unpack the archive to the installation folder. From now on, we will assume that installation folder is /usr/local/bin, however it can be just as any other.

Note

Make sure that the installation folder is included in the PATH variable.

Then extract the archive

tar xvf muo-linux-x86_64.tar.gz --directory /usr/local/bin

Note

Make sure the downloaded binary has execute permission.

(cd /usr/local/bin && chmod +x muo)

Configure

Settings of Muo are divided on permanent and runtime and ones.

Muo has sensible defaults in its Runtime settings. You can run Muo with no arguments whatsoever.

muo

Permanent settings

Permanent settings are saved in the internal Muo storage. You can change them on the Settings page.

Runtime settings

Runtime settings are provided as arguments. To view all available runtime arguments, call

muo --help

For example,

muo --data-folder /var/some/location

starts Muo and tries to save all the required data to /var/some/location folder.

Tip

By default, Muo tries to save its internal data to the $XDG_CONFIG_HOME/muo folder.

For any location you choose, make sure the process has write permissions to that folder.