explaingit

brianblakely/omarchy-plugins

22QMLAudience · developerComplexity · 2/5Setup · moderate

TLDR

Five plugins for the Omarchy Linux desktop that add a mini-calendar clock, live stock ticker, secure scratch notes, rotating news headlines, and a floating-window fade toggle to the Omarchy status bar.

Mindmap

mindmap
  root((omarchy-plugins))
    Plugins
      Omacal calendar clock
      Omastonk stock ticker
      Omanote scratch notes
      Omanews headline ticker
      Peek window fade
    Features
      Vim-style keyboard nav
      Secure keychain storage
      Live market data
      Multi-instance support
    Tech Stack
      QML
      Omarchy bar
      Secret Service keychain
    Use Cases
      Productivity widgets
      Quick note taking
      Market data tracking
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Replace the default Omarchy clock with a calendar clock that lets you browse months and years using Vim-style keyboard shortcuts.

USE CASE 2

Track one or more stock symbols live in the status bar, with a chart panel per symbol showing switchable time intervals.

USE CASE 3

Store quick scratch notes securely in the desktop keychain without writing them to any file or sending them over the network.

USE CASE 4

Display rotating top news headlines in the bar that refresh every 10 minutes, with click navigation between stories.

Tech stack

QMLOmarchy

Getting it running

Difficulty · moderate Time to first run · 30min

Requires the Omarchy Linux desktop environment and its built-in plugin manager, not compatible with other desktop environments.

No license information is mentioned in this explanation.

In plain English

This repository is a collection of five plugins for Omarchy, a Linux desktop environment. The plugins add new widgets and features to the Omarchy bar, the status bar that sits at the edge of the screen. Each plugin is installed through Omarchy's built-in plugin manager using a consistent set of commands. Omacal replaces the default Omarchy clock with a version that includes a collapsible mini calendar. The calendar supports keyboard navigation, including Vim-style movement keys, for browsing months and years. Right-clicking the clock still allows changing the timezone, matching the behavior of the default clock it replaces. Omastonk is a stock ticker widget. After installation, you click the widget to enter a stock market symbol, and it displays live price data for that symbol in the bar. Clicking the widget again opens a chart panel with switchable time intervals. Multiple instances of Omastonk can each track a different symbol by storing the symbol inline in Omarchy's configuration file. Omanote adds a scratch note panel to the bar. Clicking the icon, or pressing a keyboard shortcut, opens a text area for quick notes. Note content is stored securely through the desktop's Secret Service keychain using secret-tool. The note is never stored in a plain file or in Omarchy's configuration, and the plugin does not make network requests. Omanews is a headline ticker that pulls top stories from Google News and displays them one at a time in the bar. Left-clicking advances to the next headline, right-clicking goes back, and middle-clicking opens an X search for the current headline. Headlines refresh every 10 minutes. Peek temporarily fades out floating windows so you can interact with content underneath them, toggled with a keyboard shortcut.

Copy-paste prompts

Prompt 1
I use the Omarchy Linux desktop. Show me the exact commands to install all five omarchy-plugins using the Omarchy plugin manager.
Prompt 2
How do I configure Omastonk to track two different stock symbols in separate widget instances in the Omarchy bar?
Prompt 3
I want to use Omanote to store a note securely. How does it use secret-tool and the Secret Service keychain, and how do I retrieve the stored note from the terminal?
Prompt 4
How do I install just the Peek plugin and bind the window-fade toggle to a custom keyboard shortcut in Omarchy?
Open on GitHub → Explain another repo

← brianblakely on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.