GitHubHelp

MZAWeb/omagames

★ 2Forks 0C++GitHub ↗Compare

README

Omagames

CI

Small, polished games for Omarchy, built with Qt Quick and C++ in the spirit of omawrite and omacalc: dead simple, keyboard first, and automatically following the Omarchy theme, system dark/light mode and text size.

Game Directory What
Omadoku games/omadoku Sudoku with four technique-graded levels, notes, digit highlighting and validate-as-you-go
Black Omack games/blackomack Casino blackjack with a persistent Omabucks bankroll and AI table mates
Omanix games/omanix Xonix: cut the sea, dodge the balls, claim 75% of the field; three difficulties and high scores
Omasweeper games/omasweeper Minesweeper with Beginner, Intermediate and Expert boards and best times
Omasnake games/omasnake Snake: eat the dots, grow longer and faster, and never touch the wall or your own tail; Classic or Wrap edges, three speeds and high scores
Omatris games/omatris Tetris: stack the falling blocks, clear lines, chase the level; marathon, a 40-line sprint and an endless calm mode
Oma2048 games/oma2048 2048: slide the tiles, merge equal pairs into bigger ones, reach 2048 and keep going; one-level undo and high scores

Each game has its own README with rules and keyboard shortcuts.

Omadoku Black Omack
Omadoku, a Medium puzzle with the 7s highlighted and the control rail beside the board Black Omack house table with four table mates, your turn, the coach suggesting Hit
Omanix Omasweeper
Omanix, cutting a trail across the sea with balls closing in Omasweeper, an Intermediate board opening up
Omasnake Omatris
Omasnake, the snake winding towards a dot Omatris, a Marathon game with the hold box and next queue
Oma2048
Oma2048 mid-run, merged tiles gathering along the bottom with the score ahead of the best

This is a monorepo: games live under games/, everything shared (theming, fonts, app bootstrap, common QML controls) lives under common/ and is compiled into each game. Each game ships as its own Arch package.

Install

One line per game, on Omarchy (or any Arch):

curl -fsSL https://raw.githubusercontent.com/MZAWeb/omagames/main/install.sh | bash -s omadoku
curl -fsSL https://raw.githubusercontent.com/MZAWeb/omagames/main/install.sh | bash -s blackomack
curl -fsSL https://raw.githubusercontent.com/MZAWeb/omagames/main/install.sh | bash -s omanix
curl -fsSL https://raw.githubusercontent.com/MZAWeb/omagames/main/install.sh | bash -s omasnake
curl -fsSL https://raw.githubusercontent.com/MZAWeb/omagames/main/install.sh | bash -s omasweeper

It builds a real Arch package with makepkg and installs it with pacman, so sudo pacman -R omadoku removes it cleanly. Pass several games at once to install them together.

Build & run

bin/build            # build every game -> build/games/<game>/<game>
bin/build omadoku    # build one game
bin/run omadoku      # build + launch
bin/test             # run every QtTest suite headlessly (bin/test omadoku or bin/test common for one)
bin/install omadoku  # build + makepkg -fsi the Arch package

Requirements: Qt 6 (qt6-base, qt6-declarative), xdg-desktop-portal and a portal backend for live dark-mode / text-scale updates.

Pass --theme-file path/to/colors.toml to any game to preview it in another Omarchy theme.

Layout

common/        shared C++ (OmarchyTheme, SystemTheme, OmaGames::setupApplication), QML module `OmaGames`, fonts, tests/
games/<name>/  <name>.pro, src/ (engine + QML), tests/, pkgbuild/, README.md
docs/          ARCHITECTURE.md, NEW-GAME.md, PARALLEL-AGENTS.md
bin/           build / run / test / install
install.sh     the one-line installer above
screenshots/   images used by this README

Contributing

  • docs/ARCHITECTURE.md — how a game is structured and why.
  • docs/NEW-GAME.md — step-by-step guide to add a game.
  • CLAUDE.md — the rules every change must follow (humans and agents alike).
  • docs/PARALLEL-AGENTS.md — running several coding agents at once with git worktrees.

The iA Writer Mono font is bundled under the SIL Open Font License 1.1; see common/fonts/OFL.txt. MIT licensed, see LICENSE.

Contributors

MZAWebclaude

Issues