feat(genres): Genre frontend implementation by jozefKruszynski · Pull Request #1459 · music-assistant/frontend

jozefKruszynski · 2026-02-14T17:03:17Z

PR: Genre V2 Frontend Implementation

Branch: feat/genres-v2-implementation
Base: main
Build: Passes
Lint: Passes

Summary

Complete frontend implementation for the Genre V2 system. Introduces first-class genre and alias management with the relational model: Genre -> Aliases -> Media Items.

Genre library view with search, filtering, sorting, and view modes
Genre detail page with overview rows and alias management (admin)
Full CRUD API integration for genres and aliases
Genre-based filtering across all media library views
Global search integration
Genre management settings page with default restore/reset
59 pre-translated genre display names
Self-alias protection and alias-to-genre promotion

New Files

`src/views/GenreDetails.vue`

Genre detail page:

Overview rows from getGenreOverviewRows — artists, albums, tracks, etc. with "see all" navigation to filtered library views
Alias management (admin only):
- Link existing alias (autocomplete search dialog)
- Create and link new alias
- Unlink alias (no confirmation, reversible)
- Delete alias (confirmation dialog, permanent)
- Promote alias to standalone genre (confirmation, navigates to new genre)
Self-alias protection — aliases matching an existing genre name hide promote/delete buttons
Alias chips in header with overflow popover
Fallback to radio base tracks if no overview data

`src/views/LibraryGenres.vue`

Genre library listing:

Standard ItemsListing integration (list/panel/compact view modes)
Alias-aware search — also queries aliases, includes parent genres in results (deduplicated)
Sort: name, sort_name, timestamp_added, play_count (asc/desc)
Provider and favorites filtering
Admin menu: add genre, add alias
Auto-refresh on MEDIA_ITEM_ADDED events

`src/components/AddGenreAliasDialog.vue`

Reusable dialog for creating genres or aliases:

type prop: MediaType.GENRE or MediaType.GENRE_ALIAS
Fields: name, sort_name, description

`src/views/settings/GenreManagement.vue`

Genre management settings page (admin only):

Header card with icon and description
Genre statistics (total count)
Restore Missing Defaults — adds missing default genres without affecting existing data (single confirmation)
Full Restore (Reset All) — deletes all genres/aliases and recreates defaults (double confirmation)
"View All Genres" navigation to library

API Layer (`src/plugins/api/index.ts`)

Genre Endpoints

Method	Endpoint	Description
`getLibraryGenresCount()`	`music/genres/count`	Total genre count
`getLibraryGenres()`	`music/genres/library_items`	List with search/filter/pagination
`getGenre()`	`music/genres/get`	Get by ID + provider
`addGenreToLibrary()`	`music/genres/add`	Create genre
`removeGenreFromLibrary()`	`music/genres/remove`	Delete genre
`getGenreOverviewRows()`	`music/genres/overview`	Recommendation folders
`getGenreRadioBaseTracks()`	`music/genres/radio_mode_base_tracks`	Radio tracks
`restoreGenreDefaults()`	`music/genres/restore_defaults`	Restore default genres

Alias Endpoints

Method	Endpoint	Description
`getLibraryAliases()`	`music/aliases/library_items`	List with search/filter
`addAliasToLibrary()`	`music/aliases/add`	Create alias
`removeAliasFromLibrary()`	`music/aliases/remove`	Delete alias

Relationship Endpoints

Method	Endpoint	Description
`addAliasToGenre()`	`music/genres/add_alias_mapping`	Link alias to genre
`removeAliasFromGenre()`	`music/genres/remove_alias_mapping`	Unlink alias from genre
`promoteAliasToGenre()`	`music/aliases/promote_to_genre`	Promote alias to genre

Genre Filtering on Existing Endpoints

Added genre_ids parameter to: getLibraryArtists, getLibraryAlbums, getLibraryTracks, getLibraryPlaylists, getLibraryRadios, getLibraryAudiobooks, getLibraryPodcasts.

stvncode

