Repository navigation
Flick 0.23.3-beta.5
Pre-release
Pre-release
·
16 commits
to main
since this release
An equalizer tab, read-only source audio analysis with a full-track spectrogram, live and lock-screen spectrum visualizers, multi-FILE CUE support, file-only metadata, focus-aware playback, and stable/beta update channels — plus a quieter idle app.
Equalizer
- Equalizer as a navigation tab — the full effects UI can now be pinned as a bottom-bar tab. The shipped default is menu, equalizer, songs, settings, and search with labels hidden; saved layouts are never rewritten, and the default is persisted only when no button list exists.
- Embedded paging — when the equalizer is embedded in the main pager, horizontal content swipes pass through to the parent and section changes use the tab bar; standalone behavior is unchanged.
- Strict preset import — manual TXT/JSON imports now validate before applying: unsupported filter types, duplicate or oversized bands, missing preamps, and malformed lines are rejected, while in-range adjustments surface localized warnings. Gain, Q, preamp, and band limits now come from one shared
EqLimitsmodel. - AutoEq Q floor and provenance — the biquad Q floor drops to 0.1 so valid upstream AutoEq 0.18/0.19 filters survive import instead of becoming Q 0.2. Catalog entries retain upstream name, rig, revision, and target metadata, and strict parsing rejects rather than substitutes unsupported values.
- AutoEQ online search feedback — snackbar toasts are replaced by an inline banner for searching, found, and failed states, with a cloud search button, an empty-state fallback, keyboard-aware placement, and stale lookups invalidated when the query or brand changes.
- Reproducible AutoEq catalog — the generator now fetches from a pinned AutoEq commit with SHA-256-checked inputs, stages output outside
assets/, writes reports and manifests, reports upstream omissions instead of guessing, and supports--checkfor byte-identical reruns. - Processing stays DSP — EQ correction is not bit-perfect; existing processing locks, native DSD/DoP handling, and audio routing are unchanged.
Visualizer
- Live PCM spectrum from the engine — a read-only tap on the audio callback computes FFT bars for the High Quality engine, while Standard playback uses Android's Visualizer after microphone permission. Direct USB, DAP native, and native/DoP DSD report unavailable instead of being converted or rerouted.
- Stable spectrum mapping — a 60 dB relative window with log-spaced bands, asymmetric attack/release smoothing, and a corrected capture rate (milliHertz, capped at 30 fps and the device maximum) keep the bars responsive without wild jumps.
- Lock-screen visualizer — an opt-in, off-by-default native Kotlin viewer renders the same six styles, colors, frequency masks, movement preferences, and block trails over the secure keyguard on pure black. It never exposes library, settings, or player navigation, requests no keyguard dismissal, and captures only while visible, awake, and playing.
- Simulated AOD (experimental) — an optional mode wakes the dimmed display over the keyguard while a supported song plays and Display over other apps is granted. It stops after 30 minutes, on low battery, pause or stop, an unsupported route, disabled animations, or when the feature is turned off; it is not system AOD and does not use the panel's low-power state.
- Shared source and status — one reference-counted visualizer source is shared by player surfaces and the lock screen. Offscreen stages stop through
TickerMode, rebuilds no longer restart capture, and settings show the active source plus reduced-motion and unavailable notices.
Audio Analysis
- Read-only source analysis — Audio Signal Path → Source now has an Analyze track action that decodes the source file separately for measurement. Playback, DSP, tags, and the ReplayGain scanner are untouched. Local mono/stereo files that Symphonia can decode are supported; CUE track ranges, native DSD/WavPack, and document-provider paths report why analysis is unavailable.
- Levels, loudness, and tags — the sheet reports integrated LUFS, loudness range, true peak with headroom, estimated dynamic range, sample clipping, per-channel peak/RMS, crest factor, stereo balance, and side/mid, plus decoded duration, file size, sample rate, channels, bit depth, and leading/trailing silence. An existing ReplayGain tag is shown alongside a suggested −18 LUFS gain for comparison only; it is never applied or written.
- Full-track spectrogram — a log-frequency FFT spectrogram spans 20 Hz to Nyquist with All, Left, and Right views, computed during the same background analysis pass. Decoding shows progress and supports cancel and retry, with specific messages for unsupported formats, multichannel files, unreadable files, empty streams, and busy analysis.
Library & Metadata
- Multi-FILE CUE sheets — each
FILEblock parses into its own sheet and resolves to an audio file in its own directory, so one-track-per-file rips no longer collapse onto the last file or collide on the song unique index. Stale references fall back to a unique same-stem sibling, directories are stripped from names, relative paths resolve against the CUE directory, and duplicateINDEXoffsets are skipped. - Scan-time folder paths — MediaStore, SAF quick scans, and directory scans record
relativeFolderPathfrom the actual scan root and backfill legacy rows before the unchanged-file skip. Folder grouping repairs in place for libraries imported with opaque SAF document ids, without changing ids or local edits. - File-only metadata — song actions and metadata sheets now read comment, full recording date, copyright, and label/organization from the file itself. Multiple comments are joined as paragraphs, year-only dates and blank values are hidden, and CUE, external, network, and pathless songs are skipped.
Playback & Performance
- Audio focus ownership — the Rust engine requests focus before play, releases it on manual pause and stop, and serializes interruption pause/resume through the playback queue. An interruption generation prevents a stale end event from resuming after a manual pause or newer interruption, and ducking gain is restored when an interruption ends in stop.
- Managed output lifecycle — shared PCM output relinquishes Android's active media stream on pause and reclaims it on resume, while exclusive and DSD transports keep their stream alive. Play, pause, resume, and stop wait for native completion, the engine manager lock is released while waiting, and state events read native state instead of a queued payload.
- Idle and foreground battery work — engine event polling backs off from 50 ms to 500 ms when paused, idle, or stopped; position checkpoints stop while paused and skip unchanged playlist serialization; progress ticks no longer re-read engine state; full-player position updates throttle at 250 ms; frame timing collection runs only in Developer Mode.
- USB and DSD stop safety — USB volume safety blocks now survive a failed stop and are retried without stale gain, the DAC's verified level is checked against hardware readback when a direct-USB stream starts, and DSD stop retires only the context it observed so a track starting during shutdown keeps its DoP metadata instead of falling back to a plain PCM carrier.
Updates
- Stable and pre-release channels — Settings → App Info → Update Channel now offers Stable (default), Pre-releases, or both for GitHub builds. Release tags are ordered by semver, pre-releases are detected from the tag suffix or the GitHub flag, drafts and releases without an APK are ignored, and the full APK is preferred.
- Separate update notices — Home shows distinct stable and beta banners with channel-appropriate copy, and the settings update check reports the selected channel. Play Store builds keep their existing In-App Update behavior.
Localization
- EQ graph titles, guidance, status chips, and band-family labels, plus file-tag rows, visualizer source and status copy, lock-screen visualizer settings, update-channel copy, and the audio analysis sheet and signal-report entry, are localized across English, Spanish, Taglish, and Chinese. Taglish keeps interactive EQ labels in English through the existing shim.
Under the hood
- Removed the unused
rivedependency and its transitive native packages, pinnedpubspec.lockresolution for Flutter 3.50 stable, marked Replay Gain as implemented in the feature list, and documented AutoEq maintenance, source-analysis scope, lock-screen visualizer behavior, CUE and folder-path scanning, and front-end battery work. - Added the read-only source-analysis job, FFT spectrogram, loudness and true-peak measurements, and generated bindings to the Rust bridge, with tests for analysis and USB/DSD stop safety.
Builds & Flavors
- This GitHub download uses the
fullflavor — it declares All Files Access (MANAGE_EXTERNAL_STORAGE) for the raw Rust filesystem scanner and complete DSD/WavPack coverage. Build:flutter build apk --flavor full --release. - Google Play uses the
playflavor — no All Files Access (Play policy for media apps); it scans via MediaStore/SAF plus the DSD/DSF/WavPack reconciliation path. Build:flutter build appbundle --flavor play --release. - Both flavors share
applicationIdcom.mossapps.flick, so either installs over the other.
Getting Started
- Equalizer tab: Settings → Interface → Bottom Bar, or tap the equalizer icon in the default bottom bar.
- Audio analysis: open the player's Audio Signal Path → Source → Analyze track. CUE tracks, native DSD/WavPack, and document-provider paths show why analysis is unavailable.
- AutoEQ: open the equalizer → Presets → AutoEQ headphones; use the cloud button to search upstream for a model that is not bundled.
- Visualizer: Settings → Interface → Visualizer → enable Visualizer. High Quality playback uses the engine FFT; Standard playback uses Android's Visualizer and asks for microphone permission.
- Lock-screen visualizer: Settings → Interface → Visualizer → Lock-screen visualizer → Open visualizer screen, then lock and wake the phone. Simulated AOD is the experimental toggle below it.
- Update channel: Settings → App Info → Update Channel → Stable, Pre-releases, or both.
- Library repair: run Settings → Library → Rescan Library once to split multi-FILE CUE sheets and backfill folder paths on existing rows.
- File-only tags: open a song's actions or metadata sheet; comment, full date, copyright, and label appear when the file contains them.