Repository navigation
Releases
Rare OS v0.1.3
The launcher in seven languages, stick lighting, the controller in Desktop mode, and fixes for Battle.net, Epic Games, GOG and ACT.
Fixes
- Get Battle.net on a fresh device. The first install also downloads Proton (about 490 MB) before Blizzard's installer can open. After 45 s Rare said "Battle.net didn't start", and Try again closed the installer halfway, so the install never finished. Rare now keeps its loading screen up until the installer's window opens ("The first time, Rare also downloads Proton") and waits for the install to finish. If it fails, Rare says why and where the log is (
~/.cache/rare/battlenet/install.log). - Epic Games and GOG games start the first time. Same cause: the first start downloads Proton and its runtime and sets up the game's prefix, which can take minutes. That is now the game's own "Setting up" step after the install. It stops only after 10 minutes with no download progress. A failed setup or start now gives the reason (for example "Epic needs you to sign in again", or a Wi-Fi problem) and the log path (
~/.cache/rare/<store>/<app>.log). - ACT no longer opens to a white screen. ACT now draws with GL. A web game whose page crashes reloads, up to 3 times, instead of staying blank.
- Switching from GameOS. A switch started from a phone (rare.market/os) no longer fails at the end with
fsetxattr(security.selinux): Invalid argument. Older GameOS versions no longer stop atfailed to invoke method GetLayerInfo, because the image now has at most 128 layers.
New
- Languages. English, 简体中文, Español, 日本語, Русский, Português (Brasil) and 한국어. Settings > System > Language (or the first-run picker) switches the whole launcher at once. Game titles and store names stay as they are.
- Stick lighting. Settings > Lighting sets the rings around the sticks to Default (the controller's own lights), On or Off. On has Solid, Breathe and Rainbow, a color for both rings or for each one, and brightness. Your choice comes back after a restart and in Desktop mode. Needs the 0.1.3 image.
- The controller works in Desktop mode. Right stick moves the pointer, left stick scrolls, A or RT clicks (hold to drag), B or LT right-clicks, Y opens the on-screen keyboard, the d-pad sends arrow keys, Menu is Enter and View is Esc. Rare opens the app menu. A full screen window or a Steam game gets the controller as a normal gamepad, and Quick switches between the two by hand. Needs the 0.1.3 image.
- Key shortcut on LC or RC. Settings > Controls: LC or RC can hold down a key combination for as long as you hold the button, for push-to-talk apps such as dictation.
- Symbols on the on-screen keyboard. Every symbol is on
?123(or LT) and#+=. Web address fields have./:-and.com, and email fields have@and.com. Hold X to keep deleting, or hold A to keep typing the key. - Chrome has tabs. Apps > Google Chrome opens a normal window with tabs and an address bar. LB and RB switch tabs, d-pad left and right go back and forward, X closes the tab, View opens the address bar and Menu opens a new tab. View + Menu still goes back to Rare.
Rare OS 0.1.3 image
Devices on Rare OS update to it by themselves, or right away with Settings > System update. The image now has at most 128 layers, down from 272, so older GameOS and other older bootc systems can switch to it. Because of that regrouping, the first update from 0.1.2 downloads almost the whole image once (about 6 GB). Later updates download only what changed.
Downloads
| File | What it is |
|---|---|
rare-native-v0.1.3-x86_64.tar.gz |
The native Rare Launcher for x86_64 Linux |
rare-native-v0.1.3-x86_64.tar.gz.sha256 |
Its SHA-256 checksum |
SHA256SUMS |
Checksums of every file in this release |
Install the launcher
On a device running Rare OS:
curl -L --remote-name-all https://github.com/rare-market/rare-os/releases/download/v0.1.3/rare-native-v0.1.3-x86_64.tar.gz{,.sha256}
sha256sum -c rare-native-v0.1.3-x86_64.tar.gz.sha256
tar -xzf rare-native-v0.1.3-x86_64.tar.gz -C ~
mkdir -p ~/.config/rare && echo ~/rare-native/run.sh > ~/.config/rare/launcher-bin
~/rare-native/start.shThe image update brings the same launcher, so most devices don't need these steps. Stick lighting and the controller in Desktop mode also need the 0.1.3 image.
No keyboard on the device? Turn on Settings > System > Remote access (SSH), set a password with the on-screen keyboard, then run the lines above from a phone or computer over SSH (Settings shows the command to connect).
~/rare-native/stop.sh goes back to the launcher built into the image until the next reboot. Removing ~/rare-native (or ~/.config/rare/launcher-bin) undoes the install.
New to Rare OS? See v0.1.0 and rare.market/os.
Rare OS installer 0.1.2
The USB installer for Rare OS 0.1.2. It erases a device's internal drive and installs Rare OS. Use it on a SuiPlay0X1 running Windows or SteamOS, on other x86_64 handhelds and PCs, or for a clean start. A SuiPlay on GameOS can switch in place instead and keep its files: see rare.market/os.
Download
rare.market/os/rare-os-installer.iso (one file, 7.9 GB)
SHA-256: f11cbe1e27f0c6cea4d6db0e306c02312075119230321baef632a6fe797f1874
GitHub takes files up to 2 GiB, so the ISO is also attached below in parts. Joined in order they are the same file:
cat rare-os-installer.iso.part* > rare-os-installer.iso
sha256sum -c rare-os-installer.iso.sha256On Windows, in Command Prompt:
copy /b rare-os-installer.iso.part0 + rare-os-installer.iso.part1 + rare-os-installer.iso.part2 + rare-os-installer.iso.part3 rare-os-installer.iso
certutil -hashfile rare-os-installer.iso SHA256
Install
- Write the ISO to a USB-C stick of 16 GB or more with Fedora Media Writer, balenaEtcher, or Rufus (choose DD image mode). Everything on the stick is replaced.
- Power off the device and plug in the stick. Open the boot menu and pick the stick.
- AYANEO 2S: hold Volume Up + LC, then press Power. With a USB keyboard you can press F7 instead. This comes from AYANEO's own guide.
- SuiPlay0X1: probably the same, since it is built on the AYANEO 2S. It has not been tried on a SuiPlay yet, and the SuiPlay has its own firmware.
- The installer names the internal drive it will erase and counts down from 20 seconds. To cancel, hold the power button until the screen goes off. Nothing is written before the countdown ends. Otherwise it installs and restarts into Rare OS by itself in about 10 minutes.
- When Rare OS has started, unplug the stick. The installer puts Rare OS first in the firmware's boot order, so the restart goes to Rare OS even with the stick still in. If the installer screen comes back instead, hold the power button to turn off, unplug the stick and power on.
The installer only ever picks the internal drive. It prefers an NVMe drive, otherwise it uses the largest other fixed disk. It never touches the stick, other USB drives, card readers or SD cards. If Secure Boot is on, the countdown screen says so. The first start then shows a blue key screen once: with a USB keyboard, choose Enroll MOK, Continue, Yes, type the password rare, then Reboot.
What it installs
Rare OS 0.1.2, which is ghcr.io/rare-market/rare-os:stable (sha256:11367524b29e8aebc6d686bdf6137ca5468fb1c7f7145048c61249435cce6a25). The image is carried byte for byte, and its signature was checked with image/keys/rare-os.pub when the ISO was built. Installed devices update from :stable, and every update is signature-checked.
Tested
Tested in virtual machines (UEFI, QEMU/KVM) with this ISO file, written as a USB stick on a USB 3 (xHCI) controller, with a 64 GB NVMe drive as the internal drive, a 256 GB USB drive and a 128 GB SD card attached:
- Starts from the stick; the countdown screen names the NVMe drive.
- A short press of the power button during the countdown powers off with the drive still blank; so does a hard power-off.
- Installs on the NVMe drive and restarts into Rare OS by itself; the USB drive and the SD card are byte-for-byte unchanged.
- With the stick out, Rare OS starts to the launcher.
bootc statusshows the signedghcr.io/rare-market/rare-os:stableandbootc upgrade --checkpasses the signature check. - A drive holding a Windows-style layout (EFI, Microsoft reserved, NTFS, recovery) is replaced completely.
- With Secure Boot on (Microsoft keys), the stick starts, the key screen enrolls the key with the password
rare, and Rare OS starts with Secure Boot on.
Not yet tried on a SuiPlay0X1 or any other real device.
Files
| File | What it is |
|---|---|
rare-os-installer.iso.part0 ... part3 |
The ISO in parts; join them in order |
rare-os-installer.iso.sha256 |
SHA-256 of the joined ISO |
rare-os-installer.iso.info |
The image, version and digest it carries |
SHA256SUMS |
Checksums of every part and of the ISO |
Rare OS v0.1.2
Type into Steam, games and apps with the pad, and Battle.net games in Library.
Fixes
-
Keyboard over games and apps. Before, nothing could type into Steam's sign-in, a game or an app from the pad. Now Rare's keyboard opens over whatever is on screen and types into it: Steam's sign-in and Steam Guard code, a game's name field, Chrome. Open it with any of these:
- Rare + X
- RC (or LC if you set it to Keyboard in Settings > Controls)
- Quick Settings > Keyboard
- Y in an app you drive with the pad as a mouse
D-pad moves, A types, X deletes, Y is Shift, Menu is Enter, View is Tab, LB and RB move the cursor, B closes. The game or app keeps its focus and gets no pad input while the keyboard is up.
New
- Battle.net. Blizzard games show in Library > Battle.net (and in All and on Home), and Battle.net is in Apps. Apps > Battle.net > Get Battle.net installs it for you, with no terminal step. Rare also finds an existing Battle.net added to Steam as a non-Steam game, or in Lutris, Heroic, Bottles or
~/.wine. Play starts the game through Battle.net, and Quit game closes only the game. World of Warcraft shows a tip for turning on its controller mode.
Changes
- RC in games now opens the keyboard by default (it did nothing before). Because RC is on in games now, holding RC over a game steps the performance overlay (Off, FPS, Basic, Full), as it does in the launcher. To get the old behaviour back, set Settings > Controls > RC in games to Nothing.
- LC in games still does nothing until you pick something, unless LC is set to Keyboard.
Downloads
| File | What it is |
|---|---|
rare-native-v0.1.2-x86_64.tar.gz |
The native Rare Launcher for x86_64 Linux |
rare-native-v0.1.2-x86_64.tar.gz.sha256 |
Its SHA-256 checksum |
SHA256SUMS |
Checksums of every file in this release |
Install the launcher
On a device running Rare OS:
curl -L --remote-name-all https://github.com/rare-market/rare-os/releases/download/v0.1.2/rare-native-v0.1.2-x86_64.tar.gz{,.sha256}
sha256sum -c rare-native-v0.1.2-x86_64.tar.gz.sha256
tar -xzf rare-native-v0.1.2-x86_64.tar.gz -C ~
mkdir -p ~/.config/rare && echo ~/rare-native/run.sh > ~/.config/rare/launcher-bin
~/rare-native/start.shThe launcher-bin line keeps this launcher after a restart (with v0.1.1's steps the device went back to the image's launcher at the next boot).
No keyboard on the device? Turn on Settings > System > Remote access (SSH), set a password with the on-screen keyboard, then run the lines above from a phone or computer over SSH (Settings shows the command to connect).
~/rare-native/stop.sh goes back to the launcher built into the image until the next reboot. Removing ~/rare-native (or ~/.config/rare/launcher-bin) undoes the install.
New to Rare OS? See v0.1.0 and rare.market/os.
Rare OS v0.1.1
Fixes for Steam sign-in and marketplace purchases.
Fixes
- Steam sign-in and Steam Guard show up. When a saved Steam sign-in stopped working (it expired, the password changed, or Steam Guard asks again), Steam's sign-in could stay hidden behind the launcher and Steam games sat on "Starting". The launcher now says "Steam needs you to sign in", opens Steam's sign-in in Big Picture (QR code for the Steam Mobile app, Steam's own keyboard for the code) and starts the game once you are signed in. Library, Home's Steam tile and first run say so too.
- Marketplace: buying some Tradeport listings no longer fails.
- Settings > About shows your Rare Pass card.
Downloads
| File | What it is |
|---|---|
rare-native-v0.1.1-x86_64.tar.gz |
The native Rare Launcher for x86_64 Linux |
rare-native-v0.1.1-x86_64.tar.gz.sha256 |
Its SHA-256 checksum |
SHA256SUMS |
Checksums of every file in this release |
Install the launcher
On a device running Rare OS:
sha256sum -c rare-native-v0.1.1-x86_64.tar.gz.sha256
tar -xzf rare-native-v0.1.1-x86_64.tar.gz -C ~
~/rare-native/start.sh~/rare-native/stop.sh goes back to the launcher built into the image until the next reboot. Removing ~/rare-native undoes the install.
New to Rare OS? See v0.1.0 and rare.market/os.
Rare OS v0.1.0
First public release of Rare OS, a handheld gaming operating system for the SuiPlay0X1 with the Rare Launcher and the Rare Wallet.
Downloads
| File | What it is |
|---|---|
rare-native-v0.1.0-x86_64.tar.gz |
The native Rare Launcher for x86_64 Linux: the launcher, the web game host with its Chromium runtime, the UI assets, the store, Discord and frame generation helpers, and the device scripts |
rare-native-v0.1.0-x86_64.tar.gz.sha256 |
Its SHA-256 checksum |
SHA256SUMS |
Checksums of every file in this release |
Install the launcher
On a device running Rare OS:
sha256sum -c rare-native-v0.1.0-x86_64.tar.gz.sha256
tar -xzf rare-native-v0.1.0-x86_64.tar.gz -C ~
~/rare-native/start.sh~/rare-native/stop.sh goes back to the launcher built into the image until the next reboot. Removing ~/rare-native undoes the install.
Install Rare OS
On a SuiPlay0X1 (or another bootc / rpm-ostree system), from a terminal on the device or over SSH:
curl -fsSL https://rare.market/os/get | sudo bashIt downloads the signed image ghcr.io/rare-market/rare-os:stable (about 8 GB) and installs it next to the current system. Your games and files stay. With Secure Boot on, the script says so and the next start shows a key screen once (USB-C keyboard: Enroll MOK, Continue, Yes, password rare, Reboot). Don't install a GameOS update while it runs. The step-by-step guide is at rare.market/os and in docs/INSTALL.md.
Go back at any time: sudo rare-undo in Rare OS and restart, or pick the old system in the boot menu.
Highlights
- One library for Steam, Epic, GOG, Xbox Cloud Gaming, GeForce Now, Android apps, web games and emulators, with one-press emulator setup.
- Trophies from Steam, Epic, GOG and RetroAchievements, plus Rare trophies verified by the device.
- The Rare Wallet: PIN or phone passkey, recovery phrase, Ledger and Keystone.
- The rare.market marketplace in the launcher and in an in-game overlay.
- Per-game performance settings, cloud saves, instant replay, PC streaming and a phone remote.
Known limitations
- The launcher package is tested on Rare OS. On other distributions it needs Rare's session scripts to start and is not supported yet.