12be560cb8
Add FFmpegService.embedMetadataToM4a() for writing tags and cover art into M4A files via FFmpeg. Fix two bugs in the same function: - Remove '-disposition:v:0 attached_pic' which is only valid for Matroska/WebM containers and causes FFmpeg to error on MP4/M4A - Apply same fix to _convertToAlac which had the identical issue Add M4A handling (isM4A branch) to all four embed call-sites: track_metadata_screen (lyrics embed, re-enrich, edit metadata sheet, format conversion), queue_tab, local_album_screen, and downloaded_album_screen. Add 'LYRICS'/'UNSYNCEDLYRICS' to _mapMetadataForTagEmbed so existing lyrics survive a re-enrich cycle on M4A/MP3/Opus files. Preserve existing lyrics before overwriting tags in the edit metadata sheet (best-effort readFileMetadata before FFmpeg pass). Extract mergePlatformMetadataForTagEmbed() into lyrics_metadata_helper to deduplicate the identical metadata-mapping loops that existed in queue_tab, local_album_screen, downloaded_album_screen, and track_metadata_screen. Wire ensureLyricsMetadataForConversion into the format conversion path in track_metadata_screen so lyrics are carried through conversions. Add ISRC and LABEL/ORGANIZATION mappings to _convertToM4aTags.
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
- Go to Store tab in the app
- When opening the Store for the first time, you will be asked to enter an Extension Repository URL
- Browse and install extensions with one tap
- Or download a
.spotiflac-extfile and install manually via Settings > Extensions - Configure extension settings if needed
- 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
FAQ
Q: Why does the Store tab ask me to enter a URL?
A: Starting from version 3.8.0, SpotiFLAC uses a decentralized extension repository system — extensions are hosted on GitHub repositories rather than a built-in server, so anyone can create and host their own. Enter a repository URL in the Store tab to browse and install extensions.
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.
Q: Can I add SpotiFLAC to AltStore or SideStore? A: Yes! You can add the official source to receive updates directly within the app. Just copy this link: https://raw.githubusercontent.com/zarzet/SpotiFLAC-Mobile/refs/heads/main/apps.json In AltStore/SideStore, go to the Browse tab, tap Sources at the top, then tap the + icon and paste the link.
Want to support SpotiFLAC-Mobile?
If this software is useful and brings you value, consider supporting the project. Your support helps keep development going.
Contributors
Thanks to all the amazing people who have contributed to SpotiFLAC Mobile!
We also appreciate everyone who has helped with translations on Crowdin, reported bugs, suggested features, and spread the word about SpotiFLAC Mobile.
Interested in contributing? Check out our Contributing Guide to get started!
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