¶ X11VNC Add-On Guide
X11VNC is a lightweight VNC server that allows you to remotely view and control your Batocera system's desktop environment. It mirrors the actual X11 session in real-time, so what you see locally is what you get remotely—ideal for managing graphical apps or offering remote support.
¶ 📅 Installation
X11VNC is available via the Batocera Unofficial Add-Ons (BUA) system:
- Launch Batocera Unofficial Add-Ons from the Ports menu.
- Navigate to the Dev Tools section.
- Select X11VNC and press Install.
- Once installed, the VNC server will be available on boot.
¶ 💡 How to Use
- X11VNC runs in the background after install.
- On another device, connect to your Batocera system’s IP using a VNC client (e.g., TigerVNC, RealVNC, TightVNC).
- Default port: 5900
- You will see the same graphical environment that’s shown on the Batocera display.
¶ 🔐 Optional Authentication
X11VNC can be configured with a password file for secure access:
- Create a password file:
x11vnc -storepasswd yourpassword ~/.vnc/passwd
- Edit the launch script located at:
/userdata/system/services/x11vnc
- Modify the
RUN_CMDline to include the password file:
RUN_CMD="x11vnc -display :0 -rfbport 5900 -reopen -forever -shared -rfbauth ~/.vnc/passwd"
This will require VNC clients to enter the password before connecting.
¶ 🛠️ Troubleshooting
| Issue | Solution |
|---|---|
| Cannot connect | Make sure port 5900 is open on your local network. |
| Black screen | Try launching a graphical app first (e.g., File Manager) or reboot after install. |
| Lag or choppiness | Use a lightweight client (e.g., TigerVNC) and connect over LAN for best performance. |
X11VNC is a simple and powerful way to access your Batocera desktop remotely with minimal configuration.