Skip to content

About

A native macOS MIDI master clock for keeping drum machines, synthesizers, and other MIDI gear in time. Built with SwiftUI and CoreMIDI, with a compact interface inspired by hardware instruments.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MIDI Clock Controller

English · 简体中文

A native macOS MIDI master clock for keeping drum machines, synthesizers, and other MIDI gear in time. Built with SwiftUI and CoreMIDI, with a compact interface inspired by hardware instruments.

Features

  • Ableton Link + MIDI — share tempo, beat alignment, and optional Start/Stop sync with Link peers while driving USB MIDI hardware. Independent devices keep their own controls.
  • One master, multiple devices — control tempo and playback together, or switch any device to independent control.
  • Start, Continue, and Stop — play from the beginning or resume from a device’s stopped position. Stop All covers all local MIDI devices.
  • Precise tempo control — 20–300 BPM, 0.1 BPM adjustments, and press-and-hold acceleration, with standard 24 PPQN MIDI clock output.
  • A focused interface — a digital tempo display, light and dark themes, and keyboard shortcuts.
  • Device isolation — a disconnected or failed device does not interrupt the others; reconnecting never starts playback automatically. Disconnected devices are dimmed and removed after 30 seconds unless they reconnect.

Download & use

This page describes the current source. Check each release's notes for the features included in its download.

Download the DMG from GitHub Releases, open it, and drag the app into Applications. Prebuilt releases require Apple Silicon and macOS 13 or later.

Connect your MIDI gear, set its clock source to USB MIDI / External, and enable Start / Continue / Stop reception. Choose a BPM in the app and start playback. If MIDI initialization fails, use Refresh MIDI Devices to retry after the service is available. Devices follow the master by default; use independent control when a device needs its own tempo or transport. Independent cards offer Start with master (off by default). Enabled devices join the next master Start or Continue at their own BPM; running devices keep playing. Master Stop leaves them playing, and Stop All stops them. With Link enabled, they share the launch boundary and then use their own local clock. Each card labels MIDI Clock as its output protocol and identifies its beat source: Link, local master, or independent. A Link beat source means the app bridges Link to MIDI; it does not mean the hardware has a native Link connection.

The Ableton Link group shows other participants and transport settings. Shared tempo appears in the master display; the Link card only adds the original tempo when MIDI needs a tempo ratio. Link does not expose participant names or individual sync status. MIDI Devices continues to list each local MIDI output separately.

Stop the master and click Join in the Ableton Link card. Transport → Local / Linked controls optional Start/Stop sync (Local by default). MIDI launch → Next beat / Every 4 beats separately controls the MIDI start boundary; Stop is immediate. Joining never starts MIDI playback automatically. Stop All stops local MIDI and disables transport sync. Link is off at each app launch. See the Link guide for behavior and testing.

The app is currently ad-hoc signed and not notarized. If macOS blocks it, follow the first-launch instructions in the release notes. Continue preserves each device’s own position; it does not align song positions across devices.

Use Check for Updates… in the app menu to check the latest stable GitHub Release. Releases with a signed update feed can be downloaded and installed in the app with Sparkle. Choosing Install and Relaunch stops local MIDI and restarts the app. Older releases offer their GitHub download page. Checks run only when requested.

Build from source

Requires Swift 5.9+ with the macOS SDK and C++17 support. The bundled Link SDK is officially verified with Xcode 16.2 or later.

zsh scripts/build-app.sh
open "dist/MIDI Clock Controller.app"

The first build downloads the pinned Sparkle 2.10.1 dependency. To package the built app as a DMG, run zsh scripts/build-dmg.sh. Output is saved in dist/release/. To prepare signed in-app updates, see the update publishing guide.

See Contributing for tests and development workflow, and Design for interface details. These developer documents are currently in Chinese.

Sparkle provides the update downloader, signature verification, installer, and relaunch flow. Its license and bundled notices ship with the app.

Credits

Created by Duan. The bundled DSEG7 Classic font is by keshikan, licensed under the SIL Open Font License 1.1.

Link uses the official Ableton Link 4.1.1 SDK (GPLv2+ / proprietary dual licensing) and its Asio dependency (Boost Software License). Notices are in the vendored SDK and packaged with the app; About provides a third-party licenses link. This project is distributed under GPL-2.0-or-later; see LICENSE and licensing and corresponding source.

About

A native macOS MIDI master clock for keeping drum machines, synthesizers, and other MIDI gear in time. Built with SwiftUI and CoreMIDI, with a compact interface inspired by hardware instruments.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages