From 68be4e199c630b5b383caab9788cea618cc0fcd6 Mon Sep 17 00:00:00 2001
From: Marvin Schenkel <marvinschenkel@gmail.com>
Date: Sun, 31 May 2026 14:52:44 +0200
Subject: [PATCH 1/3] Declutter album track list

Reduce redundant information on the album detail track list:

- Subtitle now shows only collaborating artists ("with X"), dropping the
  album artist/name/year that is already in the page header.
- Track number moves to a left gutter; the per-row album art is replaced
  by a play button (the album art is shown in the header).
- Duration is right-aligned before the provider icon and hidden on mobile
  to give the title more room.
- Multi-disc albums get "Disc X" section headers (default track order only).
- Track titles wrap to two lines instead of truncating.
---
 src/components/ItemsListing.vue      |  47 +++++++++++-
 src/components/ListviewItem.vue      | 106 ++++++++++++++++++++++++++-
 src/components/ListviewItemTitle.vue |  18 ++++-
 src/translations/en.json             |   2 +
 4 files changed, 167 insertions(+), 6 deletions(-)

diff --git a/src/components/ItemsListing.vue b/src/components/ItemsListing.vue
index d2e6007a4..224ff69d1 100644
--- a/src/components/ItemsListing.vue
+++ b/src/components/ItemsListing.vue
@@ -129,12 +129,17 @@
           v-if="viewMode == 'list'"
           :item-height="70"
           height="100%"
-          :items="pagedItems"
+          :items="listDisplayItems"
           style="height: 100%; overflow: hidden"
         >
           <template #default="{ item }">
+            <div v-if="'isDiscHeader' in item" class="disc-header">
+              {{ $t("disc", { number: item.disc }) }}
+            </div>
             <ListviewItem
+              v-else
               :item="item"
+              :album-track-view="itemtype === 'albumtracks'"
               :show-track-number="showTrackNumber"
               :show-disc-number="showTrackNumber"
               :show-duration="showDuration"
@@ -384,6 +389,36 @@ const initialDataReceived = ref(false);
 const tempHide = ref(false);
 const genreOptions = ref<{ label: string; value: number }[]>([]);
 
+interface DiscHeader {
+  isDiscHeader: true;
+  disc: number;
+}
+
+const discNumber = (i: MediaItemType) =>
+  "disc_number" in i ? i.disc_number : undefined;
+
+// for multi-disc albums (in default track order), insert a "Disc X" header
+// before the first track of each disc.
+const listDisplayItems = computed<(MediaItemType | DiscHeader)[]>(() => {
+  const multiDisc =
+    props.itemtype === "albumtracks" &&
+    allItems.value.some((i) => (discNumber(i) ?? 0) > 1);
+  if (!multiDisc || params.value.sortBy !== "track_number") {
+    return pagedItems.value;
+  }
+  const result: (MediaItemType | DiscHeader)[] = [];
+  let lastDisc: number | undefined;
+  for (const item of pagedItems.value) {
+    const disc = discNumber(item);
+    if (disc && disc !== lastDisc) {
+      result.push({ isDiscHeader: true, disc });
+      lastDisc = disc;
+    }
+    result.push(item);
+  }
+  return result;
+});
+
 // methods
 const applyQueryGenreFilter = function () {
   const queryGenre = route.query.genre_id ?? route.query.genre_ids;
@@ -1710,6 +1745,16 @@ defineExpose({
 </script>
 
 <style scoped>
+.disc-header {
+  display: flex;
+  align-items: flex-end;
+  height: 100%;
+  padding: 16px 8px 8px;
+  font-size: 1.15rem;
+  font-weight: 600;
+  opacity: 0.7;
+}
+
 /* ThumbView panel columns */
 .col-2 {
   width: 50%;
diff --git a/src/components/ListviewItem.vue b/src/components/ListviewItem.vue
index 7a4a574ab..515cfe308 100644
--- a/src/components/ListviewItem.vue
+++ b/src/components/ListviewItem.vue
@@ -28,8 +28,34 @@
           />
         </label>
       </div>
-      <div v-else class="media-thumb listitem-media-thumb">
-        <MediaItemThumb size="50" :item="isAvailable ? item : undefined" />
+      <div v-else class="listitem-prepend">
+        <div
+          v-if="
+            albumTrackView &&
+            showTrackNumber &&
+            'track_number' in item &&
+            item.track_number
+          "
+          class="track-number"
+        >
+          {{ item.track_number }}
+        </div>
+        <div
+          v-if="albumTrackView && item.is_playable"
+          class="listitem-play-thumb"
+        >
+          <v-btn
+            icon
+            variant="text"
+            :disabled="disablePlayButton"
+            @click.stop="onPlayClick"
+          >
+            <v-icon size="24">mdi-play-circle-outline</v-icon>
+          </v-btn>
+        </div>
+        <div v-else class="media-thumb listitem-media-thumb">
+          <MediaItemThumb size="50" :item="isAvailable ? item : undefined" />
+        </div>
       </div>
     </template>
 
@@ -40,14 +66,23 @@
         :item="item"
         :show-checkboxes="showCheckboxes"
         :is-playing="isPlaying"
+        :album-track-view="albumTrackView"
       />
     </template>
 
     <!-- subtitle -->
     <template #subtitle>
+      <!-- album track view: only show collaborating artist(s), if any -->
+      <div v-if="albumTrackView" class="ma-line-clamp-1">
+        <span v-if="collabArtists">{{
+          $t("with_artists", { artists: collabArtists })
+        }}</span>
+      </div>
       <!-- track: artists(s) + album (check for provider_mappings to filter out ItemMapping) -->
       <div
-        v-if="item.media_type == MediaType.TRACK && 'provider_mappings' in item"
+        v-else-if="
+          item.media_type == MediaType.TRACK && 'provider_mappings' in item
+        "
         class="ma-line-clamp-1"
       >
         <v-item-group>
@@ -148,6 +183,19 @@
         </v-tooltip>
       </v-img>
 
+      <!-- track duration (album track view) -->
+      <span
+        v-if="
+          albumTrackView &&
+          'duration' in item &&
+          item.duration &&
+          !$vuetify.display.mobile
+        "
+        class="track-duration"
+      >
+        {{ formatDuration(item.duration) }}
+      </span>
+
       <!-- provider icon -->
       <provider-icon
         v-if="getBreakpointValue('bp2') && showProvider"
@@ -186,7 +234,11 @@
 
       <!-- play button -->
       <v-btn
-        v-if="item.is_playable && (showPlayButton ?? getBreakpointValue('bp0'))"
+        v-if="
+          !albumTrackView &&
+          item.is_playable &&
+          (showPlayButton ?? getBreakpointValue('bp0'))
+        "
         icon
         variant="text"
         size="small"
@@ -232,6 +284,7 @@ import ListviewItemTitle from "./ListviewItemTitle.vue";
 // properties
 export interface Props {
   item: MediaItemType;
+  albumTrackView?: boolean;
   showTrackNumber?: boolean;
   showDiscNumber?: boolean;
   showPosition?: boolean;
@@ -268,6 +321,7 @@ const displayName = computed(() => {
 });
 
 const compProps = withDefaults(defineProps<Props>(), {
+  albumTrackView: false,
   showTrackNumber: true,
   showDiscNumber: true,
   showProvider: true,
@@ -285,6 +339,19 @@ const compProps = withDefaults(defineProps<Props>(), {
 });
 
 // computed properties
+const collabArtists = computed(() => {
+  if (!("artists" in compProps.item) || !compProps.item.artists) return "";
+  const albumArtists =
+    compProps.parentItem && "artists" in compProps.parentItem
+      ? compProps.parentItem.artists
+      : [];
+  const albumNames = new Set(albumArtists.map((a) => a.name.toLowerCase()));
+  const collab = compProps.item.artists.filter(
+    (a) => !albumNames.has(a.name.toLowerCase()),
+  );
+  return collab.map((a) => a.name).join(" | ");
+});
+
 const HiResDetails = computed(() => {
   if (!("provider_mappings" in compProps.item)) return "";
   for (const prov of compProps.item.provider_mappings) {
@@ -365,6 +432,37 @@ const onPlayClick = function (evt: PointerEvent) {
   opacity: 0.3;
 }
 
+.listitem-prepend {
+  display: flex;
+  align-items: center;
+}
+
+.listitem-play-thumb {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 50px;
+  height: 50px;
+}
+
+.track-number {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 22px;
+  margin-right: 2px;
+  font-size: 0.875rem;
+  opacity: 0.7;
+  font-variant-numeric: tabular-nums;
+}
+
+.track-duration {
+  font-size: 0.875rem;
+  opacity: 0.7;
+  margin-right: 12px;
+  white-space: nowrap;
+}
+
 .dimmed {
   opacity: 0.3;
 }
diff --git a/src/components/ListviewItemTitle.vue b/src/components/ListviewItemTitle.vue
index bf080de87..bcf1e8b5e 100644
--- a/src/components/ListviewItemTitle.vue
+++ b/src/components/ListviewItemTitle.vue
@@ -8,7 +8,11 @@
   </span>
   <span
     v-else
-    :class="{ 'is-playing': isPlaying, 'checkbox-label': showCheckboxes }"
+    :class="{
+      'is-playing': isPlaying,
+      'checkbox-label': showCheckboxes,
+      'album-track-title': albumTrackView,
+    }"
     class="v-list-item-title"
   >
     {{ displayName }}
@@ -61,6 +65,7 @@ export interface Props {
   item: MediaItemType;
   showCheckboxes: boolean;
   isPlaying: boolean;
+  albumTrackView?: boolean;
 }
 
 // global refs
@@ -70,6 +75,7 @@ withDefaults(defineProps<Props>(), {
   displayName: "",
   showCheckboxes: false,
   isPlaying: false,
+  albumTrackView: false,
 });
 </script>
 
@@ -78,6 +84,16 @@ withDefaults(defineProps<Props>(), {
   margin-left: 23px;
 }
 
+.album-track-title {
+  font-size: 0.9375rem;
+  font-weight: 500;
+  white-space: normal;
+  overflow: hidden;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+}
+
 /* When checkbox is displayed, explicit icon will be shown to the right of the title.
    This adds a bit of spacing between the title and the explicit icon. */
 .explicit-icon-margin-left {
diff --git a/src/translations/en.json b/src/translations/en.json
index 64308c315..9d91f50f8 100644
--- a/src/translations/en.json
+++ b/src/translations/en.json
@@ -856,6 +856,7 @@
     "try_global_search": "Try global search",
     "type_to_search": "Type here to search...",
     "volume_normalization": "Volume normalization",
+    "with_artists": "with {artists}",
     "play_now_replace": "Play Now (clear queue)",
     "currently_playing": "Currently playing",
     "favorites_add": "Add to favorites",
@@ -1245,6 +1246,7 @@
     "series_singular": "Series",
     "queue_move_end": "Move to end",
     "discover": "Discover",
+    "disc": "Disc {number}",
     "save_queue_as_playlist": "Save queue as playlist",
     "playlist_created": "Playlist created",
     "open_playlist": "Open playlist",

From 57e81a215eec64f2bad0c79b2c37cb063b6d4430 Mon Sep 17 00:00:00 2001
From: Marvin Schenkel <marvinschenkel@gmail.com>
Date: Mon, 1 Jun 2026 13:40:05 +0200
Subject: [PATCH 2/3] Fix Explicit icon wrapping to the next line.

---
 src/components/ListviewItemTitle.vue | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/components/ListviewItemTitle.vue b/src/components/ListviewItemTitle.vue
index bcf1e8b5e..aa50b2321 100644
--- a/src/components/ListviewItemTitle.vue
+++ b/src/components/ListviewItemTitle.vue
@@ -29,7 +29,11 @@
   >
     <Tooltip>
       <TooltipTrigger as-child>
-        <span :aria-label="t('tooltip.explicit')" tabindex="0">
+        <span
+          :aria-label="t('tooltip.explicit')"
+          tabindex="0"
+          :class="{ 'explicit-icon-align': albumTrackView }"
+        >
           <v-icon
             :class="{ 'explicit-icon-margin-left': showCheckboxes }"
             icon="mdi-alpha-e-box"
@@ -89,9 +93,17 @@ withDefaults(defineProps<Props>(), {
   font-weight: 500;
   white-space: normal;
   overflow: hidden;
-  display: -webkit-box;
+  display: -webkit-inline-box;
   -webkit-line-clamp: 2;
   -webkit-box-orient: vertical;
+  vertical-align: middle;
+}
+
+/* Vertically center the explicit icon against the title in the album track view. */
+.explicit-icon-align {
+  display: inline-flex;
+  vertical-align: middle;
+  margin-left: 12px;
 }
 
 /* When checkbox is displayed, explicit icon will be shown to the right of the title.

From 9234f29a6adcf3c3af3e1bdba9b9c8c2e03374b4 Mon Sep 17 00:00:00 2001
From: stvncode <steven.travers20@gmail.com>
Date: Tue, 2 Jun 2026 16:50:05 +0200
Subject: [PATCH 3/3] reviews

---
 src/components/ListviewItem.vue | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/components/ListviewItem.vue b/src/components/ListviewItem.vue
index 515cfe308..ecacdc16c 100644
--- a/src/components/ListviewItem.vue
+++ b/src/components/ListviewItem.vue
@@ -73,11 +73,11 @@
     <!-- subtitle -->
     <template #subtitle>
       <!-- album track view: only show collaborating artist(s), if any -->
-      <div v-if="albumTrackView" class="ma-line-clamp-1">
-        <span v-if="collabArtists">{{
-          $t("with_artists", { artists: collabArtists })
-        }}</span>
-      </div>
+      <template v-if="albumTrackView">
+        <div v-if="collabArtists" class="ma-line-clamp-1">
+          {{ $t("with_artists", { artists: collabArtists }) }}
+        </div>
+      </template>
       <!-- track: artists(s) + album (check for provider_mappings to filter out ItemMapping) -->
       <div
         v-else-if="
@@ -187,6 +187,7 @@
       <span
         v-if="
           albumTrackView &&
+          showDuration &&
           'duration' in item &&
           item.duration &&
           !$vuetify.display.mobile