Skip to content

About

Native macOS menu bar volume control for Google Cast devices.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CCastControl

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

CCastControl connected-state UI preview with a simulated receiver

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.

Features

  • 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.

Screenshots

Connected UI preview Muted UI preview Actual discovery state
Connected preview Muted preview Live discovery

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.

Install

Requires an Apple Silicon Mac with macOS 13 or later, and a reachable Google Cast receiver on the same local network.

  1. Download CCastControl-0.2.0-macos.zip.
  2. Unzip it and move CCastControl.app to /Applications.
  3. 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.

Use

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.

Local Network access

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.

Build

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.app

build-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.

Verification

./build-app.sh
.build/CCastControl.app/Contents/MacOS/CCastControl --self-test
# Quit CCastControl before running the native rendering checks:
./scripts/check-interface.sh

The 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.

How it works

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.

Contributing

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.

License

MIT.

About

Native macOS menu bar volume control for Google Cast devices.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages