Installation

Wiki ▸ Installation

Welcome to the slimpd wiki!

DEPENDENCIES

• MPD >=0.20.3 music player daemon
• MySQL/MariaDB
• PHP >=5.6
  • Modules iconv, pdo_mysql, gd
• Python2.X
• Sphinx ¹↵
• Webserver (Apache, Nginx, Lighttpd, ...)
  • read-access to MPD-database-file (plain-text or gzip supported)
  • read-access to filesystem configured in 'mpd.conf:music_directory'
  • optional: enable module mod_rewrite

Supported audio formats

^{MP3, M4A, MP4, AAC, FLAC, WMA, AC3, and, OGG}

• Lame (for displaying waveforms)
• _optional:
  • FAAD2 (for displaying waveforms for .m4a, .mp4, and, .aac)
  • Flac and Metaflac(usually included within the Flac package) (for displaying waveforms for .flac)
  • Mplayer (for displaying waveforms for .wma and .ac3)
  • Vorbis-Tools (for displaying waveforms for .ogg)

---

SETUP

• Create a virtual-host which points to your filesystem

Configure MySQL

^{For help: MYsQL/MariaDB database creation}

• MySQL and MariaDB are considered interchangeable although MariaDB is recomended.
  • config changes [mysqld] max_allowed_packet = 4M
• Webserver-user must have write permission to CREATE DATABASE.

Configure sliMpd

^{For help: Configuration}

• Copy */slimpd/core/config/config_local.sample.ini to */slimpd/core/config/config_local.ini
  and check values.
• Make sure that your web-server has write access to these directories:

  */slimpd/localdata/cache/
  */slimpd/localdata/embedded/
  */slimpd/localdata/peakfiles/

Import music library

• This will create your MySQL database tables and begin the import of your music from your Mpd-database:

  $ php '*/slimpd/slimpd' hard-reset

Create Sphinx database

• Add Sphinx-configuration to: /etc/sphinx/sphinx.conf based on */slimpd/core/config/sphinx.example.conf.
  _{Under most circumstances you can copy */slimpd/core/config/sphinx.example.conf to /etc/sphinx/sphinx.conf.}
• Update the Sphinx-index.

  • The first time after setting up Sphinx you must run:

    # indexer slimpdmain slimpdsuggest

  • For all future Sphinx updates run:

    # */slimpd/core/scripts/sphinx-rotate.sh

Systemcheck

• After completing setup, run systemcheck. Either type in sliMpd's web-address and at */index.php/*,change it to */index.php/systemcheck, or simply press the 'Gear Icon' on the sliMpd web-page.
• Scroll down the page and check for 'Success' or 'Error' messages. This is how to debug your installation.

  • Filesystem: make certain it says 'Success' for every subheading. All 'Error' messages under this heading must be fixed!

    • _{READ-PERMISSION TO ACCESS MPD'S MUSIC-DIRECTORY - Your [MPD music-directory](https://github.com/othmar52/slimpd/wiki/Configuration/#mpd ""config_local.ini [mpd]") and its children must be read accessible to your webserver-user.}
    • _{WRITE-PERMISSION FOR CACHE-DIRECTORY - Your webserver-user must have write permission to the '/slimpd/localdata/cache/' directory.}
    • _{WRITE-PERMISSION FOR EMBEDDED-DIRECTORY - Your webserver-user must have write permission to the '/slimpd/localdata/embedded/' directory.}
    • _{WRITE-PERMISSION FOR PEAKFILES-DIRECTORY - Your webserver-user must have write permission to the '/slimpd/localdata/peakfiles/' directory.}

  • Database: MySQL-database, make certain it says 'Success' for every subheading. All 'Error' messages under this heading must be fixed!

    • _{CONNECTION - You must be able to successfully connect to the MySQL-database created for sliMpd at http://localhost, by having the correct dbusername, dbpassword, and dbdatabase information added to your '/slimpd/core/config/config_local.ini'.}
    • _{PERMISSIONS OF DATABASE-USER - MySQL database user has permission to create databases.}
    • _{SCHEMA - MySQL database tables created correctly via running the php '*/slimpd/slimpd' hard-reset script.}
    • _{DATABASE CONTENT - Confirmation of Mpd-database import into the MySQL database. Listing the number of imported Tracks, Albums, Artists, Genres, and Labels.}

  • MPD: make certain it says 'Success' for every subheading. All 'Error' messages under this heading must be fixed!

    • _CONNECTION
    • _{READ ACCESS TO DATABASE FILE}

  • Sphinx: ¹ ↵ make certain it says 'Success' for every subheading. All 'Error' messages under this heading must be fixed!

    • _CONNECTION
    • _SCHEMA
    • _{INDEXED DATA}

  • Waveform: The 'Success' or 'Error' messages are for the codecs installed. Only the codecs required for your music collection are necessary to have installed. The 'Show More' buttons, when pressed give detailed information for the creation of the test music file 'Fingerprint' with result comparison. It also provides details for the executed command used to create the test music file 'Waveform' and states whether the test failed or succeeded. These may prove helpful to debug should a codec you have installed not show as successfully creating the 'Fingerprint' and 'Waveform'.

    • _{MP3 EXTRACT FINGERPRINT and MP3 EXTRACT PEAKS FOR WAVEFORM These are the only exception. They must be successfully installed with a green 'Check'!}
    • _{FLAC EXTRACT FINGERPRINT and FLAC EXTRACT PEAKS FOR WAVEFORM}
    • _{WAV EXTRACT FINGERPRINT and WAV EXTRACT PEAKS FOR WAVEFORM}
    • _{M4A EXTRACT FINGERPRINT and M4A EXTRACT PEAKS FOR WAVEFORM}
    • _{AIF EXTRACT FINGERPRINT and AIF EXTRACT PEAKS FOR WAVEFORM}
    • _{AAC EXTRACT FINGERPRINT and AAC EXTRACT PEAKS FOR WAVEFORM}
    • _{OGG EXTRACT FINGERPRINT and OGG EXTRACT PEAKS FOR WAVEFORM}
    • _{WMA EXTRACT FINGERPRINT and WMA EXTRACT PEAKS FOR WAVEFORM}
    • _{AC3 EXTRACT FINGERPRINT and AC3 EXTRACT PEAKS FOR WAVEFORM}

  • Enviroment: Currently unimplemented.

    • _{check if php-pdo is enabled Unimplemented}
    • _{check locale settings to avoid errors caused by special chars Unimplemented}

  • Xwax: Currently unimpliimented.

    • _{check connection Unimplemented}

Return To Top

^{1. Sphinx will be optional in the future}