Publish Orbit Zero 1.0.0 guides and desktop screenshots

README.md

@@ -14,7 +14,7 @@ Start with **705 games** from Archive.org and Vikingfile. New games and correcte
 
 ## Orbit Zero for Mac, Windows and Linux
 
-**Coming in Orbit Store 1.0.0.** Orbit Zero is our desktop companion. Its downloads will be available with the 1.0.0 release; the current 0.9.1 release does not include it.
+**Available with Orbit Store 1.0.0.** Orbit Zero is our desktop companion for Mac, Windows and Linux. [Download Orbit Zero](https://github.com/saawant12/orbit-store-ps5/releases/tag/v1.0.0), open **Console**, enter your PS5’s local IP address and choose **Start Orbit on PS5**.
 
 Download on your computer and transfer to your PS5 at the same time. **Works over your local network: Wi-Fi or Ethernet. Your PS5 does not need internet access.** Keep both devices connected to your home network while the computer handles online downloads.
 
@@ -23,9 +23,9 @@ Download on your computer and transfer to your PS5 at the same time. **Works ove
 - **Choose where downloads run.** Use **Computer** to download through your computer, or **Prefer PS5** to download directly when the console can reach the source. Save your preference once.
 - **Follow both stages.** See the download and PS5 transfer rates separately, with controls to pause, resume and reconnect.
 
-[Install on Mac, Windows or Linux](https://github.com/saawant12/orbit-store-ps5/blob/release/orbit-zero-1.0.0-draft/guides/orbit-zero-installation.md) · [Set up a PS5 without internet](https://github.com/saawant12/orbit-store-ps5/blob/release/orbit-zero-1.0.0-draft/guides/orbit-zero-offline-ps5.md)
+[Install on Mac, Windows or Linux](https://github.com/saawant12/orbit-store-ps5/blob/main/guides/orbit-zero-installation.md) · [Set up a PS5 without internet](https://github.com/saawant12/orbit-store-ps5/blob/main/guides/orbit-zero-offline-ps5.md)
 
-### Browse from your desktop
+### Discover on your computer
 
 Explore Discover with full game artwork, find a game in Browse and save your favourites. Choose the source and PS5 destination before starting a download.
 
@@ -57,7 +57,7 @@ For direct console downloads, you need a PS5 that can run homebrew ELF payloads,
 
 1. **Choose how to open Orbit.** For the native TV app, download and verify `PPSA99177.ffpkg` from the [latest release](https://github.com/saawant12/orbit-store-ps5/releases/latest), copy it to `/data/homebrew/`, then open Orbit from the Games row. This needs **kstuff and ShadowMountPlus**. For the browser version, run `orbit_store.elf` through your loader and open Orbit from the Media tab.
 2. **Choose your sources.** Choose sources in the TV app’s setup screen or **App settings → Download sources**. Select Archive.org, Vikingfile, or both, and acknowledge the download notice. Your choices apply across both versions.
-3. **Pick a download.** Open a game and select its main download button to review **Download options**. Choose **Source**, **Download using** and **Save to**, then confirm the download. Direct options download from the TV app. Vikingfile browser options open the browser version; your selected game, source and drive carry over. Follow **Open download page on PS5 → Download on Vikingfile → return to Orbit**.
+3. **Pick a download.** Open a game and select its main download button to review **Download options**. Choose **Source**, **Download using** and **Save to**, then confirm the download. Direct options download from the TV app. Vikingfile browser options open the provider page on the PS5, keeping your selected game, source and drive. Choose **Open Vikingfile on PS5** in the native app or **Open download page on PS5** in the browser version, press **Download** on Vikingfile, then return to Orbit.
 4. **Follow your queue.** Open Downloads on the TV or a paired device to check progress, pause or resume.
 
 The TV app includes Orbit's download service and can start it through a compatible ELF loader on **port 9021**. You can also start `orbit_store.elf` yourself. The Media-tab shortcut opens the browser version while the service is running. After a reboot, start your jailbreak before opening Orbit. See the [setup and update guide](guides/getting-started.md) for installation, updates and phone pairing.
@@ -86,7 +86,7 @@ Open Orbit from your Games row and use the controller to browse, explore and cho
 
 ![Native game page with full artwork, description, favourites and download control](assets/0.9.0/native-details.png)
 
-**Choose how and where to download.** Review the source, format, delivery method and drive together. Direct options download from the TV app; Vikingfile browser options carry your choices into Orbit’s browser version. See the [download guide](guides/downloads.md), including [TorBox setup](guides/downloads.md#optional-download-through-torbox).
+**Choose how and where to download.** Review the source, format, delivery method and drive together. Direct options download from the TV app; Vikingfile browser options open the provider page on PS5 and keep your choices when you return. See the [download guide](guides/downloads.md), including [TorBox setup](guides/downloads.md#optional-download-through-torbox).
 
 ![Native Download options with source, delivery and destination controls](assets/0.9.0/native-download-options.png)
 
@@ -124,11 +124,11 @@ For your existing collection, the [Library guide](guides/library.md) explains in
 
 ## Beta status
 
-**Orbit Store 0.9.1 is an experimental beta.** [Download the beta](https://github.com/saawant12/orbit-store-ps5/releases/tag/v0.9.1).
+**Orbit Store 1.0.0 is an experimental beta.** [Download the beta](https://github.com/saawant12/orbit-store-ps5/releases/tag/v1.0.0).
 
-**Internal and M.2 storage restored.** Version 0.9.1 fixes drives missing after the 0.9.0 update and checks write access when downloads start or resume. Update both the download service and native TV app if you use it.
+**Introducing Orbit Zero.** Download on your Mac, Windows or Linux computer and transfer to the PS5 over your local network. The PS5 does not need internet. Use the matching 1.0.0 service and native TV app for computer-download controls on the console.
 
-**More games and download choices.** Explore 705 games with single-file FFPFSC, exFAT and FPKG options. Compare sources, use TorBox where supported, and choose your destination before downloading. Installation and launching are separate.
+**Games and download choices.** Explore 705 games with single-file FFPFSC, exFAT and FPKG options. Compare sources, use TorBox where supported, and choose your destination before downloading. Installation and launching are separate.
 
 **A refreshed interface on TV and in the browser.** Explore Latest releases and New on Orbit, filter Browse by region, and review your download choices in one panel. Orbit also improves M.2 storage detection and makes it easier to delete cancelled downloads and start fresh. Keep the PS5 awake while downloading.
 
@@ -142,10 +142,12 @@ Orbit 0.8.0 and later receive new games and updated links through the current ca
 
 ## Using the beta
 
-The [0.9.1 release](https://github.com/saawant12/orbit-store-ps5/releases/tag/v0.9.1) includes:
+The [1.0.0 release](https://github.com/saawant12/orbit-store-ps5/releases/tag/v1.0.0) includes:
 
-- [PPSA99177.ffpkg](https://github.com/saawant12/orbit-store-ps5/releases/download/v0.9.1/PPSA99177.ffpkg), the native TV app, and [its checksum](https://github.com/saawant12/orbit-store-ps5/releases/download/v0.9.1/PPSA99177.ffpkg.sha256).
-- [orbit_store.elf](https://github.com/saawant12/orbit-store-ps5/releases/download/v0.9.1/orbit_store.elf), the download service and browser interface, and [its checksum](https://github.com/saawant12/orbit-store-ps5/releases/download/v0.9.1/orbit_store.elf.sha256).
+- Orbit Zero for Mac, Windows and Linux, in ARM64 and x64 builds. Follow the [desktop installation guide](guides/orbit-zero-installation.md).
+
+- [PPSA99177.ffpkg](https://github.com/saawant12/orbit-store-ps5/releases/download/v1.0.0/PPSA99177.ffpkg), the native TV app, and [its checksum](https://github.com/saawant12/orbit-store-ps5/releases/download/v1.0.0/PPSA99177.ffpkg.sha256).
+- [orbit_store.elf](https://github.com/saawant12/orbit-store-ps5/releases/download/v1.0.0/orbit_store.elf), the download service and browser interface, and [its checksum](https://github.com/saawant12/orbit-store-ps5/releases/download/v1.0.0/orbit_store.elf.sha256).
 - The complete source and licence bundle for both apps and their open-source components, with build instructions.
 
 Put each download beside its `.sha256` file and run `shasum -a 256 -c <filename>.sha256`. To install the TV app from Orbit 0.6.0 or later, use **App settings → TV app** in the browser version. See the [installation guide](guides/getting-started.md) for both options.
@@ -198,7 +200,7 @@ After using TorBox, keep using Orbit 0.8.0 or later while those jobs remain in y
 
 ## Managing your downloads
 
-New large downloads use four connections when the host supports byte ranges and a strong file identity. Existing partials keep their original layout; other downloads use one connection. Pause, Resume and Cancel apply to the entire download. Speed depends on the host, network and storage.
+New large downloads use up to eight connections when the host supports byte ranges and a strong file identity. Existing partials keep their original layout; other downloads use one connection. Pause, Resume and Cancel apply to the entire download. Speed depends on the host, network and storage.
 
 Open **Downloads** and choose **Active**, **Finished**, **Failed** or **Cancelled**. Finished contains only successfully completed downloads; cancelled items have their own view. Move waiting downloads up or down to choose what runs next. Paused items keep their place. A retry countdown tells you when Orbit will try an interrupted download again.
 
@@ -254,7 +256,7 @@ Orbit does **not** extract RAR/7z archives, directly install game packages, laun
 
 When reporting a bug, follow the [bug report format](.github/ISSUE_TEMPLATE/bug_report.md) and [open a bug report](https://github.com/saawant12/orbit-store-ps5/issues/new?template=bug_report.md). Include your setup, the exact error and a diagnostic report when available, and complete the sections relevant to your issue.
 
-- **No storage:** if internal storage or your M.2 SSD disappeared in 0.9.0, update to 0.9.1, restart Orbit and refresh storage. For external drives, check that the drive is connected to the PS5. A drive connected to your computer is not PS5 storage.
+- **No storage:** if internal storage or your M.2 SSD disappeared in 0.9.0, update to the latest release, restart Orbit and refresh storage. For external drives, check that the drive is connected to the PS5. A drive connected to your computer is not PS5 storage.
 - **Drive disconnected:** reconnect the original destination. Orbit will not silently switch to internal storage.
 - **Not enough space:** free space on the selected destination before retrying.
 - **Source changed:** preserve the partial file until you decide to remove it and restart. Orbit will not append a different file to it.

guides/downloads.md

@@ -96,7 +96,7 @@ Use **Active**, **Finished**, **Failed**, and **Cancelled** to find a transfer.
 
 *The TV app and paired phone show the same queue, illustrated here with sample paused and queued jobs.*
 
-New supported large downloads use four connections. Existing partials retain their original layout. Speed depends on the provider, network and drive. Pause, Resume and Cancel control the whole file.
+New supported large downloads use up to eight connections. Existing partials retain their original layout. Speed depends on the provider, network and drive. Pause, Resume and Cancel control the whole file.
 
 After deleting a cancelled partial, you can start the download again from its game page. If you kept the partial, resume it from Downloads.
 

guides/getting-started.md

@@ -2,7 +2,9 @@
 
 Orbit runs on your PS5. Use the TV with your controller, or pair a phone or computer to manage the same catalogue and download queue. Files go to the PS5’s selected storage.
 
-You need a PS5 environment that can run homebrew ELF payloads, an ELF loader or payload manager, internet access for provider downloads, and enough writable storage. A phone or computer should be on the same local network. Library management additionally needs a compatible ShadowMount v1 local API.
+You need a PS5 environment that can run homebrew ELF payloads, an ELF loader or payload manager, internet access on the console for direct provider downloads, and enough writable storage. A phone or computer should be on the same local network. Library management additionally needs a compatible ShadowMount v1 local API.
+
+**No internet on your PS5?** [Set up Orbit Zero](orbit-zero-offline-ps5.md) to start Orbit and download through your computer over the same local network.
 
 ## Install the native TV app
 

guides/orbit-zero-installation.md

@@ -0,0 +1,136 @@
+# Install Orbit Zero
+
+Download on your computer and transfer to your PS5 over your home network. Wi-Fi and Ethernet both work, including when one device uses Wi-Fi and the other uses a cable. The PS5 does not need internet access for computer downloads.
+
+**PS5 has no internet?** Follow [Set up Orbit on a PS5 without internet](https://github.com/saawant12/orbit-store-ps5/blob/main/guides/orbit-zero-offline-ps5.md) for the full local upload, pairing and optional native-app installation steps.
+
+This guide accompanies **Orbit Zero 1.0.0**. The Mac app is Developer ID signed but is not yet notarized. Windows and Linux packages are unsigned.
+
+Get the files from the [Orbit Store 1.0.0 release](https://github.com/saawant12/orbit-store-ps5/releases/tag/v1.0.0).
+
+## Choose your download
+
+| Computer | File |
+| --- | --- |
+| Mac with an Apple M-series chip | `Orbit-Zero-1.0.0-mac-arm64.dmg` |
+| Mac with an Intel processor | `Orbit-Zero-1.0.0-mac-x64.dmg` |
+| Windows on Intel or AMD | `Orbit-Zero-1.0.0-win-x64.zip` |
+| Windows on ARM, including Snapdragon | `Orbit-Zero-1.0.0-win-arm64.zip` |
+| Ubuntu or Debian on Intel or AMD | `Orbit-Zero-1.0.0-linux-amd64.deb` |
+| Ubuntu or Debian on ARM64 | `Orbit-Zero-1.0.0-linux-arm64.deb` |
+
+On a Mac, check **Apple menu → About This Mac**. On Windows, check **Settings → System → About → System type**. On Linux, run `uname -m`: `x86_64` needs AMD64/x64; `aarch64` needs ARM64. In a virtual machine, choose the build for the guest operating system. 32-bit x86 is not supported.
+
+## macOS
+
+1. Quit any open copy of Orbit Zero.
+2. Open the matching `.dmg` and drag **Orbit Zero** into **Applications**. If updating, choose **Replace**.
+3. Eject the disk image and open **Orbit Zero** from Applications. Keep using this installed copy rather than launching from the disk image.
+4. If macOS says it cannot verify the app, first check that you received this build from Orbit's maintainer. Then open **System Settings → Privacy & Security → Open Anyway** and confirm **Open**. The Mac app has not been notarized; see [Apple's instructions](https://support.apple.com/en-us/102445).
+5. When connecting, allow **Orbit Zero** to access your local network. If you previously denied it, enable Orbit Zero in **System Settings → Privacy & Security → Local Network**, reopen the app, and retry. This permission lets it reach your PS5; it is separate from internet access. [Apple's local-network guidance](https://developer.apple.com/documentation/technotes/tn3179-understanding-local-network-privacy).
+
+Pairing or selecting **Reconnect** may open a Keychain prompt to protect or unlock your saved pairing. Approve the Orbit Zero request if you want to continue; enter your Mac login password only in the macOS prompt if requested. Opening the app just to browse does not unlock Keychain.
+
+## Windows
+
+1. Save the matching ZIP to a folder on the Windows computer, such as **Downloads**.
+2. Right-click it and choose **Extract All**. Keep the complete extracted folder together.
+3. Open **Orbit Zero.exe** from that folder. Do not launch it from inside the ZIP or copy only the EXE out of the folder.
+4. If SmartScreen says **Windows protected your PC**, check that this is the Orbit build you intended to download. For a trusted copy, choose **More info → Run anyway**, if offered. The Windows app is unsigned. If your organisation or Smart App Control blocks it without that option, contact the maintainer or administrator rather than disabling protection. [Microsoft's SmartScreen guidance](https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/smartscreen-reputation).
+5. If Windows asks to allow network access, allow **Orbit Zero** on your trusted **Private** home network. This lets the PS5 reach the computer's controls. Firewall approval may require an administrator; the app itself runs as your normal user. [Microsoft's firewall guidance](https://support.microsoft.com/en-us/windows/security/firewall/risks-of-allowing-apps-through-windows-firewall).
+
+There is no installation wizard for the Windows ZIP, and **Run as administrator** is not required. You can create a shortcut to the extracted EXE. To update, quit Orbit Zero, extract the new ZIP into a new folder, and launch that copy. Your saved pairing and queue stay in your Windows user profile.
+
+**Using a virtual machine?** Copy the ZIP onto the Windows filesystem before extracting it. If the shared folder says **Access denied**, transfer the ZIP using the VM's supported file-transfer method or download it inside Windows. Changing Orbit's permissions will not repair the VM's shared-folder connection.
+
+## Ubuntu and Debian
+
+Use the `.deb` installer. It adds Orbit Zero to your application menu and sets up the browser sandbox automatically.
+
+1. Save the matching `.deb` in **Downloads** on the Linux computer, not inside a shared folder.
+2. Open a terminal and run **one** of these, matching your processor:
+
+   ```sh
+   # Intel / AMD 64-bit
+   sudo apt install "$HOME/Downloads/Orbit-Zero-1.0.0-linux-amd64.deb"
+   ```
+
+   ```sh
+   # ARM64
+   sudo apt install "$HOME/Downloads/Orbit-Zero-1.0.0-linux-arm64.deb"
+   ```
+
+3. Enter your Linux password if asked. The installer needs administrator access; characters do not appear while typing the password. Internet access may be needed to install dependencies.
+4. Open **Orbit Zero** from your application menu. Do not run the app itself with `sudo`.
+
+**Saved the installer somewhere else?** Open a terminal in that folder and include `./` before its filename, for example `sudo apt install ./Orbit-Zero-1.0.0-linux-arm64.deb`. Without `./` or a full path, apt searches its package repositories and reports **Unable to locate package**. If `uname -m` says `aarch64`, use the ARM64 installer; AMD64 is for Intel/AMD computers.
+
+If you are updating, quit Orbit Zero and install the new `.deb` the same way. Your saved pairing and queue stay in your user profile. When pairing or reconnecting, Ubuntu may ask you to unlock your login keyring; that stores the pairing securely.
+
+### Other Linux systems or the portable archive
+
+The `linux-x64.tar.gz` and `linux-arm64.tar.gz` files contain the portable app. Distribution compatibility can vary; Ubuntu/Debian users should prefer the installer above.
+
+Extract the **whole archive** onto the Linux filesystem in a path without spaces or parentheses, such as `~/orbit-zero`. From the folder containing the executable, run:
+
+```sh
+./orbit-zero
+```
+
+If it specifically reports that **chrome-sandbox** is not configured correctly, run these two commands from that same folder, then launch normally:
+
+```sh
+sudo chown root:root chrome-sandbox
+sudo chmod 4755 chrome-sandbox
+./orbit-zero
+```
+
+`chrome-sandbox` is the browser engine's security helper. The Ubuntu/Debian installer handles its setup for you. If sandbox or AppArmor errors persist on Ubuntu, use the `.deb` rather than turning sandboxing off. If an old portable copy reports `LaunchProcess: failed to execvp`, move the extracted folder to a path without spaces or use the installer.
+
+## Connect your PS5
+
+Keep the computer and PS5 on the same reachable home network. Wi-Fi and Ethernet both work; no internet connection is needed on the PS5. Avoid guest Wi-Fi or network isolation that prevents devices from reaching one another. Keep both devices awake during transfers.
+
+The full-screen examples below show the setup flow. Use your own PS5 address and pairing code; the connection and storage values shown are illustrative.
+
+### Start Orbit on your PS5
+
+1. On the PS5, start its jailbreak and **Payload Manager** or your usual ELF loader. Orbit Zero does not jailbreak the console.
+2. Open **Console** in Orbit Zero and enter the PS5's local IP address. Leave **Orbit port** at **34177** unless you changed it.
+3. **Start Orbit on PS5** opens automatically while disconnected. Choose the method you use:
+   - **Payload Manager → Upload and start Orbit** for its web interface, normally on port **8084**.
+   - **ELF loader → Send to ELF loader** for a raw loader, normally on port **9021**.
+
+![Full-screen Orbit Zero Console with the PS5 address and Upload and start Orbit controls](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/assets/orbit-zero-development/connect-start.jpg)
+
+Zero supplies the compatible Orbit payload automatically; you do not need to find an ELF yourself. Use **Advanced** only if you changed your loader's port or want to select a custom file. Once the upload finishes, Zero waits for Orbit to start and connects automatically. If Orbit is already running, select **Connect to Orbit** instead of uploading it again.
+
+### Pair with your PS5
+
+1. When **Pairing required** appears, select **Show code on PS5**.
+2. Enter the six-digit code from the console notification, then select **Pair with PS5**. If you miss the notification, request it again after the countdown or open **Pair devices** in Orbit on the PS5.
+3. Allow access to your computer's credential store if prompted, so Zero can save the pairing securely.
+
+![Full-screen Orbit Zero pairing screen with Show code on PS5 and Pair with PS5 controls](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/assets/orbit-zero-development/connect-pair.jpg)
+
+If you have already paired this console, Zero restores that pairing when it connects. You do not need a new code unless the pairing has been removed or is no longer valid.
+
+### Check your connection and storage
+
+When the status changes to **Connected**, your available PS5 drives appear under **Storage**. Open a game, choose a source and destination, and start the download. **Downloads** shows the computer download and PS5 transfer separately.
+
+![Full-screen Orbit Zero Console after pairing, showing Connected, download preference and available storage](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/assets/orbit-zero-development/connect-ready.jpg)
+
+Leave **Console → Download preference → Computer** selected to download through your computer, whether or not the PS5 has internet. Choose **Prefer PS5** to use direct console downloads when the PS5 can reach that source, with the computer as the fallback. This preference applies to new downloads.
+
+After reopening the app, use **Console → Reconnect** for your saved console. For controls in the native PS5 app, install the matching Orbit Store FFPKG supplied with your Zero build, then enable **App settings → Orbit Zero**. Alternatively, open the computer address shown under **Console → How it works** in the PS5 browser.
+
+## If the connection fails
+
+- **Payload Manager opens, but port 9021 is unavailable:** select **Payload Manager**, not ELF loader. Its web interface and the raw ELF loader are different methods.
+- **Could not reach Orbit on port 34177:** start Orbit using the steps above, check the PS5's current IP address, and check local-network/firewall permission on the computer.
+- **Pairing code is missing:** select **Show code on PS5** and watch for the console notification.
+- **No drives appear:** confirm the destination is connected and available to Orbit on the PS5, then refresh the Console view.
+- **Transfer stopped after sleep:** wake both devices, reconnect the original console, and select **Resume**. Keep the original pairing to resume unfinished transfers.
+
+For new downloads, leave enough computer space for the full file. Completed files stay in the computer cache until you choose **Remove computer cache**. Keep Orbit Zero open while downloading or transferring.

guides/orbit-zero-offline-ps5.md

@@ -0,0 +1,121 @@
+# Set up Orbit on a PS5 without internet
+
+Install **Orbit Zero on your computer**, then use it to upload and start Orbit on your PS5 over your local network. Your computer handles online downloads and sends the files to the console. **The PS5 can keep its internet access blocked throughout setup and use.**
+
+This guide is for **Orbit Zero 1.0.0 and the matching Orbit Store build**.
+
+## What you need
+
+- A Mac, Windows or Linux computer with Orbit Zero installed. Follow the [desktop installation guide](orbit-zero-installation.md) for your operating system.
+- A PS5 with its jailbreak and **Payload Manager or an ELF loader already running**. Use your existing offline-compatible setup; Orbit Zero does not jailbreak the console or install its loader.
+- Both devices connected to the same reachable local network: **Wi-Fi or Ethernet**, including a mixture of the two.
+- Enough free space on the computer for the full download and on the PS5 destination drive.
+
+Your **computer needs internet access to fetch new downloads**. Your PS5 only needs access to the computer over the local network. You do not need to download an ELF separately: Orbit Zero includes a compatible copy and can check GitHub for a compatible update from the computer.
+
+## 1. Keep the PS5 connected locally
+
+Leave the PS5 connected to your router by Wi-Fi or Ethernet. Keep your existing internet-blocking setup in place, provided it allows devices on your home network to reach each other.
+
+**Do not disconnect the PS5 from Wi-Fi or unplug its network cable.** Blocking internet access and disconnecting from the local network are different things. Avoid guest Wi-Fi or client isolation that prevents the computer and PS5 from communicating.
+
+Find the PS5's current local IPv4 address in its network settings. You will enter this address in Orbit Zero. An internet connection test can fail while the local connection still works.
+
+Allow Orbit Zero through your computer's local-network or firewall prompt. See the [Mac](orbit-zero-installation.md#macos), [Windows](orbit-zero-installation.md#windows) or [Linux](orbit-zero-installation.md#ubuntu-and-debian) instructions if needed. There is no need to expose ports to the internet or configure router port forwarding.
+
+## 2. Upload and start Orbit from the computer
+
+1. Start your PS5's jailbreak and **Payload Manager** or ELF loader.
+2. Open Orbit Zero on the computer and go to **Console**.
+3. Enter your **PS5's local IP address**. Leave **Orbit port** at **34177**, unless you changed it.
+4. Under **Start Orbit on PS5**, choose the method your console is running:
+
+   | Running on your PS5 | Choose in Orbit Zero | Usual port |
+   | --- | --- | --- |
+   | Payload Manager with a web interface | **Payload Manager → Upload and start Orbit** | **8084** |
+   | A raw ELF loader | **ELF loader → Send to ELF loader** | **9021** |
+
+5. Wait for the upload and startup to finish. **Orbit Zero connects automatically afterward.**
+
+![Orbit Zero Console with the PS5 address and Upload and start Orbit controls](../assets/orbit-zero-development/connect-start.jpg)
+
+*The screenshots show the setup flow with illustrative connection and storage values. Use your own console address and pairing code.*
+
+Everything sent to the PS5 in this step travels over your local network. The console does not visit GitHub or a download provider. You do not need to find or select an ELF manually.
+
+If Payload Manager opens at `http://<ps5-ip>:8084/`, choose **Payload Manager**. Its web interface is separate from an ELF loader on port 9021. Use **Advanced** if your loader uses a different port.
+
+If Orbit is already running, select **Connect to Orbit**. When replacing an older running service, stop it through Orbit's **App settings → Update / reinstall → Stop Orbit to restart** before starting the new copy; uploading an ELF alone does not replace the running session.
+
+## 3. Pair the computer and PS5
+
+1. When Orbit Zero shows **Pairing required**, select **Show code on PS5**.
+2. Read the six-digit code in the PS5 notification.
+3. Enter it in Orbit Zero and select **Pair with PS5**.
+4. If your computer asks to unlock its credential store, allow Orbit Zero to save the pairing. Enter any computer password only in the operating system's prompt.
+
+![Orbit Zero pairing screen with Show code on PS5 and Pair with PS5 controls](../assets/orbit-zero-development/connect-pair.jpg)
+
+If you miss the notification, request the code again after the countdown. Pairing takes place locally and does not require internet on the PS5.
+
+## 4. Download through the computer
+
+Once **Connected** appears, check that the intended PS5 drive is listed under **Storage**. Set **Console → Download preference → Computer**.
+
+![Connected Orbit Zero Console showing storage and download preference](../assets/orbit-zero-development/connect-ready.jpg)
+
+Open a game in Orbit Zero, choose its source and PS5 destination, then start the download. The computer downloads the file and transfers completed parts to the PS5 while the download continues.
+
+**Downloads** shows both stages separately:
+
+- **Download to computer:** progress and speed from the online provider.
+- **Transfer to PS5:** progress and speed across your local network.
+
+For Vikingfile, complete any verification and select the file's Download button in the provider window **on the computer**. Orbit Zero captures the file link and queues the download; the PS5 does not need to open Vikingfile.
+
+Keep **both devices awake** and Orbit Zero open until the transfer finishes. Completed downloads remain in the computer cache until you choose **Remove computer cache**. Removing a completed cache keeps the finished PS5 file.
+
+The **Computer** preference chooses where downloads run; it does not change your router or block the PS5's internet access for you.
+
+## Optional: use Orbit's native app on the PS5
+
+You can manage everything from the desktop without installing the native app. To browse and control the computer's downloads from your TV, install the **matching `PPSA99177.ffpkg`** locally:
+
+1. On your **computer**, get `PPSA99177.ffpkg` and its checksum from the same Orbit Store release as your Zero build. Verify the checksum as described in the [native app guide](getting-started.md#install-the-native-tv-app).
+2. Keep **kstuff and ShadowMountPlus** running on the console. Close any open native Orbit app before replacing its file.
+3. Enable your PS5's FTP server. Connect to it from an FTP client on the computer using the **local IP address and port shown by the server**.
+4. Copy `PPSA99177.ffpkg` to **`/data/homebrew/`** on the PS5. This is a local file transfer; the PS5 does not download the package from the internet.
+5. Let ShadowMountPlus register it, then open **Orbit Store** from the **Games row**. Keep the Orbit service you started from Orbit Zero running.
+6. In the native app, select **App settings → Orbit Zero → Enable Orbit Zero**. Pair the computer first if the app says no computer is paired.
+
+The native app now uses your computer's catalogue and artwork. New downloads follow the **Computer** preference set above. Keep Orbit Zero running on the computer; Vikingfile verification is completed there too.
+
+For an existing installation, replace its matching FFPKG rather than keeping multiple app copies. Keep `/data/orbit-store/`, which contains Orbit's settings and queue. See [updating the native app](getting-started.md#update-the-tv-app) for folder installations and registration troubleshooting. For an internet-blocked PS5, use this computer-to-console file transfer when updating, rather than the console's online updater.
+
+### Browser controls on the PS5
+
+After desktop pairing, expand **Console → How it works** in Orbit Zero. Open one of the displayed **computer addresses** in the PS5 browser and enter the pairing code shown in that section.
+
+This is a local page served by the computer, normally on port **34179**. Its code is separate from the PS5 notification code used in step 3. Keep the computer and Orbit Zero running while using it. Use this displayed computer address for Zero's browser controls; the ordinary Orbit Media-tab shortcut opens the console's own interface.
+
+## Next time you use it
+
+1. After a PS5 reboot, run your jailbreak and start Payload Manager or your ELF loader again.
+2. Open Orbit Zero. If Orbit is not running on the console, use **Start Orbit on PS5**. If it is already running, use **Reconnect**.
+3. Your saved pairing is reused when valid. Resume any paused or interrupted downloads explicitly.
+
+You do not need to reinstall the native FFPKG each time. Keep the original pairing when resuming unfinished transfers.
+
+## Troubleshooting
+
+| What you see | What to check |
+| --- | --- |
+| The PS5 says it has no internet | That is expected with internet blocked. Check whether Orbit Zero can reach its local IP address. |
+| Payload Manager works, but no loader is listening on 9021 | Choose **Payload Manager** and its web port, usually **8084**. |
+| Orbit cannot be reached on 34177 | Start the Orbit payload, confirm the PS5's current IP, and allow local-network access on the computer. |
+| Upload finished, but pairing did not appear | Give Orbit time to start, then select **Connect to Orbit**. Check the PS5 notification before sending another launch request. |
+| No pairing code appeared | Select **Show code on PS5** and watch the console notification. |
+| The native app cannot find the computer | Keep Zero open, pair it first, enable **App settings → Orbit Zero**, and check the computer firewall allows local access. |
+| A transfer stopped after sleep or disconnection | Wake both devices, reconnect the same console and select **Resume**. |
+
+Return to the [desktop installation guide](orbit-zero-installation.md) for OS-specific setup and permissions.

guides/orbit-zero.md

@@ -0,0 +1,84 @@
+# Orbit Zero
+
+Orbit Zero downloads on your computer and transfers the file to your PS5 over the local network. The two stages overlap: completed chunks can reach the console while the computer is still downloading. Use the desktop app, a compatible native Orbit TV app, or the local browser controls to browse and manage the queue.
+
+**Available with Orbit Store 1.0.0.** Download the desktop app and matching PS5 files from the [1.0.0 release](https://github.com/saawant12/orbit-store-ps5/releases/tag/v1.0.0). For a console without internet, follow the [offline PS5 setup guide](orbit-zero-offline-ps5.md).
+
+The full-screen screenshots show the desktop interface. Connection, storage and transfer values are illustrative.
+
+![Orbit Zero Discover with a featured game and illustrated catalogue rows](../assets/orbit-zero-development/discover.jpg)
+
+*Discover in Orbit Zero.*
+
+## What you need
+
+- A computer with internet access and enough free space to cache the full download, plus writable storage on the PS5.
+- A PS5 with its jailbreak and Payload Manager or a compatible ELF loader already running, or the matching Orbit receiver already started. Zero does not jailbreak the console.
+- Both devices on the same reachable home network. Wi-Fi, Ethernet, or a mixture of both work. Use the PS5's local IPv4 address.
+- Orbit Zero and the matching Orbit Store 1.0.0 service. Native TV controls also require this release’s FFPKG.
+
+Downloads are available for **ARM64 and x64 on macOS, Windows and Linux**; 32-bit x86 is not supported. Mac builds use Developer ID signing but are not notarized; Windows and Linux packages are unsigned. The initial desktop interface is English-only.
+
+## Install Orbit Zero
+
+Follow the [macOS, Windows and Linux installation guide](orbit-zero-installation.md). It covers the right download for your computer, installation, first-launch permissions and updating an existing copy.
+
+## Connect the computer and console
+
+1. Start the PS5's jailbreak and Payload Manager or ELF loader. Open **Console** in Zero and enter the PS5's local IP address.
+2. Expand **Start Orbit on PS5**. For Payload Manager's web interface, choose **Payload Manager → Upload and start Orbit**. This saves or replaces `orbit_store.elf` in the manager and leaves autoload settings unchanged. For a separate raw loader, choose **ELF loader → Send to ELF loader**. Zero checks the official GitHub payload feed for a compatible receiver, verifies its checksum and caches it. The app also includes a verified compatible receiver for offline setup. If the matching receiver is already running, use **Connect to Orbit** instead. Do not start another Orbit service on the same port.
+3. Zero connects automatically after uploading Orbit. Once connected, select **Show code on PS5**. Enter the six-digit code shown by the console and select **Pair with PS5**. You can request the notification again after the countdown, or open **Pair devices** in Orbit on the PS5 to keep its code visible.
+4. Open a game and choose its source and PS5 destination in the download sheet. The destination is selected for each download; the Console overview shows current storage capacity. Game details also offers **Favourite**, **About this game** and **View download** when that game is already in the queue.
+
+![Orbit Zero game details with download, favourite and About controls](../assets/orbit-zero-development/game-details.jpg)
+
+*Game details in Orbit Zero.*
+
+![Orbit Zero download sheet with source and destination choices](../assets/orbit-zero-development/download-options.jpg)
+
+*Download options in Orbit Zero, with simulated destination capacity.*
+
+The normal Orbit service port is **34177**. Payload Manager's web interface defaults to **8084**, while the raw ELF loader defaults to **9021**. These use different protocols: changing the port alone does not switch between them. Choose the matching method, then use **Start Orbit on PS5 → Advanced** if its port is different. Manual ELF selection is there too; a custom ELF sent through Payload Manager is saved as `orbit_zero_custom.elf`.
+
+On macOS, allow Orbit Zero to access the local network when prompted. If access was denied, enable it in **System Settings → Privacy & Security → Local Network**, then reconnect.
+
+Pairing is saved using the computer's encrypted credential store. After reopening Zero, select **Console → Reconnect** to unlock it; macOS or Linux may request permission at that point. Opening or browsing Zero does not unlock the credential store. Zero never receives your computer password, and refuses to save an unencrypted pairing if secure storage is unavailable. Keep the original pairing to resume unfinished transfers.
+
+![Orbit Zero Console showing connection, download preference, storage and active transfer panels](../assets/orbit-zero-development/console.jpg)
+
+*Console in Orbit Zero. Connection, storage and transfer values are simulated.*
+
+## Choose where downloads run
+
+| Preference | New downloads |
+| --- | --- |
+| **Computer** (default) | Download through the computer and transfer completed chunks to the PS5. |
+| **Prefer PS5** | Check whether the PS5 can reach the selected source, then use a direct PS5 download if it can. Otherwise, use the computer. |
+
+Change this under **Console → Download preference**. It applies to new downloads; running downloads keep their original route. The PS5 needs internet access for direct PS5 downloads. For computer downloads, the computer handles provider access and artwork, so the PS5 only needs its local network connection.
+
+Zero uses up to eight download connections when the provider supports validated byte ranges, with a single-connection fallback. Actual speed depends on the provider, network and storage. **Downloads** shows **Download to computer** and **Transfer to PS5** separately; their rates and progress can differ. A direct PS5 download shows the rate reported by Orbit.
+
+![Orbit Zero Downloads showing separate computer download and PS5 transfer progress](../assets/orbit-zero-development/downloads.jpg)
+
+*Downloads in Orbit Zero. Progress and rates illustrate the two stages; they are not measured transfer results.*
+
+For Vikingfile, Zero opens a separate browser window on the computer. Complete any provider verification and select the matching file's Download button. Zero captures and checks the final file link before adding it to the queue. Provider logins stay in a separate persistent browser profile on the computer. Premium-account behaviour depends on Vikingfile; Orbit Zero does not guarantee premium features.
+
+## Control it from the PS5
+
+After pairing the computer, open **App settings → Orbit Zero → Enable Orbit Zero** in the matching TV app. It uses the computer's catalogue and artwork, and new downloads follow the preference saved on the computer. Vikingfile verification asks you to continue on the computer. Turning Zero mode off affects new downloads; existing computer transfers keep their route.
+
+Alternatively, expand **Console → How it works** in the desktop app. Open one of the displayed computer addresses in the PS5 browser and enter the computer's pairing code. This browser pairing code is separate from the console code used to pair the desktop. Keep it private. The desktop's local browser service normally uses port **34179**.
+
+## Pause, reconnect and clean up
+
+Keep Orbit Zero open and prevent the computer from sleeping during transfers. Keep the PS5 awake to receive files. If the console disconnects after a transfer starts, the computer can continue downloading into its cache. Reconnect the original console and select **Resume**. Paused or interrupted downloads need an explicit resume after restarting Zero.
+
+The full computer cache remains after completion until you select **Remove computer cache**. Removing that completed cache keeps the finished PS5 file. **Cancel and remove partials** asks for confirmation before deleting the transfer's partial files. Cancelled computer downloads offer **Remove from history**, which removes only the queue entry and keeps files.
+
+To forget the console, use **Console → Connection settings → Unpair PS5**. Finish or cancel unfinished computer transfers first, including paused or interrupted transfers, because they require the original pairing to resume. Unpairing keeps files and download history.
+
+Library is read-only in the first desktop version. Zero transfers files; it does not install or launch games.
+
+Return to the [Orbit Store README](../README.md) for the current release, supported PS5 workflows and third-party content notice.

guides/troubleshooting.md

@@ -30,7 +30,7 @@ If the session times out, the provider page changes or the browser restarts, ret
 
 ## Internal storage or an M.2 SSD is missing
 
-If the drive disappeared after updating to 0.9.0, install **Orbit 0.9.1**, restart the download service and refresh storage. Native app users should also update the TV app to **1.2.2**, which includes the fixed service. Replacing the FFPKG alone does not replace a service that is already running.
+If the drive disappeared after updating to 0.9.0, install **Orbit 1.0.0 or later**, restart the download service and refresh storage. Native app users should also update the TV app to **1.3.0 or later**, which includes the fixed service. Replacing the FFPKG alone does not replace a service that is already running.
 
 An available drive appears even if its `homebrew` folder has not been created yet. Orbit creates the folder when needed and checks actual write access when a download starts or resumes. If the destination cannot be written, the download stops and existing partial data is kept.
 

llms.txt

@@ -8,7 +8,7 @@ Orbit requires a PS5 environment capable of loading homebrew ELF payloads. Compa
 
 Run orbit_store.elf through a payload manager or ELF loader, then open Orbit Store from the PS5 Media tab. Phone and computer controls are available at http://<ps5-ip>:34177/ on the same local network. Pair devices keeps the code visible on the PS5; Show code on PS5 repeats its notification.
 
-Version 0.8.0 introduced optional TorBox downloads, ten interface languages, Discover as the opening page with Latest releases and a paged All games grid, refined native/browser controls and reconnection after waking from rest mode. Keep the PS5 awake during transfers; this does not add downloads during rest mode. The current native app version is 1.2.2 and includes service 0.9.1. Copy PPSA99177.ffpkg to /data/homebrew/ and open it from the Games row using kstuff and ShadowMountPlus. A compatible ELF loader on port 9021 lets it start the bundled service; restart an older running service to use the new version. Orbit offers 705 games with single-file FFPFSC, exFAT and FPKG options from Archive.org and Vikingfile. Browse sorts by verified release date, newest first, with undated titles afterward.
+Version 0.8.0 introduced optional TorBox downloads, ten interface languages, Discover as the opening page with Latest releases and a paged All games grid, refined native/browser controls and reconnection after waking from rest mode. Keep the PS5 awake during transfers; this does not add downloads during rest mode. The current native app version is 1.3.0 and includes service 1.0.0. Copy PPSA99177.ffpkg to /data/homebrew/ and open it from the Games row using kstuff and ShadowMountPlus. A compatible ELF loader on port 9021 lets it start the bundled service; restart an older running service to use the new version. Orbit offers 705 games with single-file FFPFSC, exFAT and FPKG options from Archive.org and Vikingfile. Browse sorts by verified release date, newest first, with undated titles afterward.
 
 Version 0.9.0 refreshes the native and browser interfaces. The game page opens Download options with Source, Download using and Save to panels. New on Orbit highlights recently added games in release-date order; Browse and Discover’s All games show 96 games per page. It also improves M.2 detection and cancelled-download cleanup and retry. Native app 1.2.1 includes service 0.9.0.
 
@@ -24,7 +24,7 @@ Payload-manager integration is opt-in. App settings → Payload managers → Add
 
 Catalogue additions and updated links arrive automatically. App settings → Game catalogue → Refresh catalogue checks for additions manually. The last available catalogue remains accessible offline; an internet connection is needed to download games. Queued downloads keep the files originally chosen. App features and fixes still require an Orbit update. To restore a deleted Orbit icon, start Orbit through the payload manager; settings and the download queue stay saved.
 
-Orbit supports four connections for new large downloads when the host supports ranges and a strong file identity. Existing partials keep their original layout; other downloads use one connection. Direct-only queues require 0.7.0 or later; queues or history containing TorBox jobs require 0.8.0 or later. It also fixes Browse search navigation: Up returns to the page tab, Down enters results or collection controls, and Left/Right keep text editing.
+Orbit supports up to eight connections for new large downloads when the host supports ranges and a strong file identity. Existing partials keep their original layout; other downloads use one connection. Direct-only queues require 0.7.0 or later; queues or history containing TorBox jobs require 0.8.0 or later. It also fixes Browse search navigation: Up returns to the page tab, Down enters results or collection controls, and Left/Right keep text editing.
 
 The browser version checks for updates on opening and displays a dismissible notice when a newer version is available. Installation and restart remain manual. After upgrading, use 0.4.2 or later because older builds cannot read its saved queue format.
 
@@ -42,9 +42,13 @@ Orbit 0.8.0 uses the current catalogue feed. Earlier apps retain their bundled o
 
 The native app shares the catalogue, queue, favourites and Library with the browser version. Native App settings includes Download sources, Storage, Pair a device, Game catalogue and Updates. More settings opens browser-only setup and diagnostics. Vikingfile browser options carry the selected game, source and destination into the browser; opening it never starts a download. Browser App settings → TV app installs or updates the native FFPKG; close the TV app before replacement. Native App settings → Updates has separate TV app and download service controls. Restarts require confirmation. The 0.6 browser interface displays a dismissible native-app announcement linking to the GitHub release.
 
+Version 1.0.0 introduces Orbit Zero for macOS, Windows and Linux (ARM64 and x64). The computer downloads and transfers completed chunks to PS5 over the local network, using Wi-Fi or Ethernet. The PS5 needs no internet for this route; its jailbreak and Payload Manager or ELF loader must already be running. Zero can upload the compatible ELF, pair using a console code, and show separate download and transfer rates. Native App settings → Orbit Zero enables computer queue controls on PS5. Computer is the default route; Prefer PS5 checks source access before choosing direct console downloads. The first desktop interface is English-only. Its private implementation is separate from the GPL PS5 service and native app; public releases include the corresponding PS5 source bundle and desktop dependency notices.
+
 ## Documentation
 
 - [Project overview](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/README.md): Features, current screenshots, setup, controls and beta limits.
+- [Orbit Zero installation](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/guides/orbit-zero-installation.md): Mac, Windows and Linux installation, permissions and pairing.
+- [PS5 without internet](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/guides/orbit-zero-offline-ps5.md): Start Orbit and download through the computer on a local network.
 - [Getting started](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/guides/getting-started.md): Installation, Payload Manager, updates and phone pairing.
 - [Downloads](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/guides/downloads.md): Browse, sources, formats, Vikingfile's PS5 browser steps, storage and queue controls.
 - [Library](https://raw.githubusercontent.com/saawant12/orbit-store-ps5/main/guides/library.md): Inventory labels and compatible ShadowMount actions.