Welcome to the Fergejo (NavidromePlayer) Wiki.
Fergejo is a native iOS + watchOS music player built for Navidrome servers. It is built entirely with SwiftUI and AVFoundation, featuring a Mitsuha-style audio visualizer, an Apple Watch companion app, live radio streaming, and an optional Python-based Companion API for advanced server-side features.
Requirements
- iOS 26.0+ / watchOS 26.0+
- Xcode 26+
- XcodeGen (
brew install xcodegen)
- Navidrome server (Any version with Subsonic API support)
Building the App
- Clone the repository.
- Run the generation script to resolve dependencies (including ZIPFoundation via SPM) and open Xcode:
./generate.sh
- Set your Apple Developer Team ID in
project.yml under DEVELOPMENT_TEAM.
- Select your target device and build.