Grass Valley KFrame for Companion

Companion page with suite connection status, macro, AUX and ME3 crosspoint buttons

Main page: Suite 1–4 connections and Stop All, macros named from the frame, AUX 1–7, ME3 sources

Crosspoints for PGM, ME1, ME2 and ME4

Transitions and E-MEMs, one column per M/E, plus Master E-MEMs

Timeline RUN for each M/E and the nine timeline edit buttons

PBUS recall and play, GPI triggers

Image Store outputs and input, Panel Memory

Panel button mapping, one column per M/E

Installing

Requires Bitfocus Companion 4.3 or later on Mac, Windows or Linux. Tested on Companion 5.0.4 with K-Frame V14 and V18.

Download grassvalley-kframe-2.0.0.tgz above. Leave it as a .tgz file; don't unzip it.
In Companion, open Modules, click Import module package and choose the downloaded file.
Open Connections, add Grass Valley KFrame, enter the frame's IP address, tick the suites you use (Suites 1–4), and save. The suites connect one at a time and turn green when connected.
Open Buttons, then the Presets tab, choose Grass Valley KFrame and drag buttons onto your pages.

Developer folder (optional)

To run it as a development module instead:

Make an empty folder, for example companion-dev-modules.
Extract the .tgz into it, so you have companion-dev-modules/grassvalley-kframe/.
In the Companion launcher window, open settings (the gear), turn on Developer settings, and set the Developer modules path to that folder.
Restart Companion. The connection list then shows Grass Valley KFrame marked as dev.

Notes

Installed the earlier 2026.0.9 file? Remove it under Modules first, then import 2.0.0 and check the connection uses 2.0.0. It's the same module, renumbered for Bitfocus.
Use one KFrame connection per Companion. It uses local UDP ports 6132–6139 (two per suite); allow them in any firewall.
Upgrading from the Grass Valley K-Frame 1.0.0 module: existing Macro and AUX buttons convert automatically and keep their look. A 1.0.0 connection set to a B suite moves to the matching A suite.
Button Mapping and PBUS Trigger change the switcher. Try them on a simulator or off-air system first.
Full help is in Companion: click the ? next to the Grass Valley KFrame connection.

SHA-256: f0e7d7445538c9cfe6f633c188acf69294e0d32234cf2ee9ff0a9181ed5076ea

Changelog (module v2.0.0)

October 17, 2026

Version renumbered from 2026.0.9 to 2.0.0 to follow the Bitfocus versioning rules. Same features.
Suite badge sits in the same spot on every button.

October 16, 2026 (2026.0.9)

First Companion release, built from the GV Macro Player for Stream Deck.
Suites 1–4 with automatic connect and retries, plus optional Connect / Disconnect buttons.
Macros, AUX, crosspoints, E-MEMs, transitions, timeline RUN, Image Store, PBUS, GPI, panel memory and button mapping.
Macro and source names from the frame on dropdowns and buttons, and live tally from the switcher.
Ready-made presets with suite badges.
Upgrades Grass Valley K-Frame 1.0.0 buttons in place.

This is an unofficial module and is not affiliated with Grass Valley®. Grass Valley® is a registered trademark of its respective owner. Any and all mentions are for reference only and do not imply affiliation. The User agrees to indemnify and hold harmless the Developer from all claims, damages, or liabilities arising from use of this Software with any Grass Valley® hardware or systems.