Omahub
← All plugins
D

OMAFISH

by Doctor

A theme-aware pixel feeding arcade for the Omarchy desktop.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
0db0992
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
0db0992
Reviewed
1 month ago

Reviewed the manifest, QML entry points, game logic, and helper scripts. The plugin is a self-contained arcade game that only reads and writes a small local state file under XDG_STATE_HOME using a hardened Python reader, with no network access, obfuscation, persistence, or destructive operations. The deterministic scan's 'none' finding matches this independent review.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/doctor/omafish --enable
Other #bar #quickshell #games

OMAFISH

OMAFISH is an original, theme-aware pixel feeding arcade that runs natively in the Omarchy Quattro shell. Eat smaller fish, dodge larger predators, chain meals into a five-times frenzy, and grow from a tiny reef snack into the ruler of the abyss.

It uses original code-drawn artwork and synthesized sounds. It is inspired by the broad eat-and-grow arcade genre and is not affiliated with Feeding Frenzy or PopCap Games.

Install

Requires Omarchy 4 or newer with Omarchy Shell enabled. It uses the Python 3 runtime included with Omarchy to safely load its small state file.

omarchy plugin add https://github.com/doctor/omafish.git --enable

Click the fish in the bar, or launch it directly:

omarchy-shell shell summon io.github.doctor.omafish '{}'

How to play

Guide your fish through six escalating waters. Fish smaller than you are food; fish your size or larger are dangerous. Fill the growth bar to clear each stage. Three hits end the run, and getting hit costs some growth. Clear the campaign to unlock the endlessly scaling Endless Current.

  • Mouse: move to swim, click to dash
  • Arrow keys or W/A/S/D: swim
  • Space: dash
  • Enter: start or continue
  • E: start Endless Current after unlocking it
  • P: pause or resume
  • M: mute or unmute
  • R: return to the ready screen
  • Escape: close

Privacy and state

OMAFISH has no network access, accounts, telemetry, services, installers, or privileged commands. It writes only records and the mute preference to:

${XDG_STATE_HOME:-~/.local/state}/omafish/state.json

Closing the overlay ends the active run. Removing the plugin leaves this small state file in place so a reinstall preserves your records.

Update and remove

omarchy plugin update io.github.doctor.omafish
omarchy plugin remove io.github.doctor.omafish

Development

npm test
npm run assets
omarchy plugin validate .

The checked-in WAV files are generated deterministically by tools/generate-sfx.cjs. Plugins execute as unsandboxed code inside Omarchy's long-running shell, so review third-party plugin source before enabling it.

License

MIT © 2026 Doctor