Linux Setup (Beta)

Beta Release

The Linux version of VertoXR is currently in Beta. We are actively expanding support across different distributions and desktop environments.

Troubleshooting: Missing Dependencies

If VertoXR does not launch or fails to run properly on your machine, your system may be missing a few standard system libraries. Run each step below in your terminal:

Already on Ubuntu Desktop?

Most standard Ubuntu Desktop installations already include the majority of these libraries out of the box. Running these commands is completely safe—the package manager (apt) will automatically skip any packages your system already has and only install the missing ones.

1. Update Package Repositories

sudo apt-get update

2. Install Required System Libraries

sudo apt-get install -y \
  keybinder-3.0 libasound2-dev libudev-dev libssl-dev libgtk-3-dev \
  libpipewire-0.3-dev libinput-dev \
  libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libgbm1 \
  libpango-1.0-0 libcairo2 libgtk-3-0

sudo apt-get install -y libayatana-appindicator3-dev || sudo apt-get install -y libappindicator3-dev

3. Check Logs for Missing Libraries

If ArSpace is not launching or something is not working properly:

1. Open Settings (COG icon on the top-left of the VertoXR window).
2. Navigate to Logs to view the application log files.
3. Check the log output for any error messages indicating a missing library (e.g., cannot open shared object file: No such file or directory).
4. If a specific missing library is mentioned, try installing it.
5. Notify us on Discord: Whether installing the library fixes the problem or you encounter different errors, please share your logs and feedback in our Discord Community so we can help and improve future releases!

Can't Open the App?

If the app window closes or crashes before you can access Settings, you can inspect the logs directly from your terminal:

cat ~/.local/share/verto_xr/logs/*.log

---

Keyboard & Mouse Shortcuts

VertoXR uses the evdev library to listen for global keyboard and mouse events, ensuring shortcuts work seamlessly on both X11 and Wayland.

To allow global input detection, the application must either:

• Run as a user who is a member of the input group (recommended), or
• Run as root (not recommended).

Input Group Permissions

On some distributions, the group used for evdev access is called plugdev, and on others it is input. Some systems have both. If you are unsure, you can add your user to both groups:

sudo usermod -a -G input,plugdev $USER

Note: After running this command, log out and log back into your session (or reboot) for the new group permissions to take effect.

---

Supported Features

Here is the current feature compatibility status for the Linux version:

Feature	Compatibility	Supported Environments	Details
Existing Displays	✅ Supported	All	Mirror and position all your physical screens in ArSpace
Launching Apps in ArSpace	✅ Supported	All	Launch and interact with apps directly in 3D ArSpace
Virtual Displays	✅ Supported	Wayland (GNOME)	Virtual screens are automatically created and managed
Virtual Displays (Other Distros)	⚠️ Manual Setup	Other Desktop Environments / Distros	You will need to create virtual displays on your own

Using Other Distributions or Desktop Environments?

If you are using a distribution or desktop environment other than GNOME on Wayland, you can configure virtual displays manually on your system.

Have questions, suggestions, or need help setting up? Join our Discord Community!