Install GNUMP3d - A Streaming Media Server in RHEL/CentOS/Fedora and Ubuntu/Debian

GNUMP3d is a lightweight and easy-to-use streaming media server that allows users to share and stream their music collection over the internet. It supports various platforms, including RHEL, CentOS, Fedora, Ubuntu, and Debian. This article will guide you through the installation process of GNUMP3d on these Linux distributions, along with configuration examples and troubleshooting tips.

Prerequisites

Before proceeding with the installation, ensure you have the following prerequisites

• A running instance of RHEL, CentOS, Fedora, Ubuntu, or Debian.

• A user account with sudo privileges.

• A music collection stored in a directory accessible by the system.

Installation

Follow the steps below for your respective Linux distribution to install GNUMP3d

RHEL, CentOS, and Fedora

Update the system's package repository

sudo yum update

Install GNUMP3d using the package manager

sudo yum install gnump3d

Ubuntu and Debian

Update the system's package repository

sudo apt update

Install GNUMP3d using the package manager

sudo apt install gnump3d

Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following additional packages will be installed:
   apache2 apache2-bin apache2-data apache2-utils flac imagemagick libapache2-mod-php
The following NEW packages will be installed:
   apache2 apache2-bin apache2-data apache2-utils flac gnump3d imagemagick libapache2-mod-php
0 upgraded, 25 newly installed, 0 to remove and 0 not upgraded.
Need to get 47.0 MB of archives.
After this operation, 315 MB of additional disk space will be used.
Do you want to continue? [Y/n]

Configuration

After installation, configure GNUMP3d to serve your music collection. The main configuration file is located at /etc/gnump3d/gnump3d.conf. Open this file using a text editor and modify the following important options

• musicdir Specifies the directory where your music collection is located.

• port Defines the port number on which GNUMP3d will listen (default: 8888).

• bindaddr Sets the IP address on which GNUMP3d will bind (default: 0.0.0.0).

Example configuration

musicdir = /home/user/Music
port = 8888
bindaddr = 0.0.0.0

Starting GNUMP3d

Start the GNUMP3d service

sudo systemctl start gnump3d

Enable the service to start automatically on boot

sudo systemctl enable gnump3d

Check the service status

sudo systemctl status gnump3d

Access and Usage Examples

Accessing the GNUMP3d Server

Open a web browser and navigate to the server URL. Assuming the server runs on localhost with the default port

http://localhost:8888

Changing the Music Directory

To serve music from a different directory, modify the musicdir option in /etc/gnump3d/gnump3d.conf

musicdir = /var/music/collection

Restart the service to apply changes

sudo systemctl restart gnump3d

Enabling User Authentication

To restrict access with user authentication, modify the configuration file

authentication = 1
userfile = /etc/gnump3d/users

Create a user account

sudo htpasswd -c /etc/gnump3d/users musicuser

New password: 
Re-type new password: 
Adding password for user musicuser

Advanced Configuration

Changing Server Port

To use a different port, modify the configuration

port = 9000

Supporting Multiple Media Types

Enable streaming of various audio formats by setting the types option

types = mp3,ogg,flac,wav,m4a

Troubleshooting

Checking Service Logs

View GNUMP3d logs for troubleshooting

sudo journalctl -u gnump3d

-- Logs begin at Mon 2023-06-26 10:00:00 UTC, end at Mon 2023-06-26 11:00:00 UTC. --
Jun 26 10:30:00 hostname systemd[1]: Started GNU MP3 Daemon.
Jun 26 10:30:00 hostname gnump3d[1234]: Starting GNU MP3 Daemon...
Jun 26 10:30:01 hostname gnump3d[1234]: GNU MP3 Daemon started successfully.
Jun 26 10:30:20 hostname gnump3d[1234]: GNU MP3 Daemon is now ready to serve requests.

Common Issues

Ensure the firewall allows connections to the GNUMP3d port

sudo firewall-cmd --add-port=8888/tcp --permanent
sudo firewall-cmd --reload

Conclusion

GNUMP3d provides an efficient way to set up a personal streaming media server across various Linux distributions. With proper configuration and the examples provided, you can easily share your music collection over the network. The server's lightweight nature and extensive customization options make it suitable for both personal and small-scale deployments.