From dcb27e2a4fb39f3eefc92bbc9e3c7cc2fc17b4d2 Mon Sep 17 00:00:00 2001
From: Jozef Kruszynski <jozef+github@krush.at>
Date: Sat, 7 Mar 2026 23:43:39 +0100
Subject: [PATCH 1/2] feat(genres): add genre exclusions for media items

---
 src/components/InfoHeader.vue                 |  35 +++++
 src/components/ProviderDetails.vue            |   9 ++
 .../genre/GenreExclusionManager.vue           | 139 ++++++++++++++++++
 src/plugins/api/index.ts                      |  34 +++++
 src/plugins/eventbus.ts                       |   1 +
 src/translations/en.json                      |   3 +
 6 files changed, 221 insertions(+)
 create mode 100644 src/components/genre/GenreExclusionManager.vue

diff --git a/src/components/InfoHeader.vue b/src/components/InfoHeader.vue
index e78a204c9..7fd6c9c6a 100644
--- a/src/components/InfoHeader.vue
+++ b/src/components/InfoHeader.vue
@@ -377,6 +377,9 @@
               outlined
               class="cursor-pointer"
               @click="handleMediaItemClick(genre, 0, 0)"
+              @contextmenu.prevent="
+                (e: MouseEvent) => showGenreChipContextMenu(e, genre)
+              "
             >
               {{
                 getGenreDisplayName(genre.name, genre.translation_key, t, te)
@@ -506,6 +509,38 @@ watch(
   { immediate: true },
 );
 
+const showGenreChipContextMenu = (evt: MouseEvent, genre: Genre) => {
+  if (
+    !compProps.item ||
+    !isAdmin.value ||
+    compProps.item.provider !== "library"
+  )
+    return;
+  const mediaItem = compProps.item;
+  const menuItems: ContextMenuItem[] = [
+    {
+      label: "exclude_genre",
+      icon: "mdi-cancel",
+      action: async () => {
+        await api.excludeGenreFromItem(
+          genre.item_id,
+          mediaItem.media_type,
+          mediaItem.item_id,
+        );
+        mappedGenres.value = mappedGenres.value.filter(
+          (g) => g.item_id !== genre.item_id,
+        );
+        eventbus.emit("genreExcluded");
+      },
+    },
+  ];
+  eventbus.emit("contextmenu", {
+    items: menuItems,
+    posX: evt.clientX,
+    posY: evt.clientY,
+  });
+};
+
 const albumClick = function (item: Album | ItemMapping) {
   // album entry clicked
   router.push({
diff --git a/src/components/ProviderDetails.vue b/src/components/ProviderDetails.vue
index e6a8b5eff..9f119d7d4 100644
--- a/src/components/ProviderDetails.vue
+++ b/src/components/ProviderDetails.vue
@@ -125,10 +125,19 @@
       </v-list>
     </Container>
   </section>
+  <GenreExclusionManager
+    v-if="
+      itemDetails.provider === 'library' &&
+      itemDetails.media_type !== MediaType.GENRE
+    "
+    :media-type="itemDetails.media_type"
+    :media-id="itemDetails.item_id"
+  />
 </template>
 
 <script setup lang="ts">
 import Container from "@/components/Container.vue";
+import GenreExclusionManager from "@/components/genre/GenreExclusionManager.vue";
 import ListItem from "@/components/ListItem.vue";
 import ProviderIcon from "@/components/ProviderIcon.vue";
 import { iconHiRes } from "@/components/QualityDetailsBtn.vue";
diff --git a/src/components/genre/GenreExclusionManager.vue b/src/components/genre/GenreExclusionManager.vue
new file mode 100644
index 000000000..4a8920484
--- /dev/null
+++ b/src/components/genre/GenreExclusionManager.vue
@@ -0,0 +1,139 @@
+<template>
+  <section v-if="isAdmin" style="margin-bottom: 10px">
+    <Toolbar
+      :title="exclusionTitle"
+      :menu-items="toolbarMenuItems"
+      @title-clicked="toggleSection"
+    />
+    <v-divider />
+    <Container v-if="sectionExpanded">
+      <v-list>
+        <ListItem
+          v-for="genre in exclusions"
+          :key="genre.item_id"
+          show-menu-btn
+          @menu.stop="(evt) => onMenu(evt, genre)"
+        >
+          <template #prepend>
+            <div
+              style="
+                width: 30px;
+                margin-left: 10px;
+                margin-right: 10px;
+                display: flex;
+                align-items: center;
+              "
+            >
+              <Compass :size="30" />
+            </div>
+          </template>
+          <template #title>{{
+            getGenreDisplayName(genre.name, genre.translation_key, t, te)
+          }}</template>
+        </ListItem>
+      </v-list>
+    </Container>
+  </section>
+</template>
+
+<script setup lang="ts">
+import Container from "@/components/Container.vue";
+import ListItem from "@/components/ListItem.vue";
+import Toolbar, { ToolBarMenuItem } from "@/components/Toolbar.vue";
+import { getGenreDisplayName } from "@/helpers/utils";
+import { api } from "@/plugins/api";
+import { Genre, MediaType } from "@/plugins/api/interfaces";
+import { authManager } from "@/plugins/auth";
+import { eventbus } from "@/plugins/eventbus";
+import { computed, onBeforeUnmount, onMounted, ref, watch } from "vue";
+import { useI18n } from "vue-i18n";
+import { Compass, ChevronUp, ChevronDown } from "lucide-vue-next";
+
+interface Props {
+  mediaType: MediaType;
+  mediaId: string;
+}
+
+const props = defineProps<Props>();
+
+const { t, te } = useI18n();
+
+const isAdmin = computed(() => authManager.isAdmin());
+const sectionExpanded = ref(false);
+const operationInProgress = ref(false);
+const exclusions = ref<Genre[]>([]);
+
+const exclusionTitle = computed(
+  () => `${t("genre_exclusions")} (${exclusions.value.length})`,
+);
+
+const toolbarMenuItems = computed<ToolBarMenuItem[]>(() => [
+  {
+    label: "tooltip.collapse_expand",
+    icon: sectionExpanded.value ? ChevronUp : ChevronDown,
+    action: toggleSection,
+    overflowAllowed: false,
+  },
+]);
+
+const loadExclusions = async () => {
+  try {
+    exclusions.value = await api.getGenreExclusionsForItem(
+      props.mediaType,
+      props.mediaId,
+    );
+  } catch {
+    exclusions.value = [];
+  }
+};
+
+const removeExclusion = async (genre: Genre) => {
+  operationInProgress.value = true;
+  try {
+    await api.removeGenreExclusion(
+      genre.item_id,
+      props.mediaType,
+      props.mediaId,
+    );
+    exclusions.value = exclusions.value.filter(
+      (g) => g.item_id !== genre.item_id,
+    );
+  } finally {
+    operationInProgress.value = false;
+  }
+};
+
+const onMenu = (evt: Event, genre: Genre) => {
+  const mouseEvt = evt as MouseEvent;
+  eventbus.emit("contextmenu", {
+    items: [
+      {
+        label: t("remove_genre_exclusion"),
+        icon: "mdi-delete",
+        action: () => removeExclusion(genre),
+        disabled: operationInProgress.value,
+      },
+    ],
+    posX: mouseEvt.clientX,
+    posY: mouseEvt.clientY,
+  });
+};
+
+const toggleSection = () => {
+  sectionExpanded.value = !sectionExpanded.value;
+};
+
+onMounted(() => {
+  loadExclusions();
+  eventbus.on("genreExcluded", loadExclusions);
+});
+
+onBeforeUnmount(() => {
+  eventbus.off("genreExcluded", loadExclusions);
+});
+
+watch(
+  () => props.mediaId,
+  () => loadExclusions(),
+);
+</script>
diff --git a/src/plugins/api/index.ts b/src/plugins/api/index.ts
index ee45791bb..206c92858 100644
--- a/src/plugins/api/index.ts
+++ b/src/plugins/api/index.ts
@@ -1033,6 +1033,40 @@ export class MusicAssistantApi {
     });
   }
 
+  public excludeGenreFromItem(
+    genre_id: string,
+    media_type: string,
+    media_id: string,
+  ): Promise<void> {
+    return this.sendCommand("music/genres/exclude_genre_from_media_item", {
+      genre_id,
+      media_type,
+      media_id,
+    });
+  }
+
+  public removeGenreExclusion(
+    genre_id: string,
+    media_type: string,
+    media_id: string,
+  ): Promise<void> {
+    return this.sendCommand("music/genres/remove_genre_exclusion", {
+      genre_id,
+      media_type,
+      media_id,
+    });
+  }
+
+  public getGenreExclusionsForItem(
+    media_type: string,
+    media_id: string,
+  ): Promise<Genre[]> {
+    return this.sendCommand("music/genres/genre_exclusions_for_media_item", {
+      media_type,
+      media_id,
+    });
+  }
+
   public async getGenreOverviewRows(
     item_id: string,
     provider_instance_id_or_domain: string,
diff --git a/src/plugins/eventbus.ts b/src/plugins/eventbus.ts
index baaaa8f80..92b5440f7 100644
--- a/src/plugins/eventbus.ts
+++ b/src/plugins/eventbus.ts
@@ -43,6 +43,7 @@ export type Events = {
   deleteGenreDialog: DeleteGenreDialogEvent;
   linkGenreDialog: LinkGenreDialogEvent;
   clearSelection: void;
+  genreExcluded: void;
   "homescreen-edit-toggle": void;
   "mobile-sidebar-open": void;
 };
diff --git a/src/translations/en.json b/src/translations/en.json
index 353763dbe..e002e1cd7 100644
--- a/src/translations/en.json
+++ b/src/translations/en.json
@@ -317,6 +317,9 @@
     "remove": "Remove",
     "remove_alias": "Remove alias",
     "remove_alias_failed": "Failed to remove alias",
+    "exclude_genre": "Exclude genre",
+    "genre_exclusions": "Genre Exclusions",
+    "remove_genre_exclusion": "Remove exclusion",
     "remove_library": "Remove from library",
     "remove_playlist": "Remove from playlist",
     "search": "Search",

From e2b5a46f0f5be10626f7a63c2b3c1c54c0658ed0 Mon Sep 17 00:00:00 2001
From: Jozef Kruszynski <jozef+github@krush.at>
Date: Tue, 10 Mar 2026 19:27:51 +0100
Subject: [PATCH 2/2] fix(genres): remove unnecessary double translation

---
 src/components/genre/GenreExclusionManager.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/genre/GenreExclusionManager.vue b/src/components/genre/GenreExclusionManager.vue
index 4a8920484..79e29d60b 100644
--- a/src/components/genre/GenreExclusionManager.vue
+++ b/src/components/genre/GenreExclusionManager.vue
@@ -108,7 +108,7 @@ const onMenu = (evt: Event, genre: Genre) => {
   eventbus.emit("contextmenu", {
     items: [
       {
-        label: t("remove_genre_exclusion"),
+        label: "remove_genre_exclusion",
         icon: "mdi-delete",
         action: () => removeExclusion(genre),
         disabled: operationInProgress.value,