AudioMuse音乐发现插件

Installation and Configuration

• Go on Jellyfin > Control Panel > Plugin Catalog
• Click on the gear-shaped settings icon on the top on the page to add a new manifest
• Add the AudioMuse AI manifest: https://raw.githubusercontent.com/NeptuneHub/audiomuse-ai-plugin/master/manifest.json
• Going back on Plugin Catalog youl will now show the plugin under the General section. Click on it and then install.
• RESTART JELLYFIN
• Now go back to the list of plugin installed, and you just need to configure the URL to reach AudioMuse-AI container, for example: http://192.168.3.14:8000

Build yourself

If you want download the repo, do some change and then re-build locally, here the steps:

* Download the repo locally and do your change

git clone https://github.com/NeptuneHub/audiomuse-ai-plugin.git

* go in the root folder of the repo and run this command:

dotnet restore && dotnet publish -c Release -o ./publish

* The only file that you need is this one, you can ignore all the other:

Jellyfin.Plugin.AudioMuseAi.dll

IF instead you fork this repo, there is an automated workflow that automatically build when you add a new tag from git:

git tag v0.0.6-alpha        
git push origin v0.0.6-alpha

Requirements: For compiling the actual version of the repo you need dotnet-sdk-8.0, new version could require something newer, on Ubuntu/Debian install in this way:

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

Usage

For Developer: Once Jellyfin is back online, the AudioMuse-AI middleware will be loaded automatically. Your applications can now call Jellyfin’s API endpoints directly so no additional proxying through the AudioMuse-AI service is required.

For the final user: In the scheduled task section you will find all the AudioMuse AI tasks. You can wait for their schedule or launch them manually (the first time it is recommended to manually launch them). The InstantMix functionality is reachable as usual by clicking on a specific Artist, Album, Song or Playlist with the right button and selecting the Instant Mix functionality.

API CALL EXAMPLE

Below some API call example that you can run from linux cli, just remember to put in YOUR-JELLYFIN-URL:PORT and YOUR-JELLYFIN-API-TOKEN. For integration in a front-end you probably will not need the token because you will use the login session of the user.

For a more complete documentation rembemer to see the AudioAMuse-AI repo and also remember that the AudioMuse-AI API have an apiddocs that you can use like http://YOUR-AUDIOMUSE-URL:PORT/apidocs/.

The aims is to replicate them 1:1, if this dosen't happen please feel a detailed issue (maybe with an example of call directly to AudioMuse-AI API and the different call to the AudioMuse-AI-Plugin API for check).

Screenshots

Here are a few glimpses of AudioMuse AI Plugin in action

Plugin Configurations page

AudioMuse AI-Plugin - The Jellyfin AudioMuse AI plugin

<p align="center"> <img src="https://github.com/NeptuneHub/audiomuse-ai-plugin/blob/master/audiomuseai.png?raw=true" alt="AudioMuse-AI Logo" width="480"> </p>

AudioMuse-AI-Plugin is a Jellyfin plugin that integrates core AudioMuse-AI features into the Jellyfin front-end. It also provides a 1:1 API mapping, allowing front-end developers to interact directly with Jellyfin endpoints for seamless integration.

For the end-user the plugin directly integrate in Jellyfin this scheduled task: Analysis task: By default scheduled daily Clustering task: By default scheduled weekly * Sonic Fingerprint task: By default scheduled weekly

Front-End tested with the plugin are: Integrated Jellyfin web frontend and official mobile app Finamp - iOS/Android open source mobile app; Jellify - iOS/Android open source mobile app, more information here: https://github.com/Jellify-Music/App/issues/1175 Symfonium - Androind closed source mobile frontend. More informetion on Symfonium forum or here: https://symfonium.app/news/version-1330/ * Feishin - Web opensource frontend, more information here: https://github.com/jeffvli/feishin/issues/1675

Other frontnend not in this list could also work by using the below API.

IMPORTANT NOTE: > * After installation, the AudioMuse-AI-Plugin must be configured with the correct AudioMuse-AI endpoint. Make sure the AudioMuse-AI core container application is also deployed, as the plugin depends on it.

The full list or AudioMuse-AI related repository are: > AudioMuse-AI: the core application, it run Flask and Worker containers to actually run all the feature; > AudioMuse-AI Helm Chart: helm chart for easy installation on Kubernetes; > AudioMuse-AI Plugin for Jellyfin: Jellyfin Plugin; > AudioMuse-AI Plugin for Navidrome: Navidrome Plugin; > * AudioMuse-AI MusicServer: Open Subosnic like Music Sever with integrated sonic functionality.

Plugin Tasks page