Omahub
← All plugins
C

RPG Dice

by Christopher Rueber

Dice roller for tabletop RPGs: standard polyhedral dice, Fate dice, and user-defined custom dice.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
3edd2df
Scanned
3 weeks 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
3edd2df
Reviewed
3 weeks ago

This is a straightforward QML dice-roller widget with no install-time scripts, network access, or credential handling. The file I/O is carefully bounded and symlink/FIFO-safe, user-provided text is sanitized, and the only shell commands are limited, properly quoted operations for state persistence and playing a bundled sound. No malicious or destructive behavior was found, and the deterministic scan's 'none' rating matches this 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/crueber/omarchy-plugin-rpgdice --enable
Other #quickshell

RPG Dice

An Omarchy shell plugin that rolls tabletop RPG dice from the status bar — standard polyhedral dice, Fate dice, and your own custom dice, with an optional roll sound.

RPG Dice panel

Features

  • Standard dice — d4, d6, d8, d10, d12, d20, d% (d100).
  • Fate dice (dF) — six faces: two -, two blank, two +.
  • Custom dice — numeric (1–1,000,000 sides) or explicit sides (any labels, e.g. heads, tails or 1, 2, sword, shield).
  • Three-section panel — Settings, Dice, Results.
  • Debounced rolling — click any number of dice, then 1.5s after your last click everything rolls together and groups by type (d6: 2, 5, 3 d8: 8).
  • Sound — toggleable roll sound with adjustable volume.
  • Persistent state — sound, volume, and custom dice survive restarts.

Installation

omarchy plugin add ssh://git@git.packden.us:2288/crueber/omarchy-plugin-rpgdice.git --enable

Or clone manually:

git clone ssh://git@git.packden.us:2288/crueber/omarchy-plugin-rpgdice.git \
  ~/.config/omarchy/plugins/crueber.rpgdice
omarchy-shell shell rescanPlugins
omarchy plugin enable crueber.rpgdice center

Removal

omarchy plugin remove crueber.rpgdice --yes

This disables the widget, deletes the plugin, and rescans the shell. Because the plugin is a git checkout, the directory is removed outright (the source stays upstream). Omit --yes to be prompted for confirmation.

To keep it installed but hide it from the bar instead:

omarchy plugin disable crueber.rpgdice

Settings are kept under ~/.local/state/omarchy/rpgdice/state.json, so reinstalling preserves your custom dice.

Usage

Click the d20 icon in the bar to open the panel.

  • Roll — click one or more dice buttons. The panel waits 1.5s after your last click, then rolls everything together. Results group identical dice: d6: 3, 4, 5, joined per type for mixed rolls.
  • Custom dice — expand Add custom die in Settings. Pick Numeric and enter a side count (1–1,000,000), or Explicit sides and enter comma-separated labels, then Add die. Custom dice appear as roll buttons in the Dice section.
  • Sound — toggle it and adjust volume in Settings.

Configuration

The bar icon is overridable via the widget's entry in ~/.config/omarchy/shell.json (the default is the d20 glyph, U+F1155):

{ "id": "crueber.rpgdice", "icon": "d20" }

Development

The shell hot-reloads on save, so changes under ~/.config/omarchy/plugins/crueber.rpgdice/ apply automatically. If a change fails to land, force a reload:

omarchy-shell shell rescanPlugins
omarchy restart shell

Layout:

File Purpose
manifest.json Plugin manifest (id, kinds, entry points, widget metadata)
BarWidget.qml Bar pill (d20 icon), panel lifecycle, and IPC
Panel.qml Popup panel: Settings/Dice/Results sections, roll debounce, sound, persistence
Model.js Pure dice logic and state (de)serialization — no QML imports
assets/dice-roll.wav Bundled roll sound

Where the logic lives:

  • Dice model — STANDARD_DICE and FATE_DIE in Model.js. Add a new built-in die by appending to STANDARD_DICE; the Dice grid picks it up automatically.
  • Rolling — Model.rollDie(die) returns { label, display, value }. Fate and explicit-sides dice are non-additive (value: null); only numeric dice contribute to the group total in Panel.qml:rollAll().
  • Debounce — Panel.qml's debounceTimer (1.5s) restarts on each queueDie() and rolls the accumulated pending list on timeout.
  • Persistence — state is JSON under ~/.local/state/omarchy/rpgdice/state.json, read with a size-bounded Process (symlink- and FIFO-safe) and written atomically via Util.execDetached.

Validate before publishing:

omarchy plugin validate ~/.config/omarchy/plugins/crueber.rpgdice

License

MIT