Turn your old iPad/Android tablet/phone into a dedicated Proxmox Control Center and macro pad! 📱⚡
ProxPad is a web-based Stream Deck that puts your entire Proxmox infrastructure at your fingertips. Designed with mobile-first usability, it delivers seamless VM management, macro automation, and media control - all from a touch-optimized interface that works anywhere!
📱 Device Reuse: Turn your old iPad/Android tablet/phone into a dedicated Proxmox Control Center and macro pad
⚡ Real-Time Updates: Live VM status with instant auto-refresh. Always know what's running
🎯 Smart Resource Management: Hides VMs that share the same resources. Prevents running 2 VMs with the same GPU/SSD/etc
🎮 Macro Automation: Execute macros, launch apps, control media - all with one tap
📳 Haptic Feedback: Vibration feedback on button press (configurable)
🎨 GIF Support: Animated buttons for a dynamic interface
Mobile Experience - Clean Interface!
Your entire Proxmox fleet, beautifully organized
One-tap macro execution - convenient control
Media control features, integrated with the interface
- Runs on your Proxmox server or LXC container
- Serves the stunning web interface
- Handles all VM management via Proxmox API
- Centralized configuration in
config.py
- Ultra-lightweight Python script
- Cross-platform: Windows & Linux support
- Minimal dependencies:
pynput+ optionaluinput - Listens for UDP commands and executes locally
| Feature | What It Does | Practical Benefit |
|---|---|---|
| 📱 Mobile-Optimized | Touch-first responsive design | Use it anywhere, anytime |
| 🔄 Live Updates | Real-time VM status monitoring | Always know what's running |
| ⚡ Quick Actions | One-tap Start/Stop/Reboot/Shutdown | Control VMs instantly |
| 🎯 Smart Resources | Auto-hide conflicting VMs | No more hardware conflicts |
| 🎮 Macro Pages | Customizable macro buttons | Automate tasks efficiently |
| 🎨 GIF Icons | Animated button support | Dynamic visual interface |
| 🎵 Media Control | Integrated media player controls | Complete media hub |
| 📳 Haptic Feedback | Vibration feedback on button press | Configurable user feedback |
| 🔒 Secure API | Proxmox token authentication | Secure access |
| 🛠️ Easy Setup | Automated install scripts | Running in minutes |
git clone https://github.com/Yury-MonZon/ProxPad.git
cd ProxPad
# Server dependencies (Proxmox/LXC)
./install_deps_debian.sh # or install_debs_cachyos.sh
# Client dependencies (VMs)
pip install pynput- Log into Proxmox → Datacenter → Permissions → API Tokens
- Create token:
root@pam!ProxPad - CRITICAL: Disable "Privilege Separation"
# config.py
PROXMOX_HOST = "your-proxmox-ip"
PROXMOX_TOKEN_ID = "root@pam!ProxPad"
PROXMOX_TOKEN_SECRET = "your-secret-token"
VM_IDS = [101, 102, 103, 104]
SAME_RESOURCES = [[101, 102], [103, 104]] # Conflict groupspython proxpad.py
# Visit: http://your-ip:5000Create powerful macros with these commands:
| Command | Example | What It Does |
|---|---|---|
| Key Press | key:win+l |
Lock screen |
| Execute | exe:calc |
Open calculator |
| Type Text | type:Hello World |
Type text |
| Delay | delay:0.5 |
Wait 0.5 seconds |
| Open URL | url:https://google.com |
Open browser |
| Chain Commands | key:win; delay:0.1; type:calc; key:enter |
Complex sequences |
Why uinput is useful:
- ✅ Reliable: All key combos work perfectly (including Super/Win!)
- ✅ No Popups: No annoying permission dialogs (Wayland)
- ✅ Secure: Proper kernel-level input handling
- ✅ Flexible: Non-root usage with correct permissions
Setup in 30 seconds:
# Inside your Linux VM
./install_uinput.sh
rebootThat's it! Full keyboard emulation without any limitations!
- Launch gaming VMs with one tap
- Control media without alt-tabbing
- Macro automation for streaming
- Manage homelab from couch
- Automate daily tasks
- Show off to friends! 😎
- Manage server farms from anywhere
- Quick VM restarts during emergencies
- Monitor infrastructure on-the-go
SAME_RESOURCES = [
[101, 102], # GPU sharing VMs
[103, 104], # USB device VMs
]MACROS = {
"gaming": "key:win; delay:0.2; type:steam; key:enter",
"work": "url:https://company-portal.com",
}VERIFY_SSL = False # For self-signed certs
SHY_MODE = True # Confirmation dialogs| Problem | Solution |
|---|---|
| Connection Failed | Check API token permissions (VM.Audit + VM.PowerMgmt) |
| VMs Not Showing | Verify VM_IDS in config and token permissions |
| Page Not Updating | Clear browser cache, ensure server running |
| Macros Not Working | Run macro_handler.py in target VM |
| Linux Keys Not Working | Install uinput and reboot |
- 📋 Issues: Report bugs on GitHub
- 💬 Discord: DM author
monzon4765 - 💰 Premium Support: One-on-one setup paid assistance available
- 🎨 UI/UX improvements
- 🔧 New features
- 🐛 Bug fixes
- 📚 Documentation
ProxPad - Proxmox Control Deck & Macro Pad
Copyright (C) 2024 Yury Monzon
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Love ProxPad? Show your support and help us keep developing!
Every donation helps us:
- 🚀 Add new features
- 🐛 Fix bugs faster
- 📚 Improve documentation
- 🌟 Grow the community
Your support helps ProxPad development! ❤️
What are you waiting for?
- ⭐ Star the repo - Show your love!
- 🚀 Install now - Get running in minutes!
- 📱 Transform your phone - Become a Proxmox power user!
- 🎉 Join the community - Share your experience!
#Homelab #Proxmox #ReuseOldTablet #HardwareMacroPad #VFIO
