# PanelsXR

PanelsXR is a self-hosted WebXR comic reader that streams your Komga library into a Meta Quest 3 headset, letting you browse a 3D wall of covers, turn pages with the thumbstick, and auto-resume reading from where you. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2503/panelsxr

## Description

PanelsXR is a self-hosted WebXR comic reader that streams your Komga library into a Meta Quest 3 headset, letting you browse a 3D wall of covers, turn pages with the thumbstick, and auto-resume reading from where you left off on any device.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

49/100 (Fair), based on 3 of 4 factors.
- Maintained: 77 (last commit 55 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/dervish/panelsxr
- GitHub: https://github.com/dervish666/PanelsXR
- Unraid: https://ca.unraid.net/apps/panelsxr-0rijtt51ns8ejp?q=PanelsXR

## Common questions

### Which Komga environment variables do I set for PanelsXR?

Set KOMGA_URL to your Komga address and KOMGA_API_KEY to a Komga API key. The example Docker command maps host port 8677 to the container.

### Why won't the Meta Quest browser enter VR from a plain HTTP address?

WebXR requires HTTPS, so the Quest browser may load the 2D page but will not enter VR. Front PanelsXR with a reverse proxy or tunnel to serve it over HTTPS.

### Do I need to sideload an APK onto the Meta Quest?

No, PanelsXR runs in the Meta Quest browser as a WebXR app. It does not require a store app, native build, or sideload.

### How should I prevent public access to PanelsXR?

PanelsXR is fail-closed and will not serve /komga unless PANEL_PASSWORD is set or PANEL_AUTH=none is explicitly configured. Use a dedicated read-only Komga user key to limit the blast radius.

### Does reading progress sync between devices?

It reopens your last book from Komga on load and syncs read progress back on every page turn. Progress read elsewhere carries over without manual steps.

---
Source: Our Local Host (https://ourlocalhost.com/app/2503/panelsxr), the self-hosted and open-source app directory.
