OpenRiot v3.1 Release Notes
Release Date: 2026-04-24
🚀 New Features
Go Module System Migration
Complex shell scripts in packages.yaml are now proper Go modules with full error handling:
Module │ Command │ Notes ───────────────────────────┼────────────────────────────────┼────────────────────────── fonts.all │ openriot –install-fonts │ Installs Nerd Fonts source.bibata-cursor │ openriot –install-asset │ Cursor theme │ bibata │ source.kora │ openriot –install-asset kora │ Icon theme source.gurk-keybindings │ openriot –gurk-setup │ Configures gurk │ │ keybindings system.mac-spoof │ openriot –random-mac │ MAC randomization source.rofi-calc │ openriot –install-rofi-calc │ Calculator plugin
New Commands
• –install-fonts — Installs Nerd Fonts with skip detection
• –install-asset
i3 Keybinding Improvements
• Added: Super + Shift + Arrow to move windows between split positions • Added: i3 tutorial video link in README.md • Both focus and move commands now documented in keybindings table
🗑️ Removed
Unused Modules (Removed from codebase)
• source/autotiling/autotiling.go — Python autotiler, not used • source/autolayout/autolayout.go — i3-auto-layout, disabled in config
Deprecated Packages.yaml Entries
• desktop.i3 → removed autotiling install command • Removed entire i3-auto-layout module entry
📝 Documentation Updates
README.md
• Added i3 tutorial video link to feature list • Updated keybindings table with Super + Shift + Arrow move commands • Both focus and move window commands now documented
🐛 Bug Fixes
• Fixed source/roficalc package naming (was causing syntax errors) • Cleaned up unused imports in main.go after module removal • Fixed packages.yaml shell script references after migration
🔧 Technical Details
New Modules Created
source/ ├── fonts/fonts.go # Font installation ├── assets/assets.go # Asset installation (bibata, kora) ├── macspoof/macspoof.go # MAC randomization ├── gurk/gurk.go # Gurk keybindings └── roficalc/roficalc.go # rofi-calc builder
Commands Added to main.go
• –install-fonts
• –install-asset
packages.yaml Migration
All 6 modules now use Go commands instead of complex shell scripts, providing:
• Better error handling • Consistent output format ( [SKIP] , [DONE] , [WARN] ) • Easier testing and debugging
📋 Summary
Category │ Count ───────────────────────────────────────────┼─────────────────────────────────────────── New Go modules │ 5 New commands │ 3 Removed modules │ 2 Keybindings added │ 4 Documentation updates │ 2
Upgrading
| curl -fsSL https://OpenRiot.org/setup.sh | sh |