Repository navigation
Releases: dev-zetta/mc7_studio
Release list
MC7 Studio 0.2.1
MC7 Studio 0.2.1
Released 2026-10-27.
This update fixes custom surface calibration, application icons and 8 kHz configuration for the Command Series MC7. Upgrade from 0.2.0 to get these fixes.
Fixes
- Surface calibration enables completion notifications, allows up to five minutes for movement and keeps both wireless Save packets in one reporting pause. Save still requires explicit acceptance and verified readback in all five profiles.
- Changing an application icon or label refreshes its LCD tile immediately. Replacing a shared icon preserves the other tile, and applying an unchanged icon avoids another upload.
- Wireless 8 kHz polling-rate changes restore the receiver's configuration handshake before reading settings back. Status reads, live-value updates and background transfers also use the paired receiver handshake.
- Specialized LCD reads check the requested profile and page before accepting a receiver reply.
Validation
The local automated suite passed 1,331 tests. On Linux with mouse firmware 5.09, custom calibration completed, saved and read back in all five profiles over USB and 2.4 GHz at the 4 kHz setting. Tracking felt normal when moving, lifting and repositioning; the original Low preset, supported settings and assigned macros were restored and verified afterward.
Wireless application-icon upload, sharing, replacement, rendering and application launch were checked at 4 kHz. Wireless 8 kHz configuration, readback and pointer responsiveness were checked; effective report frequency and latency have not been measured.
Downloads and limits
Packages are available for Linux x86_64 (AppImage, glibc 2.35 or newer), Windows x86_64 (portable ZIP), and Apple Silicon Macs (ZIP, macOS 13 or newer). Python wheel, source distribution, corresponding sources and checksums are included.
Linux 2.4 GHz support remains broader than the macOS and Windows connection support, which requires direct USB. Physical MC7 acceptance on macOS and Windows, calibration at 8 kHz and long-running wireless LCD services remain pending. Firmware installation requires a direct USB connection. Continue to choose ECO mode or energy saving individually in wireless mode.
MC7 Studio 0.2.0
MC7 Studio 0.2 adds Linux configuration through the MC7's 2.4 GHz USB receiver, including sensor settings, lighting and power controls.
Downloads
| Platform | Package | Requirements |
|---|---|---|
| Linux | MC7-Studio-0.2.0-x86_64.AppImage |
x86_64, glibc 2.35 or newer |
| Windows | MC7-Studio-0.2.0-windows-x86_64.zip |
64-bit Windows 10 or newer |
| macOS | MC7-Studio-0.2.0-macos-arm64.zip |
Apple Silicon M1 or newer, macOS 13 or newer |
Verify the adjacent SHA-256 checksum before launching. Windows builds are unsigned; macOS builds are ad-hoc signed and are not notarized. Python wheels, source archives, firmware provenance metadata and corresponding sources are included.
Changes
- Recognize the 2.4 GHz receiver as a configurable mouse connection on Linux.
- Wait for fresh wireless replies and handle zero padding on LCD/page records.
- Read receiver lighting records explicitly, retaining every setting byte and checking repeated reads without inventing an absent checksum.
- Verify wireless lighting and power edits with the existing baseline, conflict and readback guards.
- Pair receiver reporting pause/resume around configuration and attempt resumption on failed operations.
- Prevent the ECO + energy-saving combination that disconnects configuration on the tested firmware; reject it before any HID report is sent.
- Display the wireless connection and its polling rate correctly.
- Disable Apply when a page's required settings could not be read.
- Refresh the README, installation examples, official mouse illustration and native application screenshots.
Validation and limits
Linux hardware acceptance covers all five profile reads and reversible DPI, lighting and power changes on mouse firmware 5.09. The package workflows test Linux, Windows and macOS, launch the native applications, verify bundled helper communication and HIDAPI, and check the AppImage on Ubuntu, Fedora and Arch.
Wireless configuration is Linux-only. Choose ECO mode or energy saving, one at a time; enabling both on mouse firmware 5.09 / receiver firmware 5.02 disconnects configuration access while pointer input still works. Use USB to combine them. Custom calibration, image transfers, long-running LCD services and 8 kHz behavior still need wireless hardware acceptance; use USB for those workflows. Windows/macOS physical mouse acceptance remains pending. Bluetooth configuration, pairing and receiver firmware installation are unavailable. Firmware workflows require a direct USB cable, and Windows firmware installation is disabled.
See the Getting started guide, User guide and Firmware and recovery.
MC7 Studio is independent software under GPL-3.0-or-later and is not affiliated with Turtle Beach. Firmware payloads are not redistributed.
MC7 Studio 0.1.0
MC7 Studio 0.1.0 is the first public release of an independent configurator for the Turtle Beach Command Series MC7 mouse, with native applications for Linux, Windows and Apple Silicon Macs.
Downloads
| Platform | Download | Requirements |
|---|---|---|
| Linux | MC7-Studio-0.1.0-x86_64.AppImage |
x86_64, glibc 2.35 or newer, graphical desktop |
| Windows | MC7-Studio-0.1.0-windows-x86_64.zip |
64-bit Windows 10 or newer |
| macOS | MC7-Studio-0.1.0-macos-arm64.zip |
Apple Silicon M1 or newer, macOS 13 or newer |
Each application includes Python, Qt, HIDAPI, 7-Zip and the desktop dependencies. Verify the adjacent .sha256 checksum before launching. Python wheels and source archives are also available.
On Linux, make the AppImage executable and install the USB access rule through Device → Check and install host integration…. On Windows, extract the entire ZIP and run MC7-Studio.exe; keep MC7-Studio-CLI.exe and _internal beside it. On macOS, extract the ZIP in Finder and move MC7 Studio.app to Applications.
The Windows build is unsigned. The macOS build is ad-hoc signed and is not Apple notarized, so the operating system may require explicit approval on first launch.
Features
- Five onboard profiles, portable local presets, and supported automatic profile switching.
- Five DPI stages, polling rate, Motion Sync, debounce, angle controls and guided calibration.
- Button assignments, Easy-Shift layers, Easy-Aim, Easy-Wheel, shortcuts and macros.
- Lighting effects, colors, brightness and speed.
- LCD page and tile editing, custom backgrounds, icons, countdowns and live system values.
- Host-assisted application, file, website, desktop media and OBS actions.
- Battery monitoring, tray support and supported start-at-login integration.
- Official firmware downloads, package inspection, guarded upgrade preparation and settings-backup restoration.
Validation and limitations
The Linux application has been tested with a directly connected MC7 on firmware 5.09, including an upgrade from 5.04. Windows and macOS builds are checked on native GitHub runners, including GUI startup, HIDAPI entry points, helper communication, image support and 7-Zip. Physical mouse acceptance on those platforms is still pending.
Connect the mouse directly by USB. Receiver, wireless and Bluetooth configuration are unavailable. Windows firmware installation is disabled. Downgrades, interrupted-update recovery and transmitter firmware installation remain unvalidated. Settings backups are not complete firmware images and do not preserve custom background pixels; retain original images and exported presets.
See Getting started, the User guide, Desktop integrations, and Firmware and recovery.
MC7 Studio is GPL-3.0-or-later. The release includes corresponding sources and notices for bundled components. Turtle Beach firmware payloads are not redistributed; the firmware provenance archive contains download URLs and checksums only. MC7 Studio is not affiliated with or endorsed by Turtle Beach.