Release & Updates

imux ships through two release channels and updates itself automatically via Sparkle. This page covers the channel differences, the update mechanism, and how to verify your installed version.

Stable vs NIGHTLY Channels

imux offers two release channels with different risk profiles:

Stable — Tagged releases from the main branch. These builds have passed CI, unit tests, and quality sweeps. Recommended for daily use.
NIGHTLY — Built automatically from the latest commit on main. Provides early access to new features but may contain incomplete functionality or bugs.

The NIGHTLY build has its own bundle ID (com.icc.icc.nightly) and installs alongside the stable version. You can run both simultaneously without conflicts.

Auto-Update via Sparkle

imux uses the Sparkle framework for automated updates:

On launch and then hourly, imux checks the website-hosted Sparkle appcast feed for new releases.
When a newer version is available, an update pill appears in the titlebar. Click it to see release notes and start the download.
You can also check for updates manually from the imux menu bar: imux > Check for Updates.

Appcast Feed

The Sparkle appcast is the single source of truth for available updates. It is hosted on the imux website and contains version metadata, release notes, and download URLs:

https://www.iccjk.com/downloads/appcast.xml
https://www.iccjk.com/downloads/latest.json

Release Versioning

imux follows semantic versioning (semver) for all releases:

MAJOR.MINOR.PATCH format (e.g., 2.8.3).
MAJOR: breaking changes or significant architectural shifts.
MINOR: new features, backward-compatible enhancements.
PATCH: bug fixes, performance improvements, and minor tweaks.

Checking Your Version

Several ways to confirm which version of imux you are running:

From the menu bar: imux > About imux shows the version number and build metadata.
From the CLI: run icc --version to print the installed version.
From the app bundle: /Applications/imux.app/Contents/Info.plist contains the CFBundleShortVersionString key.

NIGHTLY Build Details

The NIGHTLY build is a separate application with its own identity:

Bundle ID: com.icc.icc.nightly (distinct from the stable bundle ID).
Installs as imux NIGHTLY.app alongside imux.app in your Applications folder.
NIGHTLY has its own Sparkle feed and auto-update cycle, independent of the stable channel.

Changelog

Full release notes for every stable version are published on the changelog. See the /changelog page for detailed per-version changes, including new features, bug fixes, and upgrade notes.