zarzet 76fe8dbc69 feat: add CUE sheet support for local library scanning and splitting (#201)
Parse .cue files in library scanner (Go + SAF) to display individual
tracks instead of one large audio file. Add FFmpeg-based CUE splitting
to extract tracks into separate FLAC files with embedded metadata and
cover art.

- Go: CUE parser, two-pass scan (CUE first, skip referenced audio),
  virtual paths (cue#trackNN) for DB UNIQUE constraint, audioDir
  override for SAF temp-file scenarios
- Android: SAF scanner recognizes .cue in both full and incremental
  scan, copies .cue+audio to temp for Go parsing, unchanged-CUE audio
  sibling dedup, parseCueSheet handler resolves SAF audio siblings
- Dart: FFmpegService.splitCueToTracks, CUE split UI in track metadata
  screen, persistent output dir for SAF splits with write-back
- CUE virtual path normalization across fileExists/fileStat/deleteFile/
  openFile; play/share/open blocked for virtual tracks with guidance to
  split first; delete only removes DB entry, not shared .cue file
- iOS: parseCueSheet handler
- Localization: 12 new CUE-related strings

Requested by @Seerafimm
Closes #201
2026-03-11 00:31:20 +07:00

GitHub All Releases VirusTotal Crowdin

Download music in true lossless FLAC from Tidal, Qobuz & Deezer — no account required.

Android iOS

Download

Screenshots

Extensions

Extensions allow the community to add new music sources and features without waiting for app updates. When a streaming service API changes or a new source becomes available, extensions can be updated independently.

Installing Extensions

  1. Go to Store tab in the app
  2. Browse and install extensions with one tap
  3. Or download a .spotiflac-ext file and install manually via Settings > Extensions
  4. Configure extension settings if needed
  5. Set provider priority in Settings > Extensions > Provider Priority

Developing Extensions

Want to create your own extension? Check out the Extension Development Guide for complete documentation.

Other project

SpotiFLAC (Desktop)

Download music in true lossless FLAC from Tidal, Qobuz & Amazon Music for Windows, macOS & Linux

Telegram

Telegram Channel Telegram Community

FAQ

Q: Why is my download failing with "Song not found"?
A: The track may not be available on the streaming services. Try enabling more download services in Settings > Download > Provider Priority, or install additional extensions like Amazon Music from the Store.

Q: Why are some tracks downloading in lower quality?
A: Quality depends on what's available from the streaming service and extensions. Built-in providers: Tidal offers up to 24-bit/192kHz, Qobuz up to 24-bit/192kHz, and Deezer up to 16-bit/44.1kHz.

Q: Can I download playlists?
A: Yes! Just paste the playlist URL in the search bar. The app will fetch all tracks and queue them for download.

Q: Why do I need to grant storage permission?
A: The app needs permission to save downloaded files to your device. On Android 13+, you may need to grant "All files access" in Settings > Apps > SpotiFLAC > Permissions.

Q: Is this app safe?
A: Yes, the app is open source and you can verify the code yourself. Each release is scanned with VirusTotal (see badge at top of README).

Q: Why is download not working in my country?
A: Some countries have restricted access to certain streaming service APIs. If downloads are failing, try using a VPN to connect through a different region.

Want to support SpotiFLAC-Mobile?

If this software is useful and brings you value, consider supporting the project. Your support helps keep development going.

Ko-fi

API Credits

hifi-api · music.binimum.org · qqdl.site · squid.wtf · spotisaver.net · dabmusic.xyz · AfkarXYZ · LRCLib · Paxsenix · Cobalt · qwkuns.me · SpotubeDL · Song.link · IDHS

Tip

Star Us, You will receive all release notifications from GitHub without any delay ~

Languages
Dart 71.7%
Go 16.7%
HTML 7.2%
Kotlin 3.3%
Swift 1%