Changelog

---

This release introduces a redesigned settings interface and a unified interface selector for choosing your active Tuneful interface. Under the hood, a large portion of the codebase has been refactored and streamlined to improve performance and stability. This version of Tuneful now requires macOS 14.0 or later.

New features

• Brand new settings interface
• Added new unified music interface selector to general settings

General Improvements

• Refactored implementation with Spotify and Apple Music APIs
• Some of the dependecies were removed or written from scratch
• Improved shadow rendering on the notch
• Improved notch notification view
• Updated dark mode icon for macOS Tahoe

Bug Fixes

• Fixed settings window not opening correctly in some cases
• Fixed animation glitches on macOS Tahoe with Apple Music
• Fixed notch slider not rendering correctly in some cases
• Fixed inconsistent toggling of menu bar playback controls

---

This update gets Tuneful ready for macOS Tahoe.

Important note for Apple Music users on macOS Tahoe: In macOS Tahoe, Apple changed the internal Apple Music APIs, which currently prevents all third-party apps from accessing playback data for streamed music. This unfortunately affects also Tuneful, as it relies on this API. Music in your playlists or local files continues to work as usual. We are exploring alternative solutions to restore full support for Apple Music streaming.

New Features

• Updated icon to match the new design language
• New Liquid Glass mini player look (macOS Tahoe)
• New Liquid Glass popover look (macOS Tahoe)
• New setting to customize notch hover behavior - you can select either "Scale & Show live activity" (current behavior), or more simple "Scale" option
• New volume control keyboard shortcuts
• New onboarding step for music interface selection

Bug Fixes

• Fixed settings dropdown menu widths in macOS Tahoe

Other Changes

• Deprecated "Tint" background option in favor of Liquid Glass
• Removed several mini player context menu options for cleaner look
• Keyboard shortcuts settings are now split into 2 sections

---

New Features

• Added more mini player size options

General Improvements

• Updated settings templates for popovers

Bug Fixes

• Fixed menu bar playback buttons scaling issue

---

New Features

• Added a new setting to fine-tune trackpad gesture sensitivity

General Improvements

• Improved album art animations
• Improved previous/next song button animations
• Improved rendering for shuffle and repeat buttons
• Improved notch notification scrolling speeds and animations
• Added text transition for non-notch screen song info detail section
• Notch notification no longer force triggers live activity

Bug Fixes

• Fixed notch haptic feedback being triggered twice in one edge case
• Fixed notch animation when notch hover duration is set to 0
• Fixed small typo in the notch context menu
• Fixed notch notification animation being ignored in one case
• Fixed an issue with Apple Music permission request during onboarding in some cases
• Fixed an issue where the mini player menu bar toggle did not stay in sync when the mini player was toggled from settings
• Fixed notch click to open for macOS Tahoe
• Fixed notch live activity spacing for macOS Tahoe

---

New Features

• Tuneful can now connect to both Spotify and Apple Music in parallel
• Added a new keyboard shortcut to toggle the music live activity in the notch

General Improvements

• Notch animations have been cleaned up, and feel much more consistent now
• Notch animations are now slightly bouncier
• Optimised some background tasks for better idle performance
• The onboarding flow now includes a more detailed permissions section

Bug Fixes

• Fixed a notch sizing issue in one edge case
• Fixed an issue where Tuneful couldn’t fetch album art for local music in Apple Music in some cases

---

New Features

• Vertical swipe gesture now also works for regular mouse scrolls
• Added new animation to song and artist titles when the song changes
• Added new animation for song slider

General Improvements

• Enhanced notch swipe gesture animations
• Notch animation is a bit snappier

Bug Fixes

• Fixed an issue causing the notch right-click menu to glitch during music playback
• Fixed possible performance issues

---

General Improvements

• Tuneful now consumes significantly less CPU resources on idle which results in near-zero battery usage
• Improved notch swipe gestures animation
• Sligthly increased padding for notch song details
• Font for notch song details is a bit smaller now
• Slightly updated notch radius
• Notch album art corner radius was slighly adjusted

Bug Fixes

• Fixed notch swipe gestures not being detected in one edge-case
• Fixed notch click action not being detected in one edge-case
• Fixed volume slider not being synced with player app in one case
• Fixed menu bar popover not always closing when clicking outside of its frame
• Fixed notch player settings being disabled in one edge case

