Repolode
Submit
wesleygrimes

wesleygrimes/omafire

A tiny animated pixel campfire that lives in the Omarchy Quickshell bar, opening into a popup where you add logs and stoke the fire.

View on GitHub
Stars
18
Forks
7
Open issues
0
Last commit
6 days ago

What is it?

OmaFire is a Quickshell plugin for Omarchy, the Hyprland-based Linux setup. A flame icon sits in the right side of the bar; clicking it opens a popup with a pixel-art campsite where you add logs, stoke the fire, and poke the coals. The fire burns down over time and keeps burning while the popup is closed, so it works as a passive visual indicator of whether it needs fuel.

The fire is written in plain QML and JavaScript and is ported from an earlier browser prototype, drawing into a small pixel buffer scaled up without smoothing. An optional sound mode plays fire crackle that changes with the fire's intensity, plus crickets and frog calls. Sound requires qt6-multimedia; everything else works without it.

The plugin is installed with the omarchy plugin command, can be bound to a keyboard shortcut through the shell IPC target, and stores its state locally in a JSON file under the user's state directory. It makes no network requests.

Key features

  • 01Click the bar flame to open a pixel campsite popup.
  • 02Add logs by button or drag, each adding about three minutes of fire.
  • 03Stoke the fire for a temporary flare-up and poke the coals for sparks.
  • 04Fire crackle, crickets and frog calls that follow the fire's intensity.
  • 05Keyboard shortcuts and shell IPC commands for toggling and status.

Use cases

  • Keeping a lightweight ambient visual in an Omarchy status bar.
  • Glancing at the bar icon to see whether the fire needs fuel.
  • Adding a decorative, low-distraction element to a Hyprland desktop.

Quick start

  1. 1

    Install and enable the plugin with the Omarchy CLI

    omarchy plugin add https://github.com/wesleygrimes/omafire --enable
  2. 2

    Click the flame in the bar to open the campsite, then click + Add log

Things to know

  • Requires Omarchy 4.0 or newer with the Quickshell bar.
  • Sound playback needs the optional qt6-multimedia package.

Topics

#quickshell#hyprland#omarchy#qml#pixel-art#desktop-widget#linux#campfire#omarchy-plugin

FAQ

What is omafire?
A tiny animated pixel campfire that lives in the Omarchy Quickshell bar, opening into a popup where you add logs and stoke the fire. OmaFire is a Quickshell plugin for Omarchy, the Hyprland-based Linux setup. A flame icon sits in the right side of the bar; clicking it opens a popup with a pixel-art campsite where you add logs, stoke the fire, and poke the coals. The fire burns down over time and keeps burning while the popup is closed, so it works as a passive visual indicator of whether it needs fuel.
Is omafire free to use? What license does it have?
omafire is open source under the MIT license. Check the license terms before using it in commercial products.
Is omafire still maintained?
Actively maintained. The last commit to omafire was on Nov 1, 2026.
What can I use omafire for?
Keeping a lightweight ambient visual in an Omarchy status bar. Glancing at the bar icon to see whether the fire needs fuel. Adding a decorative, low-distraction element to a Hyprland desktop.
How do I install omafire?
Install and enable the plugin with the Omarchy CLI: omarchy plugin add https://github.com/wesleygrimes/omafire --enable Click the flame in the bar to open the campsite, then click + Add log
Where can I get omafire?
The source code and installation instructions are on GitHub: https://github.com/wesleygrimes/omafire

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects