ESC
开源 2 分钟阅读

omakade：为 Omarchy 打造的精美本地优先游戏库

Omakade 是一款为 Omarchy 构建的本地优先游戏库应用，可将 Steam、Lutris、Heroic、RetroArch、Epic、GOG、Amazon 等多平台游戏聚合到统一的封面式界面，支持 Omarchy 主题联动、本地成就、收藏集、IGDB 评分与手柄导航，核心功能完全离线可用，已上架 Omarchy 软件仓库，采用 GPL-3.0 许可证。

来源：GitHub

Omakade

CI License: GPL-3.0-or-later

你的游戏，精美齐聚。

Omakade 游戏库展示来自多个启动器的已安装游戏

观看 18 秒演示视频

Omakade 是一款为 Omarchy 打造的快速、本地优先的游戏库。它将已安装的 Steam、Lutris、Heroic、Faugus、RetroArch、Epic、GOG 和 Amazon 游戏汇聚到一个安静、以封面为核心的统一界面，并跟随当前 Omarchy 主题。

项目主页 · 路线图 · 支持

Omakade 是一个独立的社区项目，并非官方的 Omarchy 应用。

当前版本

Omakade 包含：

  • 原生与 Flatpak 版 Steam、Lutris、Heroic、Faugus 和 RetroArch 的游戏发现，包括侧载到 Heroic 中的游戏
  • 一键查看详情，并通过所属平台委托启动
  • Omarchy 配色、字体、透明度与实时主题更新
  • 搜索、收藏、隐藏游戏、排序与来源筛选
  • 运行时来源控制，含扫描状态与检测到的位置
  • 可选的启动后自动关闭行为
  • 收藏集、标签、完成状态与智能组织筛选
  • 本地 Steam 成就，以及可选的 Web API 增强
  • 可选的 Steam 拥有库同步，提供已安装与待安装视图
  • 可选的 IGDB 媒体评分汇总与游戏时长预估
  • 本地、下载及用户自选的封面图
  • 对通过多个来源安装的游戏进行显式关联
  • ProtonDB 和 PCGamingWiki 快捷方式，附带可操作的启动错误信息
  • 键盘、鼠标与手柄导航

Omakade 游戏详情展示游戏时长、IGDB 洞察与 Steam 成就

Omakade 只读取启动器数据，不会对其修改。核心的发现、浏览、封面和启动功能均可离线工作。运行 omakade --demo 可通过一个确定性的虚拟游戏库探索界面。

在 Omarchy 或 Arch 上安装

从 Omarchy 软件仓库安装或升级

在 Omarchy 上，通过 OPR 安装 Omakade：

sudo pacman -S omarchy/omakade

之后，Omakade 会随正常的 Omarchy 系统更新一起更新。

从终端安装或升级

以下命令会将 Omakade 及其校验文件下载到当前目录，验证软件包并安装。如果已安装 Omakade，pacman -U 会原地升级，不会移除你的设置或库数据：

curl -fLO https://github.com/tsouth89/omakade/releases/download/v1.3.1/omakade-1.3.1-1-x86_64.pkg.tar.zst
curl -fLO https://github.com/tsouth89/omakade/releases/download/v1.3.1/SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing
sudo pacman -U ./omakade-1.3.1-1-x86_64.pkg.tar.zst

通过浏览器下载安装或升级

  1. 打开最新发布页面。
  2. 在 Assets 下，将 omakade-1.3.1-1-x86_64.pkg.tar.zst 和 SHA256SUMS 下载到同一文件夹。
  3. 在该文件夹打开终端并运行：
sha256sum -c SHA256SUMS --ignore-missing
sudo pacman -U ./omakade-1.3.1-1-x86_64.pkg.tar.zst

从应用启动器启动 Omakade，或在终端运行 omakade。

包含未安装的 Steam 游戏

Omakade 默认显示已安装的游戏。若要包含 Steam 库中的其余游戏，请打开设置，保存你的 Steam ID 和 Web API 密钥，然后选择 Sync owned Steam library。你的 Steam 游戏详情必须为公开状态。同步后，可在库中使用 All Games 或 Ready to Install。安装会交由 Steam 处理。

在软件包升级或卸载时，Omakade 会保留其本地库和设置。游戏、账号、更新、云存档、DRM 及兼容性工具仍由所属启动器负责。

RetroArch 游戏来自其配置的播放列表。Omakade 使用本地 RetroArch 缩略图和运行时日志，并使用分配的核心启动每个游戏。没有核心关联的条目仍然可见，并在你按下 Play 后说明如何修复启动。

构建

要求：

  • CMake 3.24 或更新版本
  • Ninja
  • C++20 编译器
  • Qt 6.8 或更新版本，包含 Concurrent、Core、Gui、Network、Qml、Quick、Quick Controls、SQL 和 Test 模块，以及 SVG 和图像格式插件
  • SDL 3
  • libsecret
cmake --preset dev
cmake --build --preset dev
ctest --preset dev
./build/dev/omakade

使用 Ctrl+F 搜索，方向键导航，Enter 打开详情，Escape 返回，F11 切换全屏。Ctrl+M 切换减弱动效，Ctrl+D 打开设置和来源诊断。

本地数据

  • 库数据：~/.local/share/omakade/library.sqlite3
  • 设置：~/.config/omakade/config.toml
  • 下载的封面图：~/.cache/omakade/
  • 用户自选自定义封面：~/.local/share/omakade/artwork/

核心的库发现、本地成就、封面图、搜索、组织、手柄导航和启动功能均无需 Steam API 密钥或网络连接。可选的 Steam 连接可同步公开的拥有游戏，并将未安装的游戏交给 Steam 安装。可选的 Steam 和 IGDB 凭证由 Secret Service 存储，缓存的元数据在离线时仍可用。

参见 PRIVACY.md 了解保留的数据和外部请求，CHANGELOG.md 了解发布说明，以及当前的兼容性报告 了解已测试的平台布局。