Record LMS‐settings - markbaaijens/rpmusicserver GitHub Wiki

For a good first-time user-experience, some default settings of LMS are changed. These settings are stored in the git-repo and wil be installed (copied) by the install-process so they can be picked up by LMS. After the install-process, these settings live their own life, i.e. settings a user makes afterwards will NOT be overwritten.

In this page, the process of recording the changed LMS-settings from the default is described.

To Do

  • de-activate other unuseful plugins?

Steps to record change of LMS-settings

(1) Clean LMS config-folder

On a development-server:

sudo kill-docker # Stop LMS
sudo rm -rf /media/usbdata/user/music/* # Prevent mixing personal user-cache
sudo rm -rf /media/usbdata/rpms/config/docker/lms/* # Remove LMS-settings
sudo start-docker # Start LMS

After starting LMS, a new tree is made under /media/usbdata/rpms/config/docker/lms containing all default settings.

(2) Change LMS-settings

  • Settings, Server, Manage Plugins:
    • de-activate:
      • 'Info Browser'
        • to prevent obscure .opml-files appearing in the music-folder
      • 'Radio'
        • b/c it requires a paid TuneIn-account
      • 'Online Music Library Integration'
        • no supported platforms
    • activate:
      • 'Material Skin' (3rd party)
      • 'AutoRescan' (3rd party)
        • triggers a scan as file-changes occur
      • 'RadioNet' (3rd party)
  • Settings, Server, Interface:
    • Web Interface: Material Skin
  • Settings, Server, Basic settings:
    • Media Library Name: RP Music Server
    • Playlists Folder: /playlist
  • Settings, Server, Interface:
    • Show Artist With Album: Enabled
    • Show Year With Album: Enabled

(3) Move new settings to rpms-repo

  • rm -rf ~/source/rpmusicserver/files/config/lms/*
  • copy all files
    • from /media/usbdata/rpms/config/docker/lms
    • to ~/source/rpmusicserver/files/config/lms
  • commit to git

Custom LMS-settings

Optionally, some personal settings can be made after the install of RPMS. Description is based on the Material Skin-theme (default within RPMS).

See Custom LMS-settings

Existing installations

Things to do on installs prior to 1.0 (0.9 and lower). See above for details.

  • de-activate 'Rescan Music Library' by resetting plugin-settings
  • activate 'Music and Artist Information'
  • de-activate 'Radio', activate 'RadioNet'
  • set Playlists Folder to /playlist
  • re-activate 'Random Mix'
    • in hindsight, this is quite a useful plugin, especially when the genres are correct