Skip to content

v1.0.0 - Native Linux Controller & Driver

Choose a tag to compare

View all tags
@nodefive nodefive released this 04 Oct 02:32
· 9 commits to main since this release
v1.0.0
9335d33

FREE WOLF K8 Linux Controller — v1.0.0

Initial public release of the native Linux driver, graphical studio, and CLI utility for the FREE WOLF K8 Tri-Mode Mechanical Gaming Keyboard.

Built in Rust with GTK4 and Libadwaita into a single, high-performance native ELF binary.

Features & Capabilities

  • Single Unified Binary: Intelligently switches between desktop GTK4/Libadwaita GUI and fast terminal CLI depending on how it is invoked (k8gui vs k8ctl).
  • Direct Kernel HID Driver: Direct communication with /dev/hidraw* (Interface 1: VID: 0x1A2C, PID: 0x7C80 / 0x7FFF) using native ioctl(HIDIOCSFEATURE(8)).
  • 21 Lighting Modes: Complete support for all factory backlighting animations with real-time 5-level brightness (0–4) and speed (0–4) adjustments.
  • Audio Spectrum Visualizer (Music Mode): Equalizer-reactive RGB backlight rhythm with selectable patterns and timing.
  • Virtual Keyboard Macro Studio: Full keypress recording, customizable delay modes (Record Delay, No Delay, Fixed Default), repeat looping, and kernel-level /dev/uinput playback.
  • Multilingual Localization (i18n): 5 fully supported languages (English, Português, Español, Français, Deutsch) with live in-app language switching.
  • Built-in Hardware Documentation: 9-topic interactive manual covering technical specifications, FN shortcut mappings, connection pairing, battery care, switch replacement, and troubleshooting.
  • Automated udev Configuration: One-click root authorization helper (setup-udev) to configure non-root access to /dev/hidraw* and /dev/uinput.

Included Files

  • freewolf-k8: Compiled release binary (Linux x86_64, GTK4/Libadwaita).
  • k8gui: Convenience symlink for launching the desktop interface.
  • k8ctl: Convenience symlink for launching the command-line interface.
  • assets/: UI icons and high-resolution keyboard diagram (kb_102.png).
  • 99-freewolf-k8.rules: Linux udev rules for /dev/hidraw* and /dev/uinput.
  • setup_udev.sh: Standalone bash permission setup script.

Quick Start

  1. Extract the archive: 
    unzip freewolf-k8-linux-v1.0.0-x86_64.zip
cd freewolf-k8-linux-v1.0.0-x86_64
  2. Configure udev permissions: 
    ./freewolf-k8 setup-udev
  3. Launch GUI: 
    ./k8gui
    Or use the CLI: 
    ./k8ctl status
./k8ctl set -m steady -b 4

Checksums (SHA-256)

File SHA-256 Checksum
freewolf-k8-linux-v1.0.0-x86_64.zip c1daad35ddf73b62e66e1035d69338d65742afa1d6d5b788720667f56bf07903
freewolf-k8-linux-v1.0.0-x86_64.tar.gz 9bd8791e1abf54633e9898b6517344d06a1a24765ec7ac972e75ac555cf0220e
Assets 4
Loading