UnicornsOnLSD/finamp

Algorithmic Playlist Creation ("Sonic Analysis" / AudioMuse)

Open

#1268 opened on Jun 20, 2025

View on GitHub
 (11 comments) (2 reactions) (0 assignees)Dart (3,934 stars) (268 forks)batch import
featurehelp wantedserver issueupstream issue

Description

Type:

  • New feature
  • Improve or extend an existing feature
  • Other:

Explanation

The idea is to have the possibility of song analysis for tempo, energy, mood and genre and then automatically create plays list.

The analysis can be done server side in batch with Essentia-Tensorflow plugin. The playlist creation can be done with clustering algorithm or with the support of the AI that automatically generate the query on the analysis database based on the user request.

Reasoning

For user that have a lot of song create the playlist manually can be boring. So the support of clustering or AI could be an improvement.

Implementation Notes

I already have a batch application with a Minimum’s Viable front-end here: https://github.com/NeptuneHub/AudioMuse-AI

It all open source and self-host able. What is missing is an usable production ready front-end, and an integration in finamp will be wonderful.

Contributor guide

Tech stack
dartflutter
Domain
mobile
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
5
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
needs investigation
Prerequisites
Flutter developmentaudio analysis conceptsclustering algorithmsREST API integration
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
15
Research direction
Examine the current playlist creation flow in finamp (e.g., playlist screen.dart and associated state management). Explore how the app communicates with Jellyfin for music metadata. Review the AudioMuse AI repository to understand its REST API endpoints for song analysis and clustering. Investigate the networking setup in finamp (likely using Dio) to plan integration of new API calls.