WiiM Control

A native macOS menu bar app for controlling WiiM audio devices.

Features

• Multi-Device Support - Switch between multiple WiiM devices on your network
• Now Playing - Album art, track info, and artist display
• Playback Controls - Play/pause, previous, next
• Volume Control - Slider with mute toggle
• Seek Bar - Track progress with drag-to-seek
• Presets - Quick access to saved radio stations with artwork
• EQ Presets - Switch between equalizer presets
• Info Panel - Artist bios and album details from Last.fm and Discogs
• Mini Mode - Compact view with essential controls
• Immersive Mode - Full album art with floating controls
• Auto Discovery - Finds WiiM devices on your network automatically

Installation

Option 1: DMG (Recommended)

1. Download WiiMControl.dmg from Releases
2. Open the DMG and drag WiiMControl.app to Applications
3. Right-click → Open (first launch only, to bypass Gatekeeper)

Option 2: ZIP

1. Download WiiMControl.zip from Releases
2. Unzip and drag WiiMControl.app to Applications
3. Right-click → Open (first launch only, to bypass Gatekeeper)

User Guide

Getting Started

Click the speaker icon in your menu bar to open the control panel. The app automatically discovers WiiM devices on your network and can also control local media apps like Spotify.

Player Controls

• Play/Pause - Large center button
• Previous/Next - Skip tracks
• Volume - Drag the slider or click the speaker icon to mute
• Seek Bar - Drag to jump to any position in the track

Using Presets

Access your saved radio stations and playlists:

1. Click on Presets at the bottom of the player
2. Click any preset to start playing
3. Preset artwork appears on the main display

EQ Presets

Switch between equalizer presets:

1. Click on EQ at the bottom of the player
2. Select an equalizer preset from the list
3. The current EQ is shown below the device name

Info Panel

View artist biographies and album details:

1. Click on Info at the bottom of the player
2. View artist bio from Last.fm
3. See album details and release info from Discogs
4. Info updates automatically when the track changes

Mini Mode

Switch to a compact view with essential controls:

1. Click the collapse button (↘) in the top-right corner
2. Mini mode shows track info, playback controls, and volume
3. Click the expand button (↗) to return to full mode

Immersive Mode

Click the album art to enter immersive mode:

1. Click on the album art in the player
2. Full-screen album art with floating playback controls
3. Click anywhere to return to normal view

Switching Devices

Easily switch between multiple WiiM devices:

1. Click on the device name at the top of the player
2. Select any WiiM device discovered on your network

Quitting the App

Click the X button in the top-left corner of the panel.

Requirements

• macOS 14.0 (Sonoma) or later
• WiiM device on the same local network

Building from Source

git clone https://github.com/xon94010/WiiMControl.git
cd WiiMControl
open WiiMMenuBar.xcodeproj

API Keys Setup

The Info panel features require API keys from Discogs and Last.fm. To enable these:

1. Copy the template: cp Secrets.xcconfig.template Secrets.xcconfig
2. Get your free API keys:
   • Discogs: https://www.discogs.com/settings/developers
   • Last.fm: https://www.last.fm/api/account/create
3. Edit Secrets.xcconfig and add your keys

The app works without these keys - the Info panel will just be disabled.

Build and run with ⌘R in Xcode.

Project Structure

The codebase follows a modular architecture with views organized by functionality:

WiiMMenuBar/
├── WiiMMenuBarApp.swift        # App entry point
├── MenuBarView.swift           # Main routing (minimal)
├── WiiMService.swift           # WiiM device communication
├── PlayerState.swift           # Player state management
├── DeviceDiscovery.swift       # Network device discovery
├── MediaCoordinator.swift      # Multi-source orchestration
├── MediaSource.swift           # Source protocol & types
├── WiiMMediaSource.swift       # WiiM source adapter
├── LocalMediaSource.swift      # Local media (Spotify, etc.)
├── DiscogsService.swift        # Discogs API integration
├── LastFMService.swift         # Last.fm API integration
├── LaunchAtLogin.swift         # Login item helper
└── Views/
    ├── Player/
    │   ├── FullModeView.swift      # Full player UI
    │   ├── MiniModeView.swift      # Compact player UI
    │   ├── PlaybackControls.swift  # Play/pause/skip buttons
    │   ├── VolumeControl.swift     # Volume slider + mute
    │   ├── SeekBar.swift           # Progress bar with seeking
    │   ├── AlbumArtView.swift      # Album artwork display
    │   └── SourceIndicator.swift   # Source icon display
    ├── Tabs/
    │   ├── BottomTabsSection.swift # Presets/EQ/Info tabs
    │   ├── InfoPanelView.swift     # Artist & album info
    │   ├── PresetRowView.swift     # Preset list item
    │   └── EQRowView.swift         # EQ preset item
    └── Setup/
        ├── SetupView.swift         # Device discovery screen
        └── DeviceRow.swift         # Device list item

Troubleshooting

Device not found?

• Ensure your Mac and WiiM are on the same network
• Click the refresh button to scan again
• Check that your firewall allows local network access

Album art not loading?

• Album art is fetched from iTunes for music tracks
• Radio station artwork comes from the preset configuration

Controls not responding?

• Check the connection indicator (green dot = connected)
• Try disconnecting and reconnecting

License

MIT License - see LICENSE for details.

Credits

Built with SwiftUI for macOS.

• Album art powered by iTunes Search API
• Artist bios powered by Last.fm
• Album details powered by Discogs