This is really awesome! Sorry for all my comments, they are mainly for ui lib, toast error and file refactor, otherwise, nothing to say 😃
Don't hesitate to ping me for some changes, happy to help if needed!

src/components/AddGenreAliasDialog.vue

src/views/GenreDetails.vue

src/helpers/utils.ts

src/components/ItemsListing.vue

src/views/settings/GenreManagement.vue

src/views/GenreDetails.vue

jozefKruszynski · 2026-02-16T20:10:59Z

I'll do some refactoring 😃

jozefKruszynski · 2026-02-16T22:17:21Z

@stvncode I refactored into smaller components and migrated all code to shadcn-vue.

stvncode · 2026-02-17T15:32:46Z

@jozefKruszynski Ok done. I replaced ui components, refactored some comps that were a bit big and also make the genre list refresh after a delete or an addition.
Regarding the code, i have nothing to say anymore (you can have a look at my change for the ui if they are good for you).
One more thing, regarding the action to create an alias in the genre page, do you think it's useful ? We already have the action in genre details and creating an alias in the genre page feels weird as a user since nothing is happening on the screen, this is just a suggestion ofc 😃

jozefKruszynski · 2026-02-17T15:36:35Z

Thanks for putting in the time
I think you're right about adding an alias on the genres page, we should remove that as it actually serves to confuse things.

github-actions · 2026-02-17T16:07:39Z

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

Package

Version

Score

Details

npm/@vueuse/core

14.2.0

🟢 5.2

Details

Check	Score	Reason
Code-Review	🟢 8	Found 24/30 approved changesets -- score normalized to 8
Dangerous-Workflow	🟢 10	no dangerous workflow patterns detected
Maintained	🟢 10	30 commit(s) and 12 issue activity found in the last 90 days -- score normalized to 10
Packaging	⚠️ -1	packaging workflow not detected
CII-Best-Practices	⚠️ 0	no effort to earn an OpenSSF best practices badge detected
Security-Policy	⚠️ 0	security policy file not detected
License	🟢 10	license file detected
Token-Permissions	⚠️ 0	detected GitHub workflow tokens with excessive permissions
Branch-Protection	⚠️ -1	internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
Binary-Artifacts	🟢 10	no binaries found in the repo
Signed-Releases	⚠️ -1	no releases found
Pinned-Dependencies	⚠️ 0	dependency not pinned by hash detected -- score normalized to 0
Fuzzing	⚠️ 0	project is not fuzzed
SAST	⚠️ 0	SAST tool is not run on all commits -- score normalized to 0

Scanned Files

yarn.lock

stvncode

Code is good ✅
@marcelveldt @MarvinSchenkel, if you want to double check the ui/ux

jozefKruszynski · 2026-02-19T19:06:33Z

@stvncode Please could you give this another once over as there have been some quite significant changes. I think I also might have screwed up the immediate refresh of some things, either that or my browser cache is just being particularly stubborn

stvncode

I removed some any but except for that, it's really nice! One thing, when arriving in a track page, i have this error:

Also, i don't see the genre menu button in the sidebar 🤔

jozefKruszynski · 2026-02-22T13:50:14Z

I removed some any but except for that, it's really nice! One thing, when arriving in a track page, i have this error:

I'll double check, sorry about that.

EDIT: Looks like my rebase didn't actually get pushed 🤦‍♂️

jozefKruszynski · 2026-02-22T14:00:18Z

@stvncode
I just pushed the rebased version. FYI backend was already merged into dev so if you pull the latest server code dev branch and then pull the latest changes from this branch, things should then all work as expected.

stvncode · 2026-02-22T14:15:57Z

@jozefKruszynski ok thanks, i had just pulled your be pr but on dev it works better! But i still have two errors on link alias and add alias:

jozefKruszynski · 2026-02-22T14:16:31Z

I'll get right on it

jozefKruszynski · 2026-02-22T14:20:20Z

Both actions work fine for me, perhaps the DB migratio did not complete properly in the backend

jozefKruszynski · 2026-02-22T14:20:58Z

Which in itself is not good, do you have a backup of your .music_assistant folder?

