Omahub
← All plugins
G

Omatruco

by Gabriel Follone

Truco paulista playable from the Omarchy bar: full rules, CPU opponents in 1v1 or 2v2, and a saved game you can pick up between tasks.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
2ef4d22
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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
2ef4d22
Reviewed
1 month ago

The Omarchy plugin is a self-contained Truco card game. The sampled files (README, QML, and JavaScript) contain only game logic, UI definitions, and test code. There is no evidence of network access, shell execution, obfuscation, credential handling, or destructive commands. The state-management code (Model.js) appears to handle game state and persistence in a straightforward manner. The automated scan reported no issues. The only functional risk is that the plugin persists game state to disk, but no details of that are visible in the sample and it is limited to the user's own save file.

  • None identified in the provided files. The code is transparent and performs only in-memory/state operations for a local game.
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/This-Is-NPC/omatruco --enable
Other #bar #quickshell #games

Omatruco

Truco paulista in your Omarchy bar, against the CPU.

Omatruco

Install

omarchy plugin add https://github.com/This-Is-NPC/omatruco.git
omarchy plugin enable omatruco

The widget shows the score in the bar and lights up when the table is waiting on you. omarchy plugin disable omatruco takes it off the bar; omarchy plugin remove omatruco uninstalls it.

Game modes

Mode Table
One on one You against the CPU
Pairs (2v2) You and a CPU partner against two CPUs

Pick the mode on the start screen and hit Play. Changing mode starts a new match.

The table

You sit at the bottom, your partner across from you, opponents on the sides, and the vira in the middle. Every seat shows the card it played this round or, until it plays, how many cards it still holds. The card winning the round is highlighted, and a finished round stays on the table until somebody plays again.

Each hand is 3 rounds — win 2 and you take the hand. First to 12 points wins the match.

Features

  • Full truco paulista rules — manilha set by the vira, the truco / six / nine / twelve ladder, hand of eleven and the 11–11 iron hand.
  • Truco animation — a call explodes across the panel, and while the answer is yours a banner above the buttons says what accepting is worth.
  • Hand history — every round lined up in columns, one per player, with the winning card highlighted and the hand result at the end.
  • Contextual hint — for people learning the game: it names the manilha and your best card, tells you what folding costs, explains the hand of eleven.
  • Two languages — the interface ships in Portuguese and English; one button switches, and the choice is saved with the game.
  • Saved game — the match lives in ~/.local/state/omarchy/omatruco.json and resumes exactly where you left it, on every monitor's bar.
  • Light — nothing runs in the background: no polling, and the CPU's timer only exists while it is thinking with the panel open.

Truco

Controls

Action Mouse Keyboard
Play a card Click it 1 2 3
Call truco / six / nine / twelve The raise button t
Fold Fold c
Toggle the hint Lightbulb icon d
Open the history History icon —
Switch language PT / EN icon —
Restart the match Restart icon —
Move and confirm Hover and click arrows or hjkl, Enter
Close the panel Click outside Esc

Enter with no cursor only advances the game — it never bets for you.

Development

node test/model-test.js     # rules, raises and 80 full matches
omarchy plugin validate .   # manifest against the shell's schema

MIT. See LICENSE.