mirror of
https://github.com/zarzet/SpotiFLAC-Mobile.git
synced 2026-06-10 08:33:57 +02:00
zarzet
f58005f406
Add auto-generated contributor avatars via contrib.rocks with a link to the GitHub contributors page. Include acknowledgement for translators and bug reporters.
112 lines
6.0 KiB
Markdown
112 lines
6.0 KiB
Markdown
<div align="center">
|
|
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="assets/images/banner-readme-dark.png">
|
|
<source media="(prefers-color-scheme: light)" srcset="assets/images/banner-readme-light.png">
|
|
<img alt="SpotiFLAC Mobile" src="assets/images/banner-readme-light.png" width="650" height="auto">
|
|
</picture>
|
|
|
|
<p align="center">
|
|
<a href="https://trendshift.io/repositories/17247">
|
|
<img src="https://trendshift.io/api/badge/repositories/17247" alt="zarzet%2FSpotiFLAC-Mobile | Trendshift" width="250" height="55">
|
|
</a>
|
|
</p>
|
|
|
|
</div>
|
|
|
|
## Screenshots
|
|
|
|
<p align="center">
|
|
<img src="assets/images/1.jpg?v=2" width="200" />
|
|
<img src="assets/images/2.jpg?v=2" width="200" />
|
|
<img src="assets/images/3.jpg?v=2" width="200" />
|
|
<img src="assets/images/4.jpg?v=2" width="200" />
|
|
</p>
|
|
|
|
<div align="center">
|
|
|
|
[](https://github.com/zarzet/SpotiFLAC-Mobile/releases)
|
|
[](https://www.virustotal.com/gui/file/63a445a956fa71ea347ad3695a62d543e14e341933326b9dbb9a15d79614ef58)
|
|
[](https://crowdin.com/project/spotiflac-mobile)
|
|
|
|
[](https://t.me/spotiflac)
|
|
[](https://t.me/spotiflac_chat)
|
|
|
|
</div>
|
|
|
|
## 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. When opening the Store for the first time, you will be asked to enter an **Extension Repository URL**
|
|
3. Browse and install extensions with one tap
|
|
4. Or download a `.spotiflac-ext` file and install manually via **Settings > Extensions**
|
|
5. Configure extension settings if needed
|
|
6. Set provider priority in **Settings > Extensions > Provider Priority**
|
|
|
|
### Developing Extensions
|
|
Want to create your own extension? Check out the [Extension Development Guide](https://zarzet.github.io/SpotiFLAC-Mobile/docs) for complete documentation.
|
|
|
|
## Other project
|
|
|
|
### [SpotiFLAC (Desktop)](https://github.com/afkarxyz/SpotiFLAC)
|
|
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._
|
|
|
|
[](https://ko-fi.com/zarzet)
|
|
|
|
## Contributors
|
|
|
|
Thanks to all the amazing people who have contributed to SpotiFLAC Mobile!
|
|
|
|
<a href="https://github.com/zarzet/SpotiFLAC-Mobile/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=zarzet/SpotiFLAC-Mobile" />
|
|
</a>
|
|
|
|
We also appreciate everyone who has helped with [translations on Crowdin](https://crowdin.com/project/spotiflac-mobile), reported bugs, suggested features, and spread the word about SpotiFLAC Mobile.
|
|
|
|
Interested in contributing? Check out our [Contributing Guide](CONTRIBUTING.md) to get started!
|
|
|
|
## API Credits
|
|
|
|
[hifi-api](https://github.com/binimum/hifi-api) · [music.binimum.org](https://music.binimum.org) · [qqdl.site](https://qqdl.site) · [squid.wtf](https://squid.wtf) · [spotisaver.net](https://spotisaver.net) · [dabmusic.xyz](https://dabmusic.xyz) · [AfkarXYZ](https://github.com/afkarxyz) · [LRCLib](https://lrclib.net) · [Paxsenix](https://lyrics.paxsenix.org) · [Cobalt](https://cobalt.tools) · [qwkuns.me](https://qwkuns.me) · [SpotubeDL](https://spotubedl.com) · [Song.link](https://song.link) · [IDHS](https://github.com/sjdonado/idonthavespotify)
|
|
|
|
|
|
> [!TIP]
|
|
>
|
|
> **Star Us**, You will receive all release notifications from GitHub without any delay
|