A Museekd on Debian 8 Jessie howto

Museekd is a Soulseek application for Linux based systems. It is headless and needs a client to be operated. I took a few steps to use Museekd on Debian. Here’s a quick overview.

Install the museekd package: sudo apt-get install museekd

Create a user museekd: sudo useradd -m -d /etc/museekd -s /bin/false museekd
If the user already exists after installation, use usermod plus the arguments you want to use instead.

Museekd in Debian comes with an traditional init-script, which you really do not want to use. Remove the script in /etc/init.d and create a file called museekd.service in /etc/systemd/system as root user or using sudo. Systemd is more powerfull and this simple .service file contains all information it needs.

[Unit]
Description=Museekd
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
PIDFile=/var/run/museekd.pid
Restart=no
TimeoutSec=5min
KillMode=process
GuessMainPID=no
RemainAfterExit=no
ExecStart=/usr/bin/museekd -c /etc/museekd/config.xml
User=museekd

[Install]
WantedBy=multi-user.target

Make sure you have a working Soulseek account, otherwise create one here.

Run musetup using the following command: musetup /etc/museekd/config.xml to create a config file and set up your shared folders. You can also tweak other settings here as well. Make sure your shared folders are readable and your download folders are writable for Museekd.

Note: the musetup program is not always reliable when creating your config file. I reccomend you modify you config by editing the text file with a text editor. However you need the musetup program to configure your shares. Check the configfile after you ran musetup for any errors.

<?xml version="1.0" encoding="UTF-8"?>
<museekd>
  <domain id="clients.bind">
    <key id="first">2234</key>
    <key id="last">2234</key>
  <domain id="interfaces">
    <key id="password">YOUR_CLIENT_PASS</key>
  </domain>
  <domain id="interfaces.bind">
    <key id="INTERFACE_IP:2240"/>
  </domain>
  <domain id="server">
    <key id="host">server.slsknet.org</key>
    <key id="password">YOUR_SOULSEEK_PASS</key>
    <key id="port">2242</key>
    <key id="username">YOUR_SOULSEEK_USER_NAME</key>
  </domain>
  <domain id="transfers">
    <key id="autoclear_finished_downloads">false</key>
    <key id="autoclear_finished_uploads">false</key>
    <key id="autoretry_downloads">false</key>
    <key id="download-dir">COMPLETE_DIR</key>
    <key id="download_blacklist"/>
    <key id="download_rate">0</key>
    <key id="download_slots">0</key>
    <key id="have_buddy_shares">false</key>
    <key id="incomplete-dir">INCOMPLETE_DIR</key>
    <key id="only_buddies">false</key>
    <key id="privilege_buddies">false</key>
    <key id="trusting_uploads">false</key>
    <key id="upload_rate">0</key>
    <key id="upload_slots">0</key>
    <key id="user_warnings">true</key>
  </domain>
  <domain id="userinfo">
    <key id="image">YOUR_IMAGE</key>
    <key id="text">YOUR_TEXT</key>
  </domain>
</museekd>

Edit the values in the config file to make it work for you! While runnig museekd, the program will add items to the config file, so your config file may look different.

Open port 2234 and 2242 in your firewall and/or on your router, so you can connect with the Soulseek server. To make a connection between your Museekd instance and it’s client, you use port 2240. You can open this port if you like, but I recommend you use VPN instead.

Start Museekd as a daemon by running sudo systemctl start museekd.service

Pick a client to control your Museekd instance. I personaly use Museeq. If the machine is Debian based, simply run sudo apt-get install museeq to install Museeq. You can run the client on the same machine as the Museekd daemon, but also on another machine in your network.

Leave a Reply Cancel reply