Release Date: July 08, 2026
You always wanted to run your own model on your music? Integrate your app with AudioMuse-AI? Add a page, a scheduled job, a new idea we never thought about? with AudioMuse AI v2.6.0 you can.
This release introduces the AudioMuse-AI plugin system. A plugin is a small Python package: you write it, you publish it, and every AudioMuse-AI user can install it from inside the app.
This is the first version. It is a tool for developers: if you want to build something on top of AudioMuse-AI, this is your starting point. It is also good news for users, because more plugins means more choice. Any feedback is welcome, open an issue and tell us what works, what breaks, and what is missing.
What a plugin can do
| Capability | How |
|---|---|
| Add a web page with a menu entry | add_blueprint, add_menu_item |
| Have its own settings page and settings storage | settings route, get_setting / set_setting |
| Read the whole AudioMuse-AI database | get_db |
| Create its own tables | table() + on_install |
| React to every analyzed song (run your own model) | on_song_analyzed |
| Run scheduled cron tasks on the worker | add_cron_task |
| Run background jobs from a page | enqueue |
| Create playlists on your media server | tasks.mediaserver |
| Use extra pip packages, with version pins (container image only) | requirements in plugin.json |
| Publish, update and roll back through a catalog | the community repository |
Install, update, enable, disable and uninstall all happen from the Plugins page in the app. A broken plugin can never stop AudioMuse-AI from starting.
Start here
- Documentation and full guide: docs/PLUGIN.md
- Plugin catalog and the SongCounter reference plugin: https://github.com/NeptuneHub/AudioMuse-AI-plugins
Build something, publish it, and share it with us.
What's Changed
- Navidrome first in documentation by @NeptuneHub in #717
- TZ on redis and postgresql deployment - #716 by @NeptuneHub in #718
- Cron schedule fix - #719 by @NeptuneHub in #720
- Plugin Support by @NeptuneHub in #721
Full Changelog: v2.5.0...v2.6.0
