SpotiFLAC Mobile Documentation

To receive updates directly within AltStore or SideStore, add the official SpotiFLAC source using the following JSON URL:

1. Copy the URL below.
2. In AltStore/SideStore, go to Browse > Sources.
3. Tap + and paste the link.

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

Extensions allow you to add new music sources and features. You can install them using the in-app Store or by manually providing a file.

Via the Store

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.

Via Manual File

1. Download a .spotiflac-ext file.
2. Navigate to Settings > Extensions to install it manually.

Configuration

• Configure specific extension settings within the app if required.
• Set the order of providers under Settings > Extensions > Provider Priority to manage which source is used first.

To create an extension for SpotiFLAC, you must provide a JSON manifest that conforms to the ExtensionManifest schema. This manifest defines the extension's identity, capabilities, permissions, and configuration settings.

Key requirements:

• name: A lowercase extension ID containing only letters, numbers, '.', '_', or '-'.
• type: Must include at least one of metadata_provider, download_provider, or lyrics_provider.
• permissions: Defines access to network, storage, and file systems.
• settings: An array of ExtensionSetting objects to allow user configuration.

Use ParseManifest(data []byte) to validate and load the manifest from JSON data.

The extension runtime enforces a maximum response body size of 16 MB (16 << 20 bytes).

If a response exceeds this limit, the request will fail with an error message: response body exceeds 16777216 byte limit; use file.download for large media. For handling large media files, use the file.download mechanism instead of standard HTTP responses.

Use SetExtensionFallbackProviderIDs to restrict which extension providers are allowed to act as fallbacks.

• To set a specific list, pass a slice of provider IDs. The list is sanitized to remove whitespace and duplicates.
• To reset to the default behavior (allowing all enabled download extensions), pass nil.

Use GetExtensionFallbackProviderIDs to retrieve the current list, and isExtensionFallbackAllowed (internal logic used by the system) to check if a specific provider is in the allowed list.

Perform a comprehensive search across tracks, artists, albums, and playlists. You can use the filter parameter to restrict results to a specific type.

Filter options:

• track: Returns up to 50 tracks.
• artist: Returns up to 20 artists.
• album: Returns up to 20 albums.
• playlist: Returns up to 20 playlists.

If no filter is provided, the method returns a mix of results (up to 5 playlists, 5 albums, etc.).

Extracts metadata and audio quality information from various audio file formats including FLAC, M4A, MP3, Ogg/Opus, APE, WAV, and AIFF. The function returns a JSON string containing the metadata fields.

Supported metadata fields in the output JSON:

• title, artist, album, album_artist, date, genre, label, copyright, composer, comment, isrc, lyrics
• track_number, total_tracks, disc_number, total_discs
• duration, format, audio_codec, bitrate, sample_rate, bit_depth