Skip to content

linux-preview-4

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 31 Jul 11:21

u64deck v1.9.0 — Linux Preview 4

Identity: u64deck v1.9.0 · Linux Preview 4 · build 4606bef
Base lineage: Windows v1.9.0 RC44 · build fc1e0fb

Linux Preview 4 is a source-run preview published alongside the Windows release in the same repository. It is not a frozen ELF or AppImage. Windows remains the stable, supported distribution; this Linux preview is provided as-is for testing and issue reports.

Install & run (Linux)

Download the .tar.gz below, then:

tar xzf u64deck-v1.9.0-linux-preview.4.tar.gz
cd u64deck
./install.sh
./u64deck.sh

install.sh sets up a private virtualenv and adds an app-menu entry — no sudo, no system changes. ./u64deck.sh launches u64deck. After first run you can start it from your apps list. Data lives under ~/.config/u64deck and ~/.local/share/u64deck (not beside the scripts). See the bundled README.md / LINUX-PREVIEW.md for upgrade, import-from-Windows, and troubleshooting.

Hardware-tested Linux environment

  • Ubuntu 24.04.4 LTS
  • amd64 / x86-64
  • Linux kernel 6.8.0-136-generic
  • Ubuntu GNOME under Wayland
  • Python 3.12.3
  • Chromium 150.0.7871.128 from Canonical's stable Snap channel

The maintainer hardware-tested installation and application-menu launch, Chromium app-window mode, Ultimate discovery and connection, screen mirror at approximately 50 fps, HDMI audio, fullscreen, recording, Legacy physical-F7 guidance, local SID/HVSC and storage indexing, SID Search, SIDFlow download/verify/import and recommendations, SID playback, Storage browsing, Mount & Run, upgrade-state retention and clean Exit.

Storage and migration

  • Windows stores config.json, indexes, SIDFlow data, favourites and playlists beside u64deck.exe.
  • Linux stores config.json in ${XDG_CONFIG_HOME:-~/.config}/u64deck/.
  • Linux stores SQLite indexes, SIDFlow data, favourites, playlists and other persistent data in ${XDG_DATA_HOME:-~/.local/share}/u64deck/.
  • import-existing-data.sh imports supported Windows or older-preview files, backs up replaced Linux files, skips WAL/SHM files and warns about Windows paths.

Validation

  • Source tests: 409 passed, 1 warning in 5.08s
  • Extracted-tarball tests: 409 passed, 1 warning in 4.75s
  • Core-integrity manifest: passed
  • Python compile, JavaScript syntax and shell syntax: passed
  • Clean XDG install, API identity, config save and graceful Exit: passed
  • Owned Chromium-process cleanup: passed
  • Data import, backup and Windows-path warning checks: passed
  • Update and rollback smoke: passed
  • Archive hygiene and personal-path scan: passed
  • Archive entries: 132 files

The dependency-download path was hardware-tested on the Ubuntu NUC. The packaging sandbox had no public package-index access, so its clean installer validation used the same installed dependency versions exposed to an isolated virtual environment.

Artifact

u64deck-v1.9.0-linux-preview.4.tar.gz
SHA-256: 6f2686aa6fe72cd2a21d96b45df6f357a4963aa3ff681ee6f7a83c4aeb39236f

The archive contains no config.json, SQLite databases, WAL/SHM files, downloaded SIDFlow data, caches, bytecode, .git, .venv, diagnostics or personal runtime data.