Repository navigation
Important
1.5 is a fresh install. The base system and kernel changed, so fresh install is required. Back up anything you need from Desktop Mode first. Games on a separate microSD card are not touched.
The project has a new name: Zaviya, based on SteamOS for ARM. Formerly known as Unofficial SteamOS ARM Port.
New base, new kernel, a new installer and a lot of fixes. This release is for the handhelds, tablets come later.
Install
Download the one file for your chip and flash it to a microSD card (32 GB or larger):
| Chip | Devices | Image |
|---|---|---|
| 8 Elite | AYN Odin 3, KONKR Pocket FIT Elite | zaviya-sm8750-1.5.0.img.zst |
| 8 Gen 3 | KONKR Pocket FIT, AYANEO Pocket S2 / S2 Pro | zaviya-sm8650-1.5.0.img.zst |
| 8 Gen 2 | AYN Odin 2 / Mini / Portal / Thor, AYANEO Pocket ACE / DMG / DS / EVO / S, Retroid Pocket 6 / Nova | zaviya-sm8550-1.5.0.img.zst |
| 865 | Retroid Pocket 5 / Flip 2 / Mini, AYN Thor Lite and others | zaviya-sm8250-1.5.0.img.zst |
Rufus 4.7 or newer flash the .img.zst directly. For balenaEtcher, extract the .img first with 7-Zip 24.01 or newer. Checksums are in SHA256SUMS, attached below and at https://downloads.zaviyaos.workers.dev/1.5/SHA256SUMS.
Guides are on the website: https://zaviyaos.github.io/
Changelog
-
New name and look
- Zaviya: boot animation, startup and sleep movies, wallpaper, login and lock screens
- Handheld Control is now Zaviya Control
- New website and a Refreshed Discord
-
All chips
- Steam Frame 0.6.0 base, Linux 7.4-rc1 and Mesa 26.2.7 on every chip
- Desktop Mode is on Plasma 6.6.2
- New installer for internal storage: full screen, works with the pad and touch, and runs from Game Mode. It blocks sleep while it works and won't start on a low battery that isn't charging
- Record logs: a button in Zaviya Control and an icon on the Desktop Mode desktop save everything needed for a bug report into one file in
~/zaviya-logs. Wi-Fi passwords and account files are left out - The system partition has 4 GB free instead of 1.5 GB, and caches are cleared at boot when it gets nearly full, so a full disk no longer ends in a Game Mode restart loop
- Sleeping from a microSD install could reset the handheld, fixed on 8 Gen 3, 8 Gen 2 and 865
- Fixed pressing power while it is going to sleep keeps it awake
- The sleep report in the logs says what woke the handheld
- Decky runs as a native arm64 loader, old installs are repaired
- Performance overlay: right battery percent, Qualcomm temperatures, frametime lines up
- Wi-Fi optimizations
- Android optimizations
- Steam's first time setup fixed
-
8 Gen 3 (KONKR Pocket FIT, AYANEO Pocket S2)
- Pocket FIT: Button remapping beta
- AYANEO Pocket S2: headphone jack detection
-
8 Gen 2 (AYN, AYANEO, Retroid)
- AYN Thor: the power key no longer wakes it with the lid closed
- AYN Odin 2 Portal: internal microphone, and the gamepad powers down during sleep
- AYN Odin 2: calmer fan in menus, internal storage fix
- AYANEO Pocket DS: sleep no longer aborts at random
- Retroid Pocket 6: headphone jack detection
- Retroid boards: Steam + A opens Quick Access
-
8 Elite (AYN Odin 3, KONKR Pocket FIT Elite)
- Sound over USB-C to a monitor is back once again
- AYN Odin 3: internal microphone test
-
865 (Retroid Pocket 5 / Flip 2 / Mini, AYN Thor Lite and others)
- Now a regular part of the release instead of a separate beta
- Retroid Pocket 5, Flip 2 and Mini: sleep works, sound and volume down fixed
- Retroid Pocket Flip 2: internal microphone
- AYN Thor Lite: the two screens were assigned the wrong way round for brightness, fixed
- Steam Remote Play video works
Known issues
- KONKR Pocket FIT Elite: charge limit
- AYN Thor Lite: some units might show a white upper screen, logs from an affected unit are welcome
- Stick and trigger calibration is not in yet, in works.
Thanks to @dbarth, @TheWeaklessOne, @FearlessSpiff and @Chazmus for patches and testing, and to everyone reporting on Discord.
If something broke or a bug is still there, report it in the Discord or open an issue, and attach the file from Record logs.