Portable players often do not read the cover inside a song and look for a
folder.jpg beside it. A new Files setting, Save Album Covers (off by
default), saves the cover a download carries into the album's own folder,
with a size choice from the sizes of Embedded Cover Size. The rule of the
animated cover applies: only folders that hold one album get the file, and
one already there stays. A PNG cover is saved as folder.png; other image
formats are not saved.
The folder writing of the animated cover moved to SongFolderFile, which
both covers use for local folders, Android documents and network storage.
While the setting is on, Remove Empty Folders counts folder.jpg and
folder.png as leftovers of a deleted album. While it is off they keep
their folder, as before.
Issue #913
A Library artist now has an Albums | Songs switch. Songs lists every song
of the artist by title, with Play, Shuffle and Save as playlist: the songs
of the artist's albums and the songs whose artist tag names the artist
beside others. The view chosen last is the one the next artist opens on.
The Albums | Singles switch moves into a shared LibraryViewToggle, and the
genre song reader into library_song_reads so both lists use one query.
One-line doc comments and inline comments that only repeat the name, the
type or the next statement of what they describe, in the Dart, Kotlin and
desktop runner sources. Comments that state a reason, a constraint, a
unit, a value set or a platform quirk stay. No code changes.
Playing on a tap surprised people used to the details page, so the
"Tapping a song" setting now defaults to Details and offers Play as the
choice. Settings saved before the choice existed keep opening details.
The details button showed a circled "i", which read like the circled
error sign of a song with a missing file. Use a page glyph instead, and
make the button smaller than the play button it replaces: a 20dp glyph
in lists, 16dp in desktop tables and a 28dp circle on grid covers. Touch
targets are unchanged.
A tag such as "Rock; Pop" was one genre of its own. Split a tag on
semicolons, commas, the NUL between ID3v2.4 values and the user's own
genre separator, the list rule the tag writer already follows. Slashes
and ampersands stay inside a genre, so "Hip-Hop/Rap" and "R&B" remain
one each.
A genre now counts and lists the songs of every tag that names it. The
song query takes those tags instead of a single one.
People asked that a tap on a Library song play it rather than open its
details. The owner made playing the new default, with a choice in
Library settings that brings back the old details tap. Saved settings
from before the choice load as Play, and backups carry it through the
settings JSON.
Browsing by genre needs each genre's song count and a cover without
loading the whole Library on the UI isolate. One query groups both
sources by sort_genre (the trimmed, case-folded tag) and the stored
spelling; Dart then merges spellings under the most common one.
The Songs query gains a genre filter, so a genre's songs come from
the same paged, shadow-aware read as the Songs list and use the
existing sort_genre indexes.
Flutter 3.50 deprecates its built-in Material and Cupertino libraries in
favour of the material_ui and cupertino_ui packages. The imports move
with the official fix (dart fix, migrate_design_widgets); the app's old
two-library theme bridge collapses into one Theme type.
- MaterialExpressiveScope keeps the complete host theme nearest its
child. The reduced copy made for the expressive widgets now shares the
app's Theme type and would hide component themes and extensions.
- LegacyThemeBrightness hands the brightness to the glass package, which
still reads Flutter's built-in theme.
- appLocalizationsDelegates lists the material_ui localization delegates;
the generated list still names the built-in ones.
- Tests: findByTooltip and pageBack replace the flutter_test helpers that
only know the built-in widgets, and several tests that had gone stale
against earlier app changes are repaired.
Auto-convert now offers M4A (ALAC) next to MP3, AAC, Opus and FLAC
(issue 900). ALAC follows the FLAC rules: lossy and DSD sources are
kept, the maximum bit depth, sample rate and Smart Dither settings
apply, and an ALAC file within the limits is left alone. Only the
probed codec marks an .m4a as ALAC, so AAC is never taken for it.
The Dart finalizer reuses the manual ALAC converter and embeds tags as
M4A. The Android background finalizer encodes ALAC with planar
samples into the ipod muxer, keeping tags and artwork, and records the
.m4a container instead of falling back to MP3.
The switch sits under Lyrics Provider Priority and is on by default. On,
the backend takes word-synced lyrics over synced lyrics, and synced over
plain text, from any enabled provider, with provider order deciding
between equals. Off keeps provider order only: the first provider with
lyrics is used.
The setting reaches the backend as the prefer_best_timing fetch option,
so the player's online lyrics and the lyrics fetched for downloads follow
it alike. Settings search finds it next to the provider priority.
A tester's phone slipped and the volume bar went straight to the top
with earbuds in. A new Confirm loud volume switch in Playback (Volume
and transitions, off by default) picks a level of 60, 70, 80 or 90
percent (80 by default). With it on, dragging, tapping or stepping the
app's volume bar from at or below the level to above it stops at the
level and asks first, with Cancel as the default. Continue sets the
volume where the user asked; the bar then moves freely until the volume
is back at the level or below, and the next crossing asks again.
The dialog takes the touch, so a long drag asks once, and after a
cancel the same touch stays at the level. A volume that is already
above the level (volume buttons, the system, a restored session) does
not ask when the player opens or while the bar moves within the loud
range. The bar asks the same way when it sets the volume of a paired
computer or a USB DAC. Volume buttons, keyboard shortcuts, the mouse
wheel on desktop and commands from a paired device are not limited.
The end of a touch on the expressive slider reports the value it was
last given, which can be a frame old; while the dialog is open that
report no longer moves the bar.
The media3 engine stays an opt-in beta on Android: new installs and
settings saved before the switch existed play through the platform
MediaPlayer, while a saved choice either way is kept. Tests that cover
media3-only behavior (skip silence, live spatial audio, engine changes)
now turn it on themselves.
The speed slider stepped by 0.05x (31 stops) and pitch by half a
semitone (49 stops), which drew the track as a dense dotted line.
Speed now steps by 0.1x (16 stops) with the quick choices still
offering 0.75x and 1.25x, and pitch by whole semitones (25 stops);
half semitones saved by earlier builds round to whole ones.
The quick choices use the button group's disabled style when the
output cannot change speed, and Material's compact player shows the
speed and pitch label that the full player's format row carries.
Adds playbackSpeed (0.5x to 2x), playbackKeepPitch and playbackPitch
(semitones, -12 to 12) to AppSettings, their setters, and the global
playbackSpeed, playbackPitch and playbackTempoSupport notifiers the
decks and the controls share. The runtime publishes the settings to the
notifiers; no deck applies them yet.
Appearance > Layout gets an Interface size slider, 80% to 130% in 5%
steps, default 100%. AdaptiveUiScaler multiplies it with the automatic
tablet and TV scale, so every page, dialog and control reflows at the
chosen size on phones, tablets and desktop, in both styles. The size
applies when the slider is released.
The scaler keeps its content under a GlobalKey, so starting or stopping
a scale (this setting, or a tablet crossing its breakpoint) keeps open
pages and scroll positions instead of rebuilding the app. The macOS
title bar row divides by the scale so it stays aligned with the native
traffic lights at every size.
5.4 is the current release, so the 5.3 highlights tour no longer shows
after an update, on phones (the /whats-new route) or desktop (the dialog
over the shell), and About no longer reopens it. The whatsNewSeen setting
and AppInfo.whatsNewRelease go with it; the stale key drops out of the
saved settings on the next save.
Nearby devices is still asked at setup and by Mornye Link and network
storage when they need it.
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.
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 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.
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.
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.
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.
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.
Follow-up to the lyric line under the track title (PR #847).
- The setting is off by default; Lyrics settings and settings search turn
it on, with localized English and Indonesian strings.
- Opening the player no longer probes unresolved SAF documents for the
line. It shows once playback publishes the resolved source, as before.
- The line follows audio_service's extrapolated position, the playback
speed and the lyrics timing offset, like the desktop mini player. The
timer targets the next line's start with the 80 ms lead applied, so it
no longer fires zero-delay timers before each line, and it stops while
paused, buffering, seeking or offstage.
- With the setting off nothing subscribes to playback.
- A translated line shows as plain text; word timing applies only to the
original line.
- Text uses the theme's body style, the chevron mirrors in right-to-left
layouts, alignment is directional and reduced motion skips the fade.
- The line reads as one Lyrics button to screen readers.
- Drops the unrelated Android lint opt-out and .gitignore entry, and uses
generic test data. New tests cover the default, the offset, timing,
seeking, and the player waiting for a resolved source.
- Render interactive single-line synced lyric preview under title and artist
- Support word-by-word real-time karaoke sweep with WordTimedLyricLine
- Interpolate playback clock with microsecond precision and schedule line boundary timers to eliminate line switch delays
- Auto-inspect embedded lyrics on Now Playing screen without requiring opening lyrics page
- Add playerShowLyricSnippet setting toggle
- Add comprehensive widget tests and disable release lint checks in android
Autoplay now remembers which songs it played or suggested, across
restarts, as hashed fingerprints only (no paths, URLs or metadata),
so related songs rotate instead of repeating. A new Autoplay
randomness slider in Playback settings decides how strictly: at the
lowest value repeats return least recent first, higher values widen
the pool and reduce score bias. It works with or without
personalized autoplay, whose description now says that turning it
off stops only preference learning.
An opt-in setting replaces the song title in the system media
controls with the current synced lyric line. Only the OS sees it:
the wrapper sits under the media session filter, so Last.fm,
Discord, widgets and Link keep the real title.
Lyrics come from the file and its .mlrc sidecar, never online.
Breaks of 3 s or more show the title, and the title changes at
most twice a second. Android shows lines only while the keyguard
is up and the screen is on; iOS cannot tell, so it shows them
while Mornye is in the background and restates the position first
so Now Playing does not jump back.
Smart Dither only adds dither when lowering bit depth, but it always used
plain TPDF. A new Use TPDF HP switch makes it use high-pass TPDF instead,
in the convert sheet (shown while Smart is selected) and for automatic
FLAC conversion of downloads (under Smart Dither, saved as
autoConvertSmartDitherHighPass). The native Android finalizer, the
Dart FFmpeg path and Mornye Link conversions all honor it; Link sends it
as ditherHighPass, which older desktops ignore. The switch is off by
default, so existing conversions do not change.
The explicit Triangular HP option is now labelled TPDF HP, next to TPDF.
An opt-in Files setting copies a download's animated cover into its
album folder as cover.mp4, so file managers and other players find it.
Only folders that hold one album get it: the folder is planned again
with a marked album name, and flat, artist, playlist and shared Singles
folders are skipped, as is a song kept in a folder other than the
planned one. An existing cover.mp4 is never replaced, for local files,
Android folder access and network storage alike; songs of one album
that finish together write it once.
The player, mini player and album headers now show a cover.mp4 found
beside a local song before the artwork saved for the album. Android
documents are found through a new findSafSibling call and copied into
app storage once per version, since the video player only opens files.
Saving a lyrics translation now covers every kind of lyrics:
- Plain lyrics can be translated on request. Each line's pronunciation
and translation show under it. Automatic translation stays synced-only.
- AI pronunciation is saved too, with its word timing, as x-romaji and
x-romaji-words tags next to the translation.
- A new .mlrc file next to the song keeps its lyrics with their
translation and pronunciation and leaves the audio file as it is. It is
UTF-8 LRC that starts with [x-mlrc:1]. Supplement tags are keyed by
line time, or by line index for lyrics without timing. TTML is written
as enhanced LRC with voices and backing vocals. The player reads it next
to local and Android document songs and lays it over the song's lyrics
by line text.
- AI Translation settings gain a Files section: Save To picks the song
file or a .mlrc file, and Save Automatically saves each shown
translation without a snackbar. TTML and plain lyrics always go to
.mlrc. Saving into the song file also refreshes an existing .mlrc.
- Android reads and writes the sidecar through new SAF calls, and the
.lrc sidecar write shares the same code.
Library albums get a sort button with Album Order, Most Played and Custom
Order, saved per album. Playback follows the chosen order. A rank drops
the disc sections, since it cuts across discs.
A song already in the target language could not be translated, and
switching the setting for it looped between two languages.
Add a Second Language for songs already in the first, and keep a language
picked in the player with that song, with a Default row to clear it.