In 2025, Local Music on iPhone Is a Nightmare—So I Built My Own Way Out
## Custom Music Player Development for iOS
Custom Music Player Development for iOS
In 2025, playing personal music on an iPhone presents challenges, primarily due to Apple's restrictions. This situation led to the development of a custom music player featuring full text search , iCloud support , and a local-first experience . The project is available on GitHub .
Technical Challenges with Existing Solutions
Apple's native apps offer limited functionality for offline music playback. The Files app lacks features like playlist management and metadata sorting, impacting user experience. Third-party apps often utilize subscription models, which are not ideal for apps that play locally owned files. An example is the app Doppler, which offers a single payment model but has limitations in import functionality and search capabilities.
The custom music player was developed using SwiftUI for its clean, declarative UI. The app architecture employs SQLite for persistent data storage, offering tight control over schema and queries, and enabling full-text search. The app consists of three main screens: library import, library management, and playback. These allow users to manage and play their music collections efficiently.
The app employs a backend-like architecture with a clear separation between domain logic and UI layers. The use of SQLite with FTS5 capabilities enables fast fuzzy search across the music library without external dependencies.
In 2025, playing personal music on an iPhone presents challenges, primarily due to Apple's restrictions.
On iOS, persistent bookmarks are used for file management, with a fallback mechanism that copies files into the app's sandbox to avoid access issues. This ensures reliable access and indexing of music files.
Playback functionality leverages Apple's AVFoundation framework. The implementation includes features such as queue management, shuffle, and repeat, integrating with system-level controls through MPRemoteCommandCenter .
The development process highlighted limitations in Xcode and iOS's handling of app deployments, particularly for personal projects. Despite these challenges, the project demonstrates the potential for custom solutions to overcome platform restrictions.
iTunes Match – Apple Support Security-Scoped Bookmarks – Apple Docs FTS5 – SQLite Documentation Doppler Music Player – App Store Expo FileSystem Documentation Apple Developer Program Info
Based on reporting by hackernoon.com.
