Skip to main content
Docs

Search documentation

0 articles

    Contents

    Ouros X for Linux preview

    Preview status​

    Ouros X for Linux is a separate native client. It does not include every feature of the Mac app. The Mac walkthroughs, keyboard shortcuts and permission dialogs do not all apply to Linux.

    The Linux preview download is an unsigned Arch package for x86_64 Intel/AMD Omarchy. Its package version is 0.2.1-1. There is no published ARM Linux package or package for other distributions in this release. Do not use the Mac disk image on Linux.

    This build runs installed on native Omarchy Wayland. It is a preview: Mac feature parity, and account, provider, microphone, audio, OCR and music workflows, are not yet established on Linux.

    Check your system​

    Run uname -m; it must report x86_64. The packaged launcher and shortcuts target an Omarchy desktop with Hyprland 0.56.2 or later, a user systemd session, Wayland and a compatible Vulkan driver. The staged Wayland and X11 checks above do not establish acceptance of the installed desktop integration.

    Pacman checks these declared dependencies from your configured repositories:

    alsa-lib bash chromium docx2txt espeak-ng ffmpeg fontconfig freetype2
    gcc-libs glib2 glibc gsettings-desktop-schemas hicolor-icon-theme
    hyprland>=0.56.2 jq libxcb libxkbcommon libxkbcommon-x11 omarchy openssl
    perl pipewire-audio polkit poppler python sqlite systemd tesseract
    tesseract-data-eng unrtf unzip util-linux vulkan-driver
    vulkan-icd-loader wayland

    Document import needs docx2txt, Perl, unzip, unrtf and Poppler. OCR needs Tesseract and its English data. Speech and audio need espeak-ng, FFmpeg and PipeWire audio. A window opening does not prove those workflows work.

    Keep your existing Secret Service provider with a persistent default keyring, and configure your normal desktop polkit authentication agent in the same user session. The package includes the exact owner-authentication policy; it does not approve prompts, create or unlock a keyring, sign into a provider or grant account access. Enter your password only into the normal local authentication prompt, not into a chat or website.

    Download and verify​

    Download Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst from the official download page. In the folder containing it, run:

    sha256sum ./Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst

    The full SHA-256 must be:

    7ff8a651e279712d40dbfb94e2db9dc89eb797daa640bdd1ce82cf7ec768ae69

    The file is 13,137,797 bytes. If the checksum differs, stop and download again. A checksum checks the bytes; it is not a publisher signature. This preview package is unsigned. Do not weaken your package-signature policy to accept it; if your configured policy refuses unsigned local packages, stop rather than bypassing the refusal.

    Install and open​

    Save your work and close any existing Ouros workspace normally first. If you previously installed a preview manually, read the ownership checks below before proceeding.

    sudo pacman -U ./Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst
    systemctl --user daemon-reload
    /usr/bin/ouros setup
    /usr/bin/ouros invoke

    Run setup and invoke as your desktop user, never as root. Pacman asks for normal owner authentication and checks dependencies. Do not use --nodeps, --overwrite or a remote install script to work around a refusal.

    The package installs /usr/bin/ouros, the complete workspace under /usr/lib/ouros-gpui/, an app-menu entry, on-demand user services and the owner-authentication policy. Setup adds Super+Space to toggle the workspace and Super+Shift+F to open Files. You can also open Ouros from your app menu. Hiding and reopening retains the GUI process; the terminal service has its own lifecycle.

    Keep existing work and resolve ownership conflicts​

    An older manual installation can already own /usr/bin/ouros or /usr/lib/ouros-gpui/. A user-local launcher, desktop entry or systemd unit can also shadow the package. Do not force installation over those files or delete them without reviewing who owns and uses them.

    Before changing an existing installation, inspect:

    command -v ouros
    pacman -Qo /usr/bin/ouros /usr/lib/ouros-gpui/bin/ouros-gpui
    systemctl --user show ouros-gpui.service -p FragmentPath -p DropInPaths
    systemctl --user show ouros-gpui-sessiond.service -p FragmentPath -p DropInPaths
    /usr/bin/ouros --identity

    A path reported as unowned is not permission to overwrite it. Packaged services should resolve to /usr/lib/systemd/user/ without unreviewed overrides. ouros setup refuses overridden services. Use the earlier installation's managed updater, or deliberately reconcile its launchers, user services and menu entry before continuing. Preserve notes, settings, credentials, edited files and live terminal sessions. Do not unload compositor integration or delete user configuration as a shortcut.

    Preview updates are manual. Do not stop the terminal service just to update or close the GUI. If there is no compatible package for your system, keep using the version that already works for you. For Mac installation instead, see Install Ouros X on Mac.