Manual installation of LMS plugins

To manually install an LMS plugin hosted on GitHub:

• Go to LMS > Settings > Manage Plugins and uninstall the currently installed version of the plugin, if applicable.

• Download the latest version of the plugin from GitHub: click the green Code button and download the ZIP archive.

• Now locate the correct Plugins folder for manually installed plugins:

  • Regardless of which operating system your LMS runs on, you can always find a list of the Plugin Folders used by LMS
    at the bottom of LMS > Settings > Information. Their names may vary slightly depending on your OS, but some basic naming rules still apply.
    
    In most cases, you'll find 3 folders there:

    • one whose path contains InstalledPlugins. This folder is only for plugins installed via LMS > Settings > Manage Plugins, NOT for manual installations.

    • another whose path contains server. This folder is for pre-installed LMS plugins only. Do NOT move plugins there.

    • and the last and correct one, whose path often (but not always) shares the same base path as the Preferences Folder and ends, for example, in Plugins. In this case, the Plugins folder for manual installations and the Preferences Folder have the same parent folder.
      
      💡 Even if the name or path of this folder is slightly different on your OS, it should be the one whose path does not contain InstalledPlugins or server. This is the Plugins folder you need.

    • Examples of LMS plugin folder paths for manual plugin installation (no guarantees):

      • piCorePlayer: /usr/local/slimserver/Plugins
      • macOS: /Users/yourusername/Library/Application Support/Squeezebox/Plugins
      • Windows: C:\Program Files (x86)\Squeezebox\server\Plugins
      • Docker: [config folder]/cache/Plugins (see this page for details)

      ⚠️ With the release of LMS 9, folder names such as Squeezebox and slimserver may eventually be replaced with Lyrion.

• Extract the downloaded archive and move the plugin folder (named after the plugin) — and only that folder — to the correct Plugins folder. Make sure you do not copy an additional parent folder created by the archive extraction process. The plugin folder itself should contain the plugin files, including a file named install.xml.

• Restart LMS.
  
  
  

Manual uninstallation

• Delete the plugin from the Plugins folder used for manually installed plugins (see installation instructions above).
• Restart LMS.
  
  
  

Manual installation means no automatic updates

If you install a plugin manually, you'll need to update it yourself by manually uninstalling the old version and then installing the new one.
Plugins installed manually are not updated automatically by LMS.