---

New Features

• New "Visibility on non-notch displays" setting with three options: always visible, visible when playing music, or visible on mouse hover; this option also replaces "Hide notch when not used"
• New option to display song details directly on the unused part of the notch on non-notch displays
• New option to set the notch width on non-notch displays
• New volume control secondary playback button - this allows for easy volume settings directly from notch, popover, or mini player

Bug Fixes

• Fixed mouse hover issue when the notch was hidden
• Fixed an issue where the next/previous song buttons would not appear during a horizontal swipe gesture on the notch in a specific edge case

Other Improvements

• Notch scrolling notifications now look a little better
• Improved animation of notch opening using vertical swipe gesture
• Improved haptic feedback trigger algorithm for the notch
• Small UI mini player window improvements
• Improved slider interaction for mini players
• The animations were unified for more coherent feeling
• Updated logic for Spotify installation path - Tuneful now detects Spotify even if it's not installed in the root Applications folder
• Horizontal mini player now contains volume control slider

---

New Features

• Spotify web API integration is here - you can now add and remove songs from favorites directly from the notch player, menu bar player or mini player
• It's now possible to hide mini player window if the music is not playing
• It's now possible to fine-tune the notch height by ±5px
• Menu bar song info can now be set to fixed size. This setting prevents popover "jumping" around when song info lenght changes while skipping tracks
• Vertical mini player now has volume control slider
• Added righ-click menu to notch, menu bar and mini player to quickly switch between Spotify and Apple Music

Bug Fixes

• Fixed typo in mini player right-click menu
• Fixed animation loop when hovering the notch in one edge case
• Fixed notch music slider not being updated in one edge case
• Fixed a bug when haptic feedback was triggered when the notch player was opened by clicking

Other Improvements

• Notch animations are a lot more satisfying and smooth
• More intuitive settings for secondary playback buttons
• Minor UI enhancements in onboarding
• Album art is tiny bigger in Compact and Horizontal mini players
• Fixed slight offsetting of music seeker as the song progresses
• Slightly improved swipe gesture detection
• Settings window is optimised for smaller screens

---

New Features

• Added new Simple mini player type without album art for those who like minimalist look
• New setting to show playback control buttons directly on menu bar
• Notch player waveform can now be set to monochrome
• It's now possible to customize secondary playback buttons (shuffle and repeat) and replace them with "Add to favorites" button
• Tuneful now shows dock icon when setting window is opened
• Email template for bug report now prefills useful data
• Enhanced onboarding experience with beautiful animations

Bug Fixes

• Fixed settings window opening more than once if already open
• Fixed menu bar item forgetting its position when "Hide menu bar item when nothing is playing" option was turned on
• Fixed a bug when notch live activity waveform continued animating after the player app was killed while playing music
• Fixed small animation glitch when hovering over the notch notification in some edge cases
• Fixed song notifications in notch not showing in some edge cases
• Fixed music live activity not showing when notch was hovered in one edge case

Performance Improvements

• Optimised some background tasks which results in lower CPU usage

Other Improvements

• Album art transitions are now smoother
• Adjusted mini player and popover windows transparency to more native look
• Adjusted notch height for non-notch screens to match menu bar height exactly
• Notch is a bit narrower for non-notch screens
• UI of all mini players is now a bit more polished
• When music player is not opened, hovering over the notch just expands it instead of showing music live activity icons
• Settings window now displays always on top of other when opened
• Menu bar item has a bit nicer spacing now

---

Bug Fixes

• Fixed Tuneful crashing on macOS Ventura when settings were opened

Other Improvements

• Added buttons to report a bug and request a feature to right-click menus and to the settings

---

New Features

• New notch trackpad gesture to swipe horizontally to skip tracks
• New notch trackpad gesture to swipe vertically to open/close notch
• New trackpad gestures for popover and mini player to skip tracks
• Notch can now be show on all screens, in addition to main screen and notch screen
• It's now possible to right-click the notch to hide it or disable music live activity
• Menu bar waveform icon can now be set to single color, in addition to album art colored overlay

Bug Fixes

• Minor UI fixes in gradient mini player and gradient menu bar player
• Fixed an issue when notch player remained opened in some cases if notch hover duration was set to 0
• Fixed mini player window padding and background when music player was is closed
• Fixed slight album art flicker when opening with notch hover duration set to 0
• Fixed a crash in case a local music was played through Apple Music

Other Improvements

• Notch animations are now a bit smoother
• Enhanced the algorithm for detection of album art colors
• Improved podcast handling
• Minor performance improvements

---

New Features

• New Gradient Blur mini player
• New Gradient Blur popover type that goes hand in hand with the new mini player
• Notch has more polished animations
• Notch Auto hide feature for non-notch screens is now out of beta
• New settings pages for Mini player and Popover to make the design selection more interactive
• Reintroduced podcast support - when playing podcasts, forward and backward buttons are replaced by buttons to go forward and backward by 15 seconds

Bug Fixes

• Fixed a bug with missing notch animation in some edge cases

Performance Improvements

• Tuneful now needs less resources (CPU) when using mini player

---

New Features

• Added trackpad haptic feedback on notch hovering and opening
• Song notifications are now scrolling if the text is too wide for the notch
• It's now possible to set notch hover duration to zero to open notch player immediately
• It's now possible to show notch either on main screen or on the screen with notch
• It's now possible to hide menu bar item altogether and have only notch and/or mini player enabled

Bug Fixes

• Fixed a bug where notch would sometimes get stuck in open/close loop if hide option was enabled
• Fixed notch hover behavior for some edge cases

Performance Improvements

• Notch functionality was fully rewritten and optimised to use less resources

---

New Features

• New option to auto-hide the notch for non-notch displays so it doesn't overlap menu bar items
• New option to hide album art and equaliser from the notch when music is playing
• New option to set custom song change notification duration
• New Horizontal Slim mini player style, inspired by the 4x1 player from iOS Control Center
• Subtle adjustments to the alignment of album art and equaliser in the notch for non-notch displays
• Shuffle and repeat buttons are now less visible if the shuffle/repeat are not enabled

Bug Fixes

• Fixed a bug where notch hover duration was affecting notification duration by mistake

Performance Improvements

• Tuneful now fetches song information from Spotify and Apple Music more efficiently when the app is launched while music is already playing

---

Bug Fixes

• Fixed an issue when physical notch was overlayed over notch player when More Space display scaling was set
• Added Attribution section to the settings with the list of libraries that are used in Tuneful

---

New Features

• Notch Player has been completely redesigned to resemble the Dynamic Island music player from iOS
• Notch now displays album art and equalizer icons on its sides to indicate when music is playing
• It's now possible to open the notch by clicking on it or hovering over it for a configurable number of seconds
• Notch Player features a new colorful music slider, with colors dynamically extracted from the album art of the currently playing song
• While music is playing, you can hover over the album art or equalizer icons on the Notch to play/pause the track or skip to the next one
• All interactive elements in the UI now feature smooth animations
• Changing songs triggers a 3D album art flip animation

Bug Fixes

• Fixed the bug when notch was initialised even if it was disabled in some cases
• Fixed the bug when Cmd + Comma shortcut was set globally

Performance Improvements

• Optimised unnecessary fetching of song data in some edge cases

---

New Features

• New notch integration now allows you to control the music from notch. For non-notch Macs, this is available on hovering over new song notification
• New ability to resize mini player to 3 sizes - regular, small, and large
• New music slider which now looks and feels native
• New popover and mini player background type
• New UI animations so the app feels more fluid
• New vertical mini player type
• New enhanced onboarding experience

Bug Fixes

• Fixed the bug when Spotify was opened in the background even if killed by the user
• Fixed the bug when mini player floating preference was ignored on app restart
• Fixed the bug when Tuneful wasn't fetching Apple Music song favorite info correctly when changing songs
• Fixed the bug when previous song button didn't rewind the song to the beginning if some part already played for Apple Music
• Fixed bug when Cmd + comma shortcut opened blank window; now it opens settings window

Performance Improvements

• Refactored the logic that fetches song information which makes the app feel snappier
• Tuneful uses fewer calls when customising UI in the Tuneful settings and relies more on native SwiftUI