A native macOS remote for your Google Cast receiver. Open the menu bar, choose a device, and adjust its volume.
Download the latest release · Changelog · Validation
The connected screenshot is a clearly labeled UI preview with a simulated receiver. The production view is rendered directly from the app; no physical receiver was available during this release's validation.
- A compact native popover with a clear device card and large receiver-volume display.
- Bonjour discovery for
_googlecast._tcp, including the receiver's friendly name. - Device selection saved locally; TLS Cast v2 communication to the advertised port.
- Volume slider, one-step up/down, two-step down, and mute/unmute.
- Stable slider preview while dragging, including when a receiver sends a status update.
- System, Light, and Dark appearance in the More options menu.
- Clear discovery, connection, and local-network permission feedback.
- No Google account, Android TV pairing, ADB, privileged helper, or cloud backend.
| Connected UI preview | Muted UI preview | Actual discovery state |
|---|---|---|
![]() |
![]() |
![]() |
The preview images are rendered from explicit offline fixtures and marked as simulations in the image. The discovery image shows the actual app state on the local Mac. Validation details.
Requires an Apple Silicon Mac with macOS 13 or later, and a reachable Google Cast receiver on the same local network.
- Download CCastControl-0.2.0-macos.zip.
- Unzip it and move
CCastControl.appto/Applications. - Launch the app and allow Local Network access if macOS asks.
The app is ad-hoc signed and is not Developer ID signed or notarized. If macOS blocks first launch, approve it in System Settings → Privacy & Security. The release includes SHA256SUMS.txt for checking the download.
Click the Cast icon in the menu bar to open the remote. The app discovers local receivers automatically and reconnects to the selected device. Use the chevrons on the device card to select another receiver, or the refresh button to rediscover devices.
When a receiver reports its volume, the slider and controls become available. A drag previews the desired level and commits when released; keyboard slider adjustments are debounced. The large readout otherwise shows the volume reported by the receiver. Muting preserves the receiver volume.
| Shortcut | Action |
|---|---|
| Command–Up | Increase one step |
| Command–Down | Decrease one step |
| Command–M | Mute/unmute |
| Command–Q | Quit |
Each step changes the receiver's 0–1 volume by 1/15 (about 6.7 percentage points); the two-step button changes it by 2/15. Shortcuts apply while the remote is open. Use More options → Appearance for System, Light, or Dark.
If discovery is blocked, allow CCastControl under System Settings → Privacy & Security → Local Network, then choose Rediscover devices. The receiver must be powered on and connected to the same reachable local network as the Mac.
Requirements: Apple Silicon, macOS 13+, Swift 5.9+ and Xcode or the Xcode Command Line Tools.
git clone https://github.com/leonsuv/CCastControl.git
cd CCastControl
./build-app.sh
open .build/CCastControl.appbuild-app.sh assembles the app bundle and uses an ad-hoc signature by default. Set SIGNING_IDENTITY to sign with your own identity. Set VERSION to override the bundle version.
./build-app.sh
.build/CCastControl.app/Contents/MacOS/CCastControl --self-test
# Quit CCastControl before running the native rendering checks:
./scripts/check-interface.shThe rendering check writes PNGs to a temporary directory and uses the current live discovery state plus clearly marked offline fixtures. It reads live receiver status when available, but sends no volume or mute commands. Fixtures do not touch the local network or saved receiver selection.
CCastControl uses Network.framework for Bonjour and TLS and encodes the Cast v2 protobuf messages directly. It connects to the advertised service port, normally 8009, and exchanges GET_STATUS / SET_VOLUME messages with receiver-0 in urn:x-cast:com.google.cast.receiver.
Receiver discovery and control happen locally. The app contains no analytics or cloud backend. It is written in Swift, SwiftUI, and AppKit without third-party packages.
Bug reports and pull requests are welcome. Include your macOS version and redacted logs. The app has not been tested with every receiver model; compatibility depends on support for the Google Cast receiver protocol.
MIT.

