Skip to content

Getting Started ​

Astral Travel has two modes: Host (share your machine) and Client (connect to a shared machine).

Install ​

Download the latest release from the download page.

Linux (AppImage):

bash
chmod +x Astral-Travel-*.AppImage
./Astral-Travel-*.AppImage

TIP

If you see a sandbox error, run with ELECTRON_DISABLE_SANDBOX=1:

bash
ELECTRON_DISABLE_SANDBOX=1 ./Astral-Travel-*.AppImage

Ubuntu / Debian (.deb):

bash
sudo apt install ./astraltravel_*_amd64.deb

Windows 10/11: run Astral-Travel-Setup-1.0.1.exe. If Windows says "Windows protected your PC", click More info → Run anyway.

macOS 13+: open the .dmg (arm64 for Apple Silicon, x64 for Intel) and drag the app to Applications. The first time, right-click it and choose Open (or use System Settings → Privacy & Security → Open Anyway). When you first connect, click Allow for local network access. See the download page if macOS says the app is damaged.

Windows and macOS can connect only. Both computers must be on the same network, or both on Tailscale.

Share Your Machine (Host) ​

Linux only (X11 tested, Wayland best effort). The Share button is hidden on Windows and macOS.

  1. Open Astral Travel
  2. Click Share This Machine
  3. Wait a few seconds while it auto-configures everything
  4. A connection code appears (e.g. AT-ABCD-EFGH-IJKL-MNOP)
  5. Share this code with whoever needs to connect

That's it. No streaming server to configure, no ports to open, no pairing to do. Everything is handled automatically — GPU detection, encoder selection, pairing and encryption. Both machines need to be on the same network or the same Tailscale tailnet.

Click Stop Sharing when you're done.

Connect to a Machine (Client) ​

  1. Open Astral Travel
  2. Click Connect to a Machine
  3. Enter the code you received from the host
  4. Click Connect

The streaming session starts automatically. Click Disconnect when you're done.

What Gets Auto-Configured ​

When you click "Share This Machine", Astral Travel silently:

  • Detects your GPU and selects the best hardware encoder
  • Generates an optimal streaming configuration
  • Starts the streaming engine
  • Creates an encrypted peer-to-peer tunnel
  • Generates the connection code

The entire process takes a few seconds. You don't need to touch any of it.