⭐ If you find this useful, consider supporting me on Ko-fi!
Release 1.1: Terminal-based launcher with automatic browser opening!
This is a standalone, offline-capable Linux application for configuring RK Gaming keyboards. It mirrors the official web-based driver (drive2.rkgaming.com) and wraps it in a lightweight local environment, solving the issue of WebHID not working in standard file-based browsing.
- Full Linux Support: Runs flawlessly on most Linux distributions.
- Offline Capable: All website assets are bundled locally; no internet connection required after download.
- WebHID Support: Communicates directly with your keyboard via USB.
- Terminal Launcher (v1.1): Opens a new terminal window displaying the server URL with one click.
- Auto-Browser Launch: Automatically opens Brave/Chromium via
xdg-open. - Dynamic Port Allocation: No port conflicts - always uses a free port.
- Native Experience: Runs in a dedicated browser window ("App Mode") without address bars or tabs.
- Python 3 (Pre-installed on almost all Linux distros).
- A Chromium-based Browser: WebHID support is required. Supported browsers include:
- Google Chrome (Native & Flatpak)
- Chromium (Native & Flatpak)
- Brave (Native, Flatpak & Snap)
- Microsoft Edge (Native & Flatpak)
- Opera / Vivaldi
The Terminal AppImage opens a new terminal with the server URL and auto-launches your browser.
- Download
RK_Gaming_Keyboard_Terminal.AppImagefrom this repository. - Make it executable:
chmod +x RK_Gaming_Keyboard_Terminal.AppImage
- Run it:
./RK_Gaming_Keyboard_Terminal.AppImage
What happens:
╔════════════════════════════════════════════════════════╗
║ RK Gaming Keyboard Configuration ║
╚════════════════════════════════════════════════════════╝
🌐 Server running at: http://localhost:51901
📋 Open in Brave/Chromium - click link above!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ Keep this terminal open while using the app
Press Ctrl+C to stop the server
The original AppImage lets you choose which browser to use:
- Download
RK_Gaming_Keyboard.AppImage. - Make executable and run:
chmod +x RK_Gaming_Keyboard.AppImage ./RK_Gaming_Keyboard.AppImage
If you want the app to appear in your system's Start Menu / Application Launcher:
- Clone or download this repository.
- Open a terminal in the folder.
- Run the setup script:
./setup_linux.sh
- Search for "RK Gaming Keyboard" in your application menu.
You can run the Python script directly from the source code:
- Ensure you have Python 3 installed.
- Run the app:
./rk_app.py
-
"No device found":
- Ensure your keyboard is connected via USB (wired mode).
- WebHID requires permission to access USB devices. Usually, modern Linux distros handle this automatically. If not, you may need to check your
udevrules. - Try running the browser/app as root (not recommended, but good for testing if it's a permission issue).
-
"No supported browser found":
- The app looks for standard executables (
google-chrome,chromium-browser,brave,brave-browser, etc.) and Flatpaks. Ensure you have one installed.
- The app looks for standard executables (
-
Port already in use:
- The Terminal AppImage (v1.1) uses dynamic port allocation - this shouldn't happen anymore. If it does, kill the process using that port or use the original AppImage.
- Added Terminal AppImage with automatic browser launching
- Dynamic port allocation to avoid conflicts
- Opens new terminal window with clickable server URL
- Auto-detects terminal emulator (gnome-terminal, konsole, xfce4-terminal, etc.)
- Initial release
- Basic AppImage with browser selection dialog
- Offline-capable web UI
This project is an unofficial wrapper and mirror of the RK Gaming configuration software. It is not affiliated with, endorsed by, or connected to RK Gaming. All original web assets belong to their respective owners.
Bei der Entwicklung dieses Projekts wurden teilweise oder vollständig KI-gestützte Tools und Technologien eingesetzt.