Download

Latest version: v1.0.0

Available for Windows, macOS, and Linux.

Windows

• OS: Windows 10/11 64-bit
• RAM: 4GB or more
• Disk: 200MB or more

Download Installer · Download Portable

macOS

• OS: macOS 10.15+
• Chip: Intel or Apple Silicon
• RAM: 4GB or more

Download Intel · Download Apple Silicon

Linux

• OS: Ubuntu 20.04+ / Fedora 36+
• Requires FUSE support
• RAM: 4GB or more

Download AppImage · Download DEB

Build from Source

# Clone repository
git clone https://github.com/your-username/gz-music-player.git
cd gz-music-player

# Install dependencies
npm install

# Development mode
npm run dev

# Build for production
npm run build

# Package installer
npm run dist:win   # Windows
npm run dist:mac   # macOS
npm run dist:linux # Linux

Installation

Windows

1. Download the installer
2. Double-click the .exe file to run the installer
3. Launch from the Start Menu or desktop shortcut

macOS

1. Download the DMG for your chip
2. Open the DMG and drag the app to Applications
3. Right-click and select "Open" on first launch to bypass Gatekeeper

Linux

1. Download the AppImage or DEB package
2. For AppImage, add execute permission: chmod +x guazi-music-*.AppImage
3. Double-click to run or launch from terminal