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

macOS: Open the .dmg and drag to Applications.

Windows: Run the installer.

Share Your Machine (Host)

Linux only. macOS and Windows are client-only.

  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, encryption, and NAT traversal.

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.