Fmusic - A Lightweight Open-Source macOS Local Music Player

Application Overview

Fmusic is an open-source local music player developed using the SwiftUI framework, specifically designed for macOS. It features a modern interface and focuses on delivering a clean, efficient music playback experience, supporting parsing and playback of multiple audio formats.

Core Features

🎵 Audio Support

• Multi-Format Compatibility: Perfectly supports FLAC, MP3, WAV, M4A, AIF, M4R, and other audio formats
• Metadata Parsing: Automatically extracts album information, artist details, and album cover images from audio files
• Track Sorting: Intelligently sorts tracks by album name and track number to maintain original album sequence

🎨 User Interface

• Modern Design: Built with SwiftUI, offering a clean and visually appealing interface
• Collapsible Sidebar: Flexible layout options to adapt to different usage scenarios
• Playback Progress Control: Supports dragging with mouse to adjust playback progress for intuitive operation
• Lyrics Display: Displays synchronized lyrics with karaoke effect (requires lyric files with time tags)

🔧 Playback Functionality

• Multiple Playback Modes: Sequential, repeat, shuffle, and single-song loop playback modes
• Quick Song Switching: Double-click on songs in the list to switch tracks
• Volume Control: Built-in volume adjustment for music playback
• Favorite Songs: Simple song collection management

📁 File Management

• Multiple Import Methods: Supports importing music folders via icon click, menu options, or keyboard shortcut (⌘ + O)
• Metadata Editing: Right-click menu allows editing song metadata (title, album, artist, track number), with changes saved directly to the audio file
• File Details View: View detailed file information, path, and support for quick renaming
• Library Management: Supports clearing the music library (via menu or icon button)

🔍 Search Function

• Smart Search: Supports fuzzy matching for song titles, artists, and album names

Technical Advantages

Open Source & Free

• MIT License: Fully open-source, allowing free use, modification, and distribution
• Transparent Development: Code hosted on GitHub with publicly visible development process

Modern Architecture

• SwiftUI Development: Built with Apple’s latest UI framework for excellent performance and smooth interface
• Native Experience: Deeply integrated with macOS system features for a native user experience

Regular Updates

• Active Maintenance: Regular updates from the development team with multiple released versions
• Issue Response: Comprehensive FAQ and technical support available

Secure and Reliable

• Notarized Signature: Starting from v1.1.0, the DMG installer is signed and notarized by Apple
• Easy Installation: No local compilation required; users can download and install directly

System Requirements

• Minimum OS: macOS 11.0 (Big Sur)
• Development Environment: Xcode 13.4.1 or later
• Hardware Compatibility: Fully supports Macs with M1/M2/M3 chips; partial support for Intel Macs

Installation & Usage

Installation Steps

1. Download the latest DMG file from the GitHub Releases page
2. Drag Fmusic to the Applications folder
3. If prompted by security restrictions, use Terminal to remove quarantine attributes:

   sudo xattr -d com.apple.quarantine /Applications/Fmusic.app
   

Getting Started

1. After first launch, use ⌘ + O to import your music folder
2. Double-click a song in the list to start playback
3. Right-click a song to edit metadata or view file details
4. Configure preferred playback mode and interface layout in settings

Target Users

• Music lovers seeking a clean and minimal playback experience
• Users with large local music collections
• Audiophiles who prefer lossless formats like FLAC
• macOS users who support open-source software
• Developers learning or researching SwiftUI

Important Notes

• Playlist functionality is not yet implemented; developers plan to add it in future updates
• Users requiring macOS 10.15 compatibility can refer to the dedicated compatibility repository
• Lyric files are automatically saved in the ~/Music/Lyrics directory

Fmusic, with its minimalist design, comprehensive local music playback features, and open-source nature, stands out as a worthy music player choice for macOS users. Whether for daily use or as a SwiftUI learning reference, it offers an excellent user experience.