Install netjukebox server:
  • Step by step Windows XAMP installation: Stream your music library to any computer
  • Or manual install:
    Apache web server
    PHP 5.4.0 or later with extension: GD2, ICONV and MYSQLI
    One of the following databases:
    MySQL 5.5.3 or later for utf8mb4 support
    MariaDB 5.5 or later for utf8mb4 support
  • Download the latest netjukebox version.
  • Extract the netjukebox files to the web server document root.
  • Edit the configuration file netjukebox/include/config.inc.php
    and update the values for $cfg['mysqli_xxx'] corresponding with your MySQL configuration
    and also update the value for $cfg['media_dir'] corresponding with your media directory.
  • Start netjukebox from the webserver with http://localhost/netjukebox/ or from a client with http://server-ip-adress/netjukebox/.
  • Login with username admin and password admin.
  • Change the admin password trough the web interface config > users > admin.
  • Update the database trough the web interface config > update.
    Be aware that the first update takes much longer than all following updates!
Install netjukebox helper applications:
  • Windows:
    Download and extract the latest netjukebox helper application files to a directory outside the web root.
    And update $cfg['bin_dir'] in the config.inc.php file corresponding to this directory.
  • Ubuntu:
    sudo apt-get install lame vorbis-tools musepack-tools faad flac wavpack zip
    And update $cfg['bin_dir'] in the config.inc.php file to 'nice -n 20 /usr/bin/'; or '/usr/bin/';
  • Linux:
    Installing netjukebox helper applications on other Linux distributions should be very similar to the Ubuntu installation.
    On this page you can find the right package manager for your distribution.
  • OS X:
    Install the required packages with MacPorts.
    sudo port install lame vorbis-tools faad2 wavpack zip
    And update $cfg['bin_dir'] in the config.inc.php file to 'nice -n 20 /opt/local/bin/'; or '/opt/local/bin/';
Install Music Player Daemon on Linux:
  • Ubuntu:
    sudo apt-get install mpd
    Update music_directory from the /etc/mpd.conf file coresponding with the directory $cfg['media_dir'] from the netjukebox config.inc.php file.
    sudo service mpd restart
    Configure Player profile trough the web interface: config > player profile
    Update the database (and mpd database) trough the web interface config > update
  • Linux:
    Installing Music Player Daemon on other Linux distributions should be very similar to the Ubuntu installation.
    On this page you can find the right package manager for your distribution.
Install Winamp & httpQ plugin on Windows:
  • Install Winamp 2.8x, 2.9x or 5.xx.
  • Install the httpQ 3.1 plugin.
  • Start Winamp and press CTRL + P.
  • Select Plug-ins > General Purpose.
  • Now double-click on Winamp httpQ Plugin v3.1 [gen_httpq.dll].



  • Check Start service automatically.
  • Click on Start.



  • Configure Player profile trough the web interface: config > player profile