AudioMuse-AI-NV-plugin  by NeptuneHub

AI-powered music discovery plugin for media servers

Created 4 months ago
316 stars

Top 85.4% on SourcePulse

GitHubView on GitHub
Project Summary

This Navidrome plugin integrates AudioMuse-AI's sonic analysis capabilities to enhance music discovery within the Navidrome ecosystem. It targets Navidrome users and developers of compatible frontends, offering real-time song similarity for instant mixes and artist similarity for radio-like features, thereby enriching the music listening experience.

How It Works

The plugin embeds core AudioMuse-AI functionalities directly into the Navidrome frontend. It leverages APIs such as getSimilarSongs2, getSimilarSongs, and getArtistInfo to provide features like Instant Mix (song similarity) and Radio (artist similarity). From version 8 onwards, it supports the Sonic Similarity API extension, enabling more advanced real-time audio analysis for music discovery and metadata enrichment.

Quick Start & Requirements

Installation typically involves Docker Compose, ensuring Navidrome (v0.60.0+ for InstantMix support), the AudioMuse-AI-NV-plugin, and AudioMuse-AI core containers are aligned. Key environment variables like ND_PLUGINS_ENABLED, ND_PLUGINS_AUTORELOAD, and ND_AGENTS must be configured in Navidrome. The audiomuseai.ndp plugin file needs to be placed in Navidrome's data plugins folder. Building the plugin requires Go and TinyGo.

Highlighted Details

  • Supports multiple frontends including Navidrome's web UI, Substreamer (iOS/Android), Tempus (Android), Symfonium (Android), and Feishin (Web).
  • Introduced Sonic Similarity API extension support in v8.
  • Part of a broader AudioMuse-AI ecosystem, including core applications, Helm charts, Jellyfin plugins, and a MusicServer.

Maintenance & Community

No specific community links (e.g., Discord, Slack) or details on notable contributors/sponsorships are provided in the README.

Licensing & Compatibility

License information is not explicitly stated in the provided README content.

Limitations & Caveats

Strict version alignment between Navidrome, the plugin, and AudioMuse-AI core containers is critical to prevent errors. The plugin's functionality is dependent on the availability and correct configuration of these external components.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
2
Star History
77 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.