MRAB

Make Rog Ally Better

English | 简体中文

One-click configuration script to optimize button mapping for ROG Ally running SteamOS.

Features

• Automatic InputPlumber capability map configuration
• Optimized Start/Select button layout for ROG Ally
• Support for rear paddle buttons
• One-click installation, simple and quick
• Automatic protection against SteamOS update overwrites (via atomic update whitelist)

Quick Installation

Stable Release (Recommended)

curl -fsSL https://github.com/0chencc/MRAB/releases/latest/download/install.sh | sudo bash

Development Version

Install from the main branch:

curl -fsSL https://raw.githubusercontent.com/0chencc/MRAB/main/install.sh | sudo bash

Local Installation

If you have already cloned this repository:

cd MRAB
sudo bash install.sh

Uninstallation

If you want to restore the default button mapping configuration, you can run the uninstall script:

Uninstall from Release

curl -fsSL https://github.com/0chencc/MRAB/releases/latest/download/uninstall.sh | sudo bash

Local Uninstallation

If you have already cloned this repository:

cd MRAB
sudo bash uninstall.sh

The uninstall script will:

• Remove InputPlumber configuration file
• Remove atomic update whitelist configuration
• Restart InputPlumber service
• Restore default button mappings

Button Mapping

This configuration maps the following buttons:

• Control Center (Short Press) → Select
• Armory Crate (Short Press) → Start
• Original Select Button → Guide
• Original Start Button → Quick Access
• Control Center (Long Press) → Keyboard
• Armory Crate (Long Press) → Quick Access 2
• Left Paddle → Left Paddle 1
• Right Paddle → Right Paddle 1

System Requirements

• ROG Ally device
• SteamOS operating system
• InputPlumber service

Notes

• Root privileges are required to run the installation script
• A device restart may be required for changes to take effect
• Configuration file location: /etc/inputplumber/capability_maps.d/ally_type1.yaml

SteamOS Update Protection

Starting with SteamOS 3.6, the system uses an atomic update mechanism to manage system updates. MRAB automatically creates a whitelist configuration file to ensure your button mapping configuration is not deleted after SteamOS updates.

Whitelist configuration location: /etc/atomic-update.conf.d/mrab.conf

This means:

• ✅ Configuration automatically persists across SteamOS updates
• ✅ No need to manually reinstall
• ✅ Persistent configuration storage

Acknowledgments

This project was inspired by a discussion in the Valve SteamOS community:

ROG Ally - Steam Button long press commands cannot be entered properly

Thanks to the community members who shared solutions and suggestions in that issue, including:

• InputPlumber capability map configuration methods
• atomic-update.conf.d persistence solutions
• Various creative button mapping approaches

Special thanks to all ROG Ally + SteamOS users who participated in the discussion and testing!

Contributing

Issues and Pull Requests are welcome!

License

MIT License