Formerly SwiftFlac; the Xcode project keeps that name.
Minimalist local music player for iOS, iPadOS, and macOS. Built with SwiftUI and first-party Apple frameworks. Plays FLAC, MP3, M4A/AAC, ALAC, WAV, and AIFF.
FLAC remains the primary supported format
WAV and AIFF files typically carry no embedded tags or cover art, so they show up with filename-based titles and a placeholder cover.
The now-playing screen can show each file's format, bit depth, sample rate, and bitrate, for example FLAC · 24-bit / 96 kHz · 2,304 kbps (toggle in Settings).
Folders are playlists: point it at a music folder and each subfolder becomes a playlist, with album, artist, and all-track views built from the files' own tags and embedded cover art.
Siri and Shortcuts can play or shuffle a folder, album, or artist ("Play Road Trip in Flackbird", "Shuffle my library in Flackbird") and turn shuffle or repeat on and off. If Siri says Flackbird doesn't support a request, open Flackbird's page in the Shortcuts app (Settings → Siri & Shortcuts links there), tap ⓘ at the top right, and turn on Siri.
| Light | Dark |
|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
Screenshots use a generated demo library (original cover art, synthesized audio, fictional names) and are App Store sizes: iPhone 6.9" (1320x2868), iPad 13" landscape (2752x2064), and Mac 16:10. Regenerate them with ./take_screenshots.sh (needs ffmpeg; rotate the iPad Pro 13-inch simulator to landscape in DeviceHub first, and the Mac captures need Screen Recording access for your terminal); ./take_screenshots.sh qa adds layout checks in both orientations under build/screenshot-qa.
Requires Xcode 26 on macOS.
./build_and_run_mac.sh # build and launch the macOS app
./build_and_run_ios.sh # build, install, and launch in an iPhone simulatorThe iOS script seeds a Music/ folder at the repo root (gitignored) into the simulator app's Documents, so drop music there - subfolders become playlists - to have a library ready on first launch. On a real device, add music through Finder/Files file sharing or the in-app folder picker.
The app icon source is swiftflac-icon.svg; run ./generate_icon.sh after editing it to regenerate the asset catalog images.
The macOS 26 Dock shows a generic placeholder icon for apps launched from build directories, including the one build_and_run_mac.sh produces. The real icon appears when the app runs from /Applications or ~/Applications; nothing else is affected.
A free Apple ID is enough, no paid developer account needed:
- Xcode → Settings → Accounts → add your Apple ID (creates a free Personal Team).
- On the iPhone: Settings → Privacy & Security → Developer Mode → on (restarts the phone). Connect it by cable once and tap Trust.
- Open the project in Xcode, target → Signing & Capabilities → tick "Automatically manage signing" and pick your team.
- Select the iPhone as run destination and hit Run. On first launch, trust the certificate on the phone under Settings → General → VPN & Device Management.
Free-account builds expire after 7 days; hit Run again to re-sign. Add music via Finder file sharing (iPhone → Files → Flackbird) and rescan from Settings (the gear icon).
In Xcode, select the SwiftFlac scheme and press Command-U. The default Core plan tests metadata, audio formats, library discovery/grouping, playback, persistence, search/navigation policy, and artwork with isolated files and preferences.
xcodebuild test -project SwiftFlac.xcodeproj -scheme SwiftFlac -testPlan Core -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NOGitHub Actions runs this suite, an iOS Simulator build, and a SwiftFormat lint check for pull requests targeting main, using GitHub's Xcode 27 preview runner. No UI automation, physical phone, or developer account is required. See test scope.
Formatting is checked with SwiftFormat 0.63.0; run swiftformat SwiftFlac Tests --lint locally, or drop --lint to apply fixes.
MIT - see LICENSE.