Skip to content

Releases: nodefive/freewolf-k8-linux

Release list

v1.0.1 - Installer & Desktop Integration

v1.0.1 - Installer & Desktop Integration Latest
Latest

Choose a tag to compare

View all tags
@nodefive nodefive released this 04 Oct 14:35
v1.0.1
79c779d

FREE WOLF K8 Linux Controller — v1.0.1

Incremental release featuring automated system installation, high-resolution desktop integration, and legacy folder reorganization.

🚀 What's New in v1.0.1

  • Automated System Installer (install.sh):
    • One-command system-wide installation: sudo ./install.sh -i.
    • Automatically places binary in /usr/bin/freewolf-k8, creates /usr/bin/k8gui and /usr/bin/k8ctl symlinks, deploys .desktop launcher, installs icons, and configures /etc/udev/rules.d/ permissions.
    • Clean uninstallation option: sudo ./install.sh -u.
    • Integrated help: ./install.sh -h.
  • High-Resolution 500×500 Application Icon:
    • Replaced legacy Windows .ico files with high-resolution DeviceDriver.png across both the Rust and Legacy Python environments.
    • Installed to standard FreeDesktop directories (/usr/share/icons/hicolor/512x512/apps/freewolf-k8.png and /usr/share/pixmaps/freewolf-k8.png).
  • Connection Mode Documentation:
    • Clarified across all guides and READMEs that software control operates exclusively via USB Wired (0x1A2C:0x7C80) and 2.4 GHz RF Dongle (0x1A2C:0x7FFF). Bluetooth mode isolates vendor feature reports and does not support software control (hardware shortcuts continue to work across all modes).
  • Legacy Python Organization:
    • Renamed the Python prototype folder to FreeWolf-K8-Legacy/ with dedicated README documentation and updated dependencies (python3-tk).
  • Dynamic Versioning:
    • In-app GUI status bar now dynamically tracks the Cargo release version.

📦 Included Bundle Files

  • freewolf-k8: Compiled native release binary (Linux x86_64, GTK4/Libadwaita).
  • install.sh: System installer/uninstaller script.
  • k8gui: Convenience symlink for launching the desktop interface.
  • k8ctl: Convenience symlink for launching the command-line interface.
  • assets/: Application icons, screenshots, and 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.

🚀 Installation

# Extract the archive
unzip freewolf-k8-linux-v1.0.1-x86_64.zip
cd freewolf-k8-linux-v1.0.1-x86_64

# Install system-wide (requires root/sudo)
sudo ./install.sh -i

🔒 Checksums (SHA-256)

File SHA-256 Checksum
freewolf-k8-linux-v1.0.1-x86_64.zip a764482f2a9e5b0a8213fcfffcabf3f94d967e7e6ba4ed57c1fc340ba9d03543
freewolf-k8-linux-v1.0.1-x86_64.tar.gz b43d7611386d23d6f7d8bdd3d71da3886f862706eada77a33af4f593429f2fa7
Assets 4
Loading

v1.0.0 - Native Linux Controller & Driver

v1.0.0 - Native Linux Controller & Driver

Choose a tag to compare

View all tags
@nodefive nodefive released this 04 Oct 02:32
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
Loading