2.8 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
Quick Start Guide
The quickest way to get started with Stardust XR, is to try out <span style={{ color: 'yellow' }}>Telescope, this works with the device you already have, or a headset. It comes with the Stardust XR server, an app launcher called Hexagon Launcher and some helpful apps like Flatland to use your 2D apps inside Stardust, and Black Hole to quickly tuck away your objects and apps (kind of like desktop peek on Windows.)
Fedora and derivatives (except Enterprise Linux)
:::info You will need the Terra repository, unless you have Ultramarine Linux or Bazzite. You can install it using this command:
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release
::: Then, install Telescope using:
sudo dnf install telescope
Arch Linux
On Arch Linux, Stardust XR is available in the Arch Linux User Repository AUR. We suggest using an AUR helper, like Paru:
paru -S stardust-xr-telescope
NixOS
On NixOS use the Nix package manager, make sure flakes are enabled.
nix run github:StardustXR/telescope
After Installation
From here, just run telescope -f for flatscreen mode in your terminal!
You will see a floating hexagon with the Stardust XR logo in the center, this is Hexagon Launcher.
To look around, hold down Shift and Right Click while moving the mouse.
To move around, hold down Shift and W A S D, with Q for moving down and E for moving up
If you click on the hexagon, the launcher will open up. Try dragging out one of the apps with the Mouse 5 (Back) button. The small minus sign is Black Hole, if you click on it, it will grab any open window and store it away. Click it again and they will return to their original location.
If you are already using OpenXR within Linux, launching telescope while it's running should launch it within your headset. If not, check further instructions for setting up OpenXR, or the other installation guides.