jozefKruszynski added new-feature Waiting on backend labels Feb 14, 2026

jozefKruszynski assigned marcelveldt, MarvinSchenkel and stvncode and unassigned marcelveldt, MarvinSchenkel and stvncode Feb 14, 2026

jozefKruszynski requested review from MarvinSchenkel, marcelveldt and stvncode February 15, 2026 19:40

stvncode reviewed Feb 16, 2026

View reviewed changes

jozefKruszynski requested a review from stvncode February 16, 2026 22:18

stvncode force-pushed the feat/genres-v2-implementation branch from d47f205 to 6fafc66 Compare February 17, 2026 16:07

stvncode previously approved these changes Feb 17, 2026

View reviewed changes

stvncode marked this pull request as ready for review February 17, 2026 16:10

jozefKruszynski dismissed stvncode’s stale review via a00f110 February 18, 2026 14:01

jozefKruszynski requested a review from stvncode February 19, 2026 19:03

MarvinSchenkel removed the Waiting on backend label Feb 20, 2026

stvncode reviewed Feb 22, 2026

View reviewed changes

stvncode force-pushed the feat/genres-v2-implementation branch from da622f9 to 53605dd Compare February 22, 2026 13:52

jozefKruszynski added 2 commits February 22, 2026 14:58

feat(genres): Genre frontend implementation

92ee2c0

feat(genres): fix search and row links, add scannner details

89ee5a3

jozefKruszynski and others added 9 commits February 22, 2026 14:58

refactor(genres): use shadcn and refactor into smaller components

ebf969f

small refactor

61d8bc5

refactor genre management

ffbd624

remove alias dialog in genre page

565ab84

rebase

7445ad2

refactor(genres): update GenreAlias model and api params

cd93ac2

refactor(genres): remove alias model

039b4ea

feat(genres): use genre api for infoheader chips

c1b7a40

style(genres): linting

c888cb8

jozefKruszynski force-pushed the feat/genres-v2-implementation branch from 53605dd to c888cb8 Compare February 22, 2026 13:58

fix(genres): update en.json

18f87ef

Uh oh!

Comments

Conversation

jozefKruszynski commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR: Genre V2 Frontend Implementation

Summary

New Files

src/views/GenreDetails.vue

src/views/LibraryGenres.vue

src/components/AddGenreAliasDialog.vue

src/views/settings/GenreManagement.vue

API Layer (src/plugins/api/index.ts)

Genre Endpoints

Alias Endpoints

Relationship Endpoints

Genre Filtering on Existing Endpoints

Uh oh!

stvncode left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jozefKruszynski commented Feb 16, 2026

Uh oh!

jozefKruszynski commented Feb 16, 2026

Uh oh!

stvncode commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jozefKruszynski commented Feb 17, 2026

Uh oh!

github-actions bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Dependency Review

OpenSSF Scorecard

Scanned Files

Uh oh!

stvncode left a comment

Choose a reason for hiding this comment

Uh oh!

jozefKruszynski commented Feb 19, 2026

Uh oh!

stvncode left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jozefKruszynski commented Feb 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jozefKruszynski commented Feb 22, 2026

Uh oh!

stvncode commented Feb 22, 2026

Uh oh!

jozefKruszynski commented Feb 22, 2026

Uh oh!

jozefKruszynski commented Feb 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jozefKruszynski commented Feb 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jozefKruszynski commented Feb 14, 2026 •

edited

Loading

`src/views/GenreDetails.vue`

`src/views/LibraryGenres.vue`

`src/components/AddGenreAliasDialog.vue`

`src/views/settings/GenreManagement.vue`

API Layer (`src/plugins/api/index.ts`)

stvncode left a comment •

edited

Loading

stvncode commented Feb 17, 2026 •

edited

Loading

github-actions bot commented Feb 17, 2026 •

edited

Loading

stvncode left a comment •

edited

Loading

jozefKruszynski commented Feb 22, 2026 •

edited

Loading

jozefKruszynski commented Feb 22, 2026 •

edited

Loading

jozefKruszynski commented Feb 22, 2026 •

edited

Loading