SpotiFLAC-Mobile README

The project's README from github.com/spotiflacapp/SpotiFLAC-Mobile. As one markdown file: README.md.

SpotiFLAC Mobile

spotiflacapp%2FSpotiFLAC-Mobile | Trendshift

GitHub Release Crowdin

Telegram Channel Telegram Community

Screenshots

Extensions

Extensions let the community 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. Open the Store tab in the app
  2. On first launch, enter an Extension Repository URL when prompted
  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 under Settings > Extensions > Provider Priority

Developing Extensions

[!NOTE] Want to build your own extension? Start with the Extension Development Guide. The documentation site contains the expanded API reference.

Development

SpotiFLAC Mobile combines a Flutter/Dart UI, a Go backend compiled with gomobile, and thin Android/iOS platform bridges. Toolchain versions are pinned in .fvmrc, go_backend/go.mod, and the GitHub Actions workflows.

Start with the Contributing Guide for the development setup, project boundaries, validation commands, and pull request checklist.

SpotiFLAC (Desktop)

Download music in true lossless FLAC from extension-provided sources on Windows, macOS & Linux.

SpotiFLAC (Python Module)

Python library for SpotiFLAC integration, maintained by @ShuShuzinhuu.

FAQ

Why does the Store tab ask me to enter a URL?

Starting from version 3.8.0, SpotiFLAC Mobile uses a decentralized extension repository system. Extensions are hosted independently rather than on a built-in server, so anyone can create and host a compatible repository. Enter a repository URL in the Store tab to browse and install extensions.

Why is my download failing with "Song not found"?

The track may not be available from your enabled providers. Try enabling more providers under Settings > Extensions > Provider Priority, or install additional download extensions from the Store.

Why are some tracks downloading in lower quality?

Quality depends on what's available from the source and the installed download extension. Check each extension's quality options and service notes in the app.

Can I download playlists?

Yes! Just paste the playlist URL in the search bar. The app will fetch all tracks and queue them for download.

Why do I need to grant storage permission?

The app needs a writable destination for downloaded files. On Android, choose a folder with the system folder picker (SAF), or use the app-specific folder. If Android revokes a saved folder grant, select the folder again in Settings.

Is this app safe?

SpotiFLAC Mobile is open source, so its code and build workflows can be inspected directly in this repository.

Why is downloading not working in my country?

Some countries have restricted access to certain streaming service APIs. If downloads are failing, try using a VPN to connect through a different region.

Can I add SpotiFLAC Mobile to AltStore or SideStore?

Yes! Add the official source to receive updates directly within the app. Copy this link:

https://raw.githubusercontent.com/spotiflacapp/SpotiFLAC-Mobile/refs/heads/main/apps.json

In AltStore/SideStore, go to Browse > Sources, tap +, and paste the link.

[!NOTE] If SpotiFLAC Mobile is useful to you, consider supporting development:

Ko-fi

Contributors

Thanks to everyone who has contributed to SpotiFLAC Mobile!

We also appreciate everyone who helped with translations on Crowdin, reported bugs, suggested features, and spread the word.

Interested in contributing? Check out the Contributing Guide to get started!

API Credits
MusicDL LRCLib Paxsenix Cobalt Song.link
UniTune MusicBrainz Squigly

Disclaimer

This repository and its contents are provided strictly for educational and research purposes. The software is provided "as-is" without warranty of any kind, express or implied, as stated in the MIT License.

[!TIP] Star the repo to get notified about all new releases directly from GitHub.

SpotiFLAC-Mobile (spotiflacapp/SpotiFLAC-Mobile)

Searching Database…

6.8K ·GitHub
SpotiFLAC-Mobile
Что это такое?SpotiFLAC Mobile — приложение с открытым исходным кодом для Android и iOS, которое скачивает музыку в формате FLAC без потерь из нескольких источников. Интерфейс написан на Flutter, серверная часть — на Go. Без рекламы и подписки.
Есть ли десктопная версия или это только для телефона?Это мобильное приложение (Android/iOS). Загрузки FLAC без потерь на Windows, macOS и Linux обеспечивает отдельный проект SpotiFLAC Desktop. Также есть Python-модуль, который поддерживает участник сообщества.
Как настроить источники музыки в приложении?Откройте вкладку Store, при первом запуске введите Extension Repository URL, затем выбирайте и устанавливайте расширения для загрузки одним нажатием (или установите файл .spotiflac-ext вручную через Settings > Extensions).
Нужно ли что-то установить, прежде чем скачивать песни?Да. В приложении нет встроенного источника музыки: расширения, которые отвечают за загрузку, размещаются отдельно и должны быть установлены по ссылке на репозиторий, прежде чем заработают поиск и загрузка.
Загрузка всегда работает?Нет. Трек может не загрузиться с ошибкой 'Song not found', если его нет у включённых провайдеров. Качество зависит от того, что предлагает источник установленного расширения.
Как установить на iOS, если приложения нет в App Store?Пользователи iOS устанавливают приложение в обход App Store, добавляя официальный источник в AltStore или SideStore. Через них же потом приходят обновления внутри приложения.
Это законно и безопасно?Проект распространяется по лицензии MIT с открытым исходным кодом, поэтому его код и процессы сборки можно проверить. Авторы прямо заявляют, что не размещают защищённый авторским правом контент, а приложение предоставляется в образовательных и исследовательских целях. Ответственность за законность использования лежит на пользователе.
Можно скачать целые плейлисты, а не только отдельные треки?Да. Вставьте ссылку на плейлист в строку поиска, и приложение добавит в очередь на загрузку каждый трек из него.
Почему загрузки могут не работать в моей стране?Некоторые страны блокируют API стриминговых сервисов, на которые опираются расширения. Поэтому в FAQ предлагается подключаться через VPN с другим регионом, если загрузки продолжают не работать.
Что будет, если источник музыки перестанет работать?Источники находятся в отдельно размещённых расширениях, а не внутри приложения, поэтому сообщество может починить или заменить неработающего провайдера без ожидания обновления приложения.
What are similar projects?spotube, openspot-music-app, SpotiFLAC, SpotiFLAC-Next, BitChord, mangayomi, venera, dart_simple_live
Which topics is it in?lossless, flac, music-downloader, piracy, extension, dart, flutter, downloader, music, censorship-circumvention, app, mobile-app
Creator
spotiflacapp
Size
172.2 MB
Stars
6.8K
Updated
CommitOct 11Releasev5.1.1Oct 11
Age
9mo
Commits · 90 Days