A Spatial audio switch in Playback settings, on by default, in the Audio
output group of both styles: after Skip silence on Android, after
exclusive output on macOS, and in its own Audio output group on iOS.
Windows and Linux have no row and no search entry. The app renders
nothing; the switch only tells the platform whether it may spatialize.
- media3: a new `setSpatialAudio` call maps to the audio attributes'
spatialization behavior (auto or never). It applies live: the sink
reopens its AudioTrack and drops its buffer, so native seeks to the
current position to decode that audio again instead of skipping it.
- Old Android engine: the fork takes `setSpatialAudio` on its player
channel (no platform interface change) and sets the behavior on API
32+ as each source loads, so a change applies from the next song. The
subtitle says so while the new engine is off.
- iOS and macOS: the Darwin fork sets allowedAudioSpatializationFormats
(iOS 14, macOS 11) to mono, stereo and multichannel or to none, on the
current item and every new one.
The subtitle ends with a live status line. Android reads the
Spatializer (available, enabled, head tracker, and canBeSpatialized for
stereo and 5.1) over a new event channel that re-reads on spatializer,
head tracker and device changes and on resume. iOS reports whether the
output port has spatial audio enabled, on route and spatial capability
changes. The line names the direct USB and AAudio paths and macOS
exclusive output, which never reach the system's spatial audio.
Hiding `headphoneResume` on Android TV turned the old Play when
headphones connect switch off for TV users who had it on. TVs pair
Bluetooth or USB headphones as phones do, so the choice is now shown,
found by settings search and applied on Android TV in all three modes,
and stays hidden only on desktop. The automation group drops its TV
divider special case.
Tests: TV now behaves like a phone (Reconnect resumes a route-loss
pause and leaves a user pause paused, Always resumes after a user
pause, Off stays paused), the TV settings page shows a migrated Always
and saves a new choice, and desktop hides the row and its search entry.
Play when headphones connect and Resume when headphones reconnect become
one setting, `headphoneResume`, with three choices: Off, Reconnect
(resume a pause caused by headphones or Bluetooth going away, within 30
minutes) and Always (the old switch: every connection resumes, a user
pause included, and a disconnect pauses). The row keeps the old title,
describes the current choice under it and draws the choice with the
DESIGN.md component for 2 to 4 short options: `SettingsSegmentedChoice`
(connected M3 Expressive button group) in Material and
`MornyeSegmentedControl` in Mornye. "Reconnect" is short so the three
segments fit one row on a 360 wide phone in both styles and languages.
Migration: a saved `headphoneResume` wins; otherwise
`playOnHeadphonesConnected: true` reads as Always, then
`resumeOnOutputReconnect: true` as Reconnect, else Off. An unknown value
falls back the same way. `toJson` still writes
`playOnHeadphonesConnected` (true only for Always), so a downgrade or a
backup opened by an older build keeps the broad behaviour, and backups
carry the new key through the full settings map.
The choice is offered and applied on Android and iOS phones and tablets
only: desktop and Android TV hide it (search too) and the player treats
it as Off there. The old switch's strings stay for the title and the
Always description; the two strings only the separate switch used are
removed.
A custom ListenBrainz server may use http:// only on this device or the
local network: localhost, loopback, private IPv4, link-local, IPv6
unique local and link-local addresses, and .local names. Any other
http:// address is refused with a message asking for HTTPS, when it is
entered and again before every request. An account saved with such an
address is signed out on start before anything is sent, and its queued
listens wait for the next sign-in.
Lines written in a script of the app language (or of the system's, when
the app follows it) now get no romanization: Cyrillic for Russian,
Ukrainian, Belarusian, Bulgarian, Serbian, Macedonian, Kyrgyz and the
other Cyrillic languages, Han for Chinese, kana and Han for Japanese,
Hangul for Korean, Devanagari for Hindi and Gurmukhi for Punjabi. A
locale naming another script, such as Serbian in Latin, keeps nothing.
Neither the offline romanizer nor the AI fallback romanizes them: such
lines are not counted when deciding whether a translation asks for
romanization, and the romanization an AI translation gives them is
dropped from what is shown and saved. Other scripts in the same song
are still romanized. The choice follows the app language as it changes.
Macedonian џ is now the official "dj", and the AI Add Romanization
subtitle has its Indonesian text.
When a service refused a batch of saved listens as malformed, the whole
batch left the queue. The shared pipeline now resends those listens one
per request, so only the ones refused on their own are dropped and the
rest reach the service. Each single request removes its listen or ends
the run, which leaves the remaining listens to the existing retry timer.
Last.fm, Libre.fm and ListenBrainz all get this.
The native pulse channel takes an optional usage. Touch pulses play
with VibrationAttributes.USAGE_TOUCH on Android 13 and later, and as
assistance sonification below that, so the system's touch feedback
switch controls them. A pulse without a usage stays media vibration,
so Music Haptics is unchanged. iOS ignores the usage. The queue swipe's
haptics now send touch pulses.
A Resume when headphones reconnect switch in the Automatic playback
group of Playback settings, off by default, on Android and iOS phones
and tablets (hidden on desktop and Android TV, also from search).
When headphones or a Bluetooth output go away while music plays, the
existing becoming-noisy pause now also records when it happened. If a
headphone-type output (wired, USB, Bluetooth A2DP or LE, hearing aid)
connects again within 30 minutes, that pause resumes once. Any other
transport change clears the record: Pause, Play, a skip or new song,
Stop, an audio interruption, a setting change or Cast. A song that was
already paused is never resumed, and the record lives in memory only,
so nothing resumes after the app was killed. Mute and audio focus still
block the resume, as for the other automations.
It reuses the audio_session device inventory that Play when headphones
connect already reads, so no permission is added. That broader switch
resumes on every connection, a user pause included; while it is on, the
new switch is disabled and its subtitle says it is covered. With both
on, the disconnect pause of the broader switch keeps the route-loss
record, so they do not conflict.
The window check is the pure `resumesNoisyPause`; the clock is
injectable for tests.
The queue swipe now plays soft ticks through the native pulse channel
that grow stronger at 30, 55 and 80 percent of the commit distance,
then one strong, sharp pulse where letting go would commit, and nothing
past it. Ticks closer than 70 ms are dropped so a fast swipe never
buzzes, and each step re-arms once the swipe falls back below it. Where
the channel is missing or fails, system haptics take over. The
swipe-to-delete haptic is unchanged.
While song rows swipe to queue, the Material Library pager stops
changing pages on a drag, so Songs and Folders rows get the queue swipe.
The tabs still change pages, and keyboard and D-pad navigation are
unchanged. With the setting off, or where the swipe is not offered
(desktop, Android TV, no built-in player), the pager swipes as before.
Lyrics in other alphabets now show how they are sung without an AI key
or a network: Korean (Revised Romanization with liaison,
nasalization, lateralization, aspiration and palatalization), Cyrillic
with one standard per language (Russian, Ukrainian, Belarusian,
Bulgarian, Serbian, Macedonian, Kyrgyz, picked from the letters of the
song), Hindi and Punjabi in the plain lyrics spelling with dropped
inherent vowels, Chinese Hanyu Pinyin with phrase readings for
polyphones, and Japanese kana by Hepburn.
Japanese lines with kanji are not romanized offline: a reading
dictionary does not fit the size budget. Those lines, and scripts the
device cannot romanize (Thai, Arabic and others), are what an AI
translation is asked to romanize when it is set up to; otherwise they
show no romanization. A translation no longer asks the AI to romanize
what the device can.
Pinyin comes from a 259 KB gzipped asset built by
scripts/build_pinyin_data.dart from Unihan (Unicode License v3) and
phrase-pinyin-data (MIT); both notices are in the app's licenses. It
loads on a background isolate the first time Chinese lyrics play.
Word-timed lines keep their timing: the line romanizes as a whole, so
sounds that run across words read right, and each word takes its own
part. The romanization is shown, never saved with the song.
Lyrics settings get Romanize lyrics (it starts as the AI romanization
switch was, so whoever turned that off is not shown romanization) and
Romanization as main line, which shows the romanized text as the line
with the original under it; a word-timed line whose romanization has no
timing keeps its original as the main line.
A lock toggle in the queue header of both styles, also in the Queue
section of Playback settings (where search finds it), saved as the
`queueLocked` setting. While it is on, the queue UIs offer no drag
handles (Material's long-press drag included) and no swipe to remove,
and a reorder that still arrives is ignored. Tapping a song still plays
it, and adding songs from elsewhere (Add to queue, Play next, Autoplay,
a paired device) still works. Neither queue UI has a Clear action, so
there was none to block.
Material: an M3 Expressive toggle icon button (`ExpressiveIconButton`,
selected state) before the Autoplay, Repeat and Shuffle toggles of the
Up next header, in the phone sheet and the desktop inspector. Mornye: a
44 pt icon toggle at the end of the Continue Playing title row, filled
while locked like the queue's mode buttons, on phones and desktop.
The lock covers this device's queue UI only; edits a paired phone sends
to the computer's queue are not blocked by the computer's lock.
A No duplicates in queue switch in a new Queue section of Playback
settings, off by default. While it is on, Add to queue, Play next and
adding many songs move an entry already coming up instead of queueing a
second copy, and a batch adds each song once, in its order. The song
playing and the songs before it are never touched, so they can be
queued again.
Identity is where a song plays from (`queueIdentityKey`), not its id or
tags: one file has different ids in the Library, the download history
and a plain path, while a FLAC and an MP3 copy share their tags and are
both meant to be queued. A `file://` URI counts as its path, a SAF
document is matched by provider and document id so a folder-tree URI of
it matches too, and `network://` sources (NAS, Subsonic, a paired
device) and CUE tracks name one song each. Stream URLs compare as is:
one with a fresh token never matches, which keeps a copy rather than
merging two songs.
Every path that adds to the queue goes through `enqueue` and
`enqueueAll`, so Link follows the playing device's own setting: songs a
phone queues on the computer, and a computer queueing a phone's songs
there. Autoplay already leaves out songs coming up and is unchanged.
The moved entry is removed without marking it dismissed for Autoplay,
and the shuffle order and play history follow the removal.
On phones and tablets a sideways swipe on a library song row runs the
same Play next and Add to queue actions the row's menus offer: toward
the end of the row plays next, toward its start queues last, swapped in
right-to-left layouts. The row follows the finger, ticks at the commit
point, runs the action on release and springs back with a snackbar.
The drag must be at least twice as wide as tall, touches at the screen
edges stay with the system back gestures, and rows inside a draggable
pager or carousel keep the page swipe. Selection mode, desktop and
Android TV have no swipe. Screen readers get both actions as custom
actions on the row. A Library setting, on by default, turns it off.
The sleep timer sheet gains End of song, next to the minute choices.
While it is set, the player menu shows "Ends after this song" where the
minute timer shows its end time, the sheet marks the choice, and Turn
off sleep timer cancels it. Choosing it replaces a minute timer and the
reverse; stopping playback clears it.
When the song playing ends, the next song (or the same one under repeat
one, or the first of a repeat-all pass) loads paused at its start, so
Play continues the queue and nothing of it is heard. A skip keeps the
timer armed: it then stops at the end of the new current song. It is
not saved and never outlives the app.
Gapless and AutoMix stand down while it is armed:
- Gapless: arming drops a next song already queued on the media3
playlist or chained to a second deck, and no new one is prepared, so
the end reaches the ordinary completion path that loads paused.
- AutoMix: a prepared mix is dropped and none starts, so the song plays
to its real end rather than stopping where the crossfade would start,
up to a minute early. A crossfade already audible when it is armed
finishes; the song it brought in is then current and is the one that
ends the session.
The Last.fm pipeline becomes a shared Scrobbler base: listening rules,
Now Playing, the durable per-account queue, retry and session expiry
live in lib/services/scrobbling, and each service only signs in and
talks to its API. Every enabled service counts the same listen and
keeps its own queue, store keys and retry timer, so one failing
service never blocks or duplicates another.
Libre.fm reuses the Last.fm 2.0 client and browser approval on its own
server, with its own account and queue. ListenBrainz signs in with the
user token from its settings page, checked with validate-token, and can
point at a compatible self-hosted server. Listens carry the album,
duration and, when tagged, the ISRC and track number.
Last.fm keeps its storage keys and saved format, so a connected account
and its queue carry over without signing in again. Playback settings
show Libre.fm and ListenBrainz next to Last.fm in both styles, and both
are searchable.
A Skip silence switch in Playback settings, off by default, shown on
Android phones and tablets under the new playback engine. It works only
through media3: while that engine is off the switch is disabled and its
subtitle says why. Changes apply live through a new `setSkipSilence`
call on the media3 channel, sent after `create` and on every change.
media3 skips silence in its audio processor chain, which it bypasses
for float PCM, and it asks every decoder for float once the sink takes
float output. While the setting is on, the renderer therefore asks
decoders for 16-bit PCM and refuses to reuse a decoder set up for the
other mode, so hi-res sources lose their low bits while it is on (the
subtitle says so). A decoder already running keeps its mode: turning
it on mid-song starts skipping from the next song, turning it off
stops at once.
Interplay:
- AutoMix: suspended while AutoMix is on. AutoMix times its fade start
and beat matching on the clock from analysed file positions, which
skipping would outrun. The subtitle says so.
- Gapless: `queueNext` stays on the same player, so the trailing and
leading silence around the handoff is skipped too; the 30 s lead
leaves the queue call far ahead of the end.
- Position, duration, synced lyrics: media3 reports media time, which
jumps forward over a skipped passage, so lyrics stay in sync and the
duration is unchanged.
- Scrobbling and listening statistics count listened wall time, so a
song with long silences counts slightly less time; the thresholds are
far from that.
Incremental scans now reread songs whose cached cover file is gone, so a
cleared cache no longer needs a full rescan. They also reread every song
without a cover once, so songs scanned before folder images were read
can pick one up.
Find Missing Artwork in Library settings looks up albums without a cover
through the enabled metadata extensions, in their priority order, and in
Mornye can also save animated covers for every album. Matches need the
album artist and title; another edition counts only when the song count
and year agree. Found covers are cached thumbnails that never touch the
music files. They are applied after every scan, come back from their
saved address after the cache is cleared, and are not looked up again
for 30 days. An album page can look its album up on demand or remove
what was found, which stays away until it is looked up again.
Animated covers saved for one artist are shared with the other song
artists of the album through aliases instead of a second download.
A phone showing what the paired computer plays restamped each player
state with the time it arrived, because the two clocks may run seconds
apart. The time the state spent on the way was lost, so the position,
and the lyrics with it, trailed the computer's audio by the network
delay, often a fraction of a second over Wi-Fi.
The phone now measures the computer's clock from its `GET state`
replies, stamped halfway through each round trip, keeping the sample
with the shortest round trip. Pushed states move onto the phone's clock
by that offset. A few pushes read the clock again until three samples
exist, then once a minute; reconnecting starts over. Before any sample,
or for a stamp over 5 s old, a state counts as read when it arrived.
The lyrics move to the next line on a timer when it starts. A position
report that arrived just after, a little behind the line's start, made
the full lyrics view and the lyric line under the title step back to
the previous line for a moment before moving on again. Link playback,
whose reports arrive with network delay, showed it most, and only now
and then.
While playback advances, a report less than 750 ms behind the shown
line keeps it. A seek further back still moves at once.
Fast mode hid the word timing of any translation, including one that
already had it: a translation a linked phone shared in Synced mode, or
one saved earlier in Synced mode. On a computer left in Fast mode, a
phone's synced translation showed line by line.
The mode now only decides whether a new translation asks for word
timing. Timing a translation already has shows, and Translate
Downloads saves it, in either mode.
The lock screen read a song's lyrics only from a plain file or a
resolved copy. Playback streams songs from a picked folder (SAF), which
covers the local library and downloads saved there, straight from the
document and publishes no copy, so the title never changed for them.
Link songs, which play from a local copy, were unaffected.
The lock screen now reads the document itself, as the lyrics page does
(through a descriptor, copying only from a provider that cannot seek),
and only while it shows.
A line timed with the line before it, such as a translation an LRC
file times with the line it translates, no longer replaces the sung
line on the lock screen.
The cover page read an SAF song's tags only once playback published a
resolved local copy. Direct SAF playback, the usual path now, never
publishes one, so the lyric line under the title stayed empty until
the lyrics page had been opened once.
While the lyric line is on, the player now reads the document itself,
as the lyrics page does (through a descriptor, copying only from a
provider that cannot seek). With the line off, opening the player
still reads nothing more.
The glow behind held words filters the active line on every frame, and
each rising word paints the line again. Low-end phones were reported
to stutter in the full lyrics view.
The glow now follows the lyric blur: it shows where the device draws
filtered lyrics (the liquid glass level, Android phones with 6 GB or
more, or with blur effects forced on). Low-end phones (arm32 or 2.5 GB
or less) also skip the rise, so the sweep paints the line once.
Every rebuild of the player lyric line passed the playback position
again, and both the line slide and the word sweep jumped to it. A
report a little behind their own clock moved them back a few letters
before they went on.
The slide now keeps its place on a difference under 750 ms and retimes
the rest of its movement instead, and the word sweep eases such a
difference in the way it already treats playback reports. The slide
also follows each word's start rather than stopping between words, and
averages over 250 ms either side, so it changes pace gently.
The lyrics menu offered "Translate to <language>" even after the lyrics
were translated into it, or when the song is already sung in it. The
action now only shows when there is something to translate, and the
language picker reads "Translate Into…" in its place.
The lyric line under the player title slides a line too wide for it:
it holds at the start, follows the singing (word timing when present,
else a steady pace until the next line) once it is 60% across, and
stops with the end in view, with faded edges. It moves only while
playing and visible, and in half-width steps with reduced motion.
The lock screen title cannot move, so a line over about 24 characters
(wide characters count twice) now shows in parts, cut after
punctuation where possible, each from when its first word is sung and
kept at least 1.5 s; a line sung too fast for that stays whole.
A song that failed because its download provider was missing, or because
decryption failed, was marked failed without counting toward the session.
A queue where every song failed that way ended with a "canceled"
notification and "failed: 0" in the log, and auto-export skipped them.
Both paths now record the failure like the others, and the missing
provider is logged.
An album or playlist sent from the phone carried its metadata provider as
the download service. When that extension has no download provider on the
computer, every queued song failed at once with "Song not found on any
service". The computer now uses the hint only when it is an enabled
download provider there, like the phone's own download picker, and
otherwise its default download service.
Deleting songs from the app left their album and artist folders behind,
so people had to clean them up with a file manager. The song's own .lrc
and .mlrc files stayed too, which kept those folders from being empty.
Deleting a song now also deletes its .lrc and .mlrc files, unless
another song in the folder has the same name. Settings > Files >
Existing Files gains Remove Empty Folders, on by default: once a song is
gone, the folders it leaves empty are removed, up to but never including
the download folder or a Local Library folder, and never a storage,
volume or home folder or a folder right inside one, such as Music or
Download. A folder still counts as empty when it only holds system index
files, Mornye's cover.mp4 or lyrics files of songs that are gone.
Folders are removed while the download queue is idle, so a download
never loses the folder it writes into.
Every place that deletes a song from the library goes through this:
the library and album screens, song details, Duplicate Review and
Mornye Link. Android storage access folders work through two new
platform calls that find a song's folders before it is deleted and list
a folder. Network songs and CUE tracks are only deleted, as before.
A paired device's songs need it connected, so the Library now hides
them once it has been disconnected for 10 s and shows them as soon as
it connects again: a phone's songs on the desktop, a computer's songs
on a phone. The device's Library source is marked unavailable, which
the visible library view already hides, and its status reads "Not
connected". In a phone's background no grace runs; resuming starts a
fresh one, so an iPhone dropping the link on purpose changes nothing.
Other network sources keep their state through outages, reconnect
scans skip network sources (Link refreshes its own songs), and a
connecting device may rescan before the availability write lands.
A "Hide songs while disconnected" switch on the phone's Link page and
the desktop's Phones section turns it off; it is on by default.
The Store tab badge stayed at zero until the tab was opened, because
only the tab loaded the store. The shell now checks the store after
startup (once extensions are ready) and again on returning to the
foreground when the last check is older than six hours. Nothing runs
without a saved registry URL, and failures are only logged.
A new App setting, on by default, then updates every installed and
enabled extension whose store update this app version can run. Updates
go one at a time through the store's serialized path, wait for the
download queue to be idle, keep the old version on failure without
retrying that version this session, and end with one short notice.
Background failures stay off the Store and Extensions screens.
A translation was saved only after the player had shown it, so a song
downloaded and played offline had none. Settings > Lyrics > AI
Translation gains Translate Downloads, off by default because every
download is a request on the user's API key.
While it is on, each finished download's lyrics are translated into the
chosen language (or the second language when they are already in it),
one song at a time, and saved as Save Translation to File does: into the
song's lyrics or a .mlrc file next to it, as Save To chooses. The result
lands in the translation cache at once, so the player shows it before it
is written. Song files are written once the download queue is idle,
because finishing an album rewrites its earlier files for ReplayGain.
Lyrics that already carry a translation, songs without lyrics and
network songs are left alone; a song that fails is logged and skipped.
The four Material Home shortcuts were fixed. A long press or right-click
on a tile now opens Change shortcut, a choice sheet of nine shortcuts
(Shuffle library, Equalizer, Listening statistics, Network storage,
Loved, Wishlist, Favorite Artists, New releases and Mornye Link), and
Reset shortcuts. Picking one already on Home swaps the two, so the same
sheet also reorders. The choice is saved in settings, so backups keep
it, and unknown names fall back to the defaults. The first shortcut keeps
the emphasized fill.
"Skip already downloaded songs" in the CSV import only asked download
History, so songs another app had downloaded into a scanned folder were
downloaded again under a slightly different name. The import now also
asks the Local Library, matching by ISRC and then title and artist, like
"Download all" on albums and playlists. Both share one lookup helper.
Android now plays ordinary songs through the media3 engine unless the
user turns the beta switch off. The subtitle now tells users to turn it
off when songs fail to play or sound wrong, instead of suggesting they
try it.
The overview asked for 6, 9 or 21 hits depending on the layout, so a pane
crossing the cover breakpoint (a window resize, the lyrics panel) started
a new search and showed a spinner over the rows for a moment. The overview
now asks for its largest page in every layout and shows what it needs.
The rail width followed the expansion spring, so expanding grew it past
220dp and collapsing shrank it under 96dp for a moment, resizing the
content past its final width and flipping its breakpoints twice. The width
now stops at its ends while the pills and labels keep the spring.
The Material open spring overshot the pane beside the content, so the
content narrowed about 5dp past its final width for a moment. In a 1280dp
window that dips the pane under the 840dp search cover breakpoint, which
flipped Library search to rows behind a spinner and back to covers. The
pane beside the content now stops at its width; a floating panel keeps the
spring.
The controller was also created lazily on its first read, which happened
when the panel opened, so it started at the open value and the first
opening after launch skipped its motion.