OmniPanel is a lightweight, open-source application designed to bridge the gap between your PC and any touch device on your local network. Create custom Multi-Function Displays (MFDs) for any game—turning tablets, phones, or old laptops into dedicated cockpit hardware.
Many existing solutions are proprietary, require accounts, or are too bloated. OmniPanel was built to be:
- Simple & Lightweight: No account required. No cloud dependencies.
- Open & Flexible: Designed for the community to build, share, and maintain their own designs.
- Local Hosting: Host your own designs directly on your network.
- Fast Input Detection: Instant communication between touch events and virtual joysticks.
- Extreme Customization: Drag and drop blocks your dream cockpit. Advanced users can even create their own blocks using HTML and CSS.
- Privacy Focused: No accounts, no cloud, no data tracking.
The OmniPanel editor is a live, "What You See Is What You Get" workspace. It allows you to build and preview your cockpit layout in real-time.
- Layout Management: Drag the move handle (☩) to reposition blocks. Use the bottom-right resize handle to scale elements to fit your screen.
- Block Configuration: Click the gear icon (⚙) on any block to open its specific settings. Here you can map virtual joystick buttons, adjust colors, or change labels.
- Duplication: Once created a block of your liking use the duplication icon (⧉) in the block hierarchy to make a copy of the original, allowing faster panel creation.
OmniPanel is designed to be modular. If you can write basic HTML and CSS, you can build a custom block that the app will recognize immediately.
The app automatically scans the following directory on startup and adds any valid .html files to your library:
user/blocks/
To create a new block, place an .html file (e.g., toggle_switch.html) in that folder. A standard block consists of your visual HTML/CSS and a special <settings> tag that tells the editor which options to show.
<settings
joystick="0" type-joystick="number" min-joystick="0" max-joystick="9"
button="0" type-button="number" min-button="0" max-button="15"
my_label="default text" type-my_label="text"
some_number="6" type-some_number="number" min-some_number="0" max-some_number="10"
nice_color="#00ff00ff" type-nice_color="color"
></settings>
<div class="my-custom-button" style="--border: settings-some_number ; --color: settings-nice_color ;">
<button virtual-joystick="settings-joystick" emulate-button="settings-button">
settings-my_label
</button>
</div>
<style>
/* Your block-specific CSS here */
.my-custom-button {
background: var(--color);
border: var(--border) solid white;
}
</style>You don't need to touch any configuration files. Simply:
- Drop your
.htmlfile into theuser/blocks/folder. - Restart or refresh the OmniPanel host app.
- Your new block will appear in the library, ready to be dragged onto your workspace.
Windows requires the vJoy driver to create virtual joysticks that games can recognize.
- Install vJoy: Download from the vJoy GitHub Repository.
- Configure vJoy: * Open the Configure vJoy app.
- Enable 6 virtual joysticks (this is plenty for most complex setups).
- Ensure each device has 16 buttons at least.
- Click Apply.
- Done.
Linux uses the native uinput kernel module for high-performance virtual input.
- Enable uinput Module:
sudo modprobe uinput
- Set Permissions:
(Note: You must log out and back in for group changes to take effect).
echo 'KERNEL=="uinput", MODE="0660", GROUP="uinput", OPTIONS+="static_node=uinput"' | sudo tee /etc/udev/rules.d/99-uinput.rules sudo groupadd -f uinput sudo usermod -aG uinput $USER
- Enable on Startup:
echo "uinput" | sudo tee /etc/modules-load.d/uinput.conf
- Done.
- Multi-Instance Support: Host different panels for different devices simultaneously.
- Slider Sync: Real-time state syncing across multiple clients.
- Dedicated Client App: Reducing browser "jank" with a native wrapper.
- Plugins: Plugins for specific games, like api support etc.
Contributions make the open-source community amazing.
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a clear Pull Request so I can easily understand your changes.
Thank you for trying OmniPanel!