Omahub
← All plugins
P

OmaMoney

by promaaa

Live multi-currency & FX exchange rate widget for the Omarchy status bar. Features live EUR ⇄ KRW rates with an interactive converter panel, Korean numeral units (man/eok), and quick student & living expense presets.

GitHub

Security review

Review recommended · 2 findings

Deterministic scan — not a security guarantee

Medium
Risk level
Medium
Analyzed commit
c991f6c
Scanned
1 month ago
  • medium external_hosts get-rates.sh:14

    Downloads or connects to an external HTTP(S) host.

    curl -fsS --max-time 4 "https://open.er-api.com/v6/latest/EUR" 2>/dev/null) || true
  • medium external_hosts get-rates.sh:18

    Downloads or connects to an external HTTP(S) host.

    curl -fsS --max-time 4 "https://api.frankfurter.dev/v1/latest?base=EUR" 2>/dev/null) || true

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
c991f6c
Reviewed
1 month ago

The plugin is a straightforward currency converter widget that fetches live exchange rates from public APIs (open.er-api.com and frankfurter.dev) with timeouts and local caching. The only flagged items are the expected external network calls for its core functionality; there is no obfuscation, credential theft, destructive behavior, or hidden persistence.

  • The plugin makes outbound HTTPS requests to two public currency APIs; this is inherent to its purpose and uses timeouts and fallbacks.
  • The save-config.py writes to ~/.config/omarchy/omamoney.json, which is the documented configuration file and is user-controlled.
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/promaaa/omamoney --enable
Productivity #bar

OmaMoney

A live multi-currency exchange rate status bar widget and currency converter for Omarchy.

GitHub stars License

OmaMoney global desktop preview

Overview

OmaMoney brings real-time currency conversion directly to the Omarchy status bar. Designed for expats, international developers, and students, it provides instant live exchange rates, bidirectional conversions, and customizable expense presets while staying ultra-lightweight and integrated with your active theme.

Gallery

View Preview
Global Desktop Global Desktop View
Converter Panel Close-up Menu View

Features

  • Live Status Bar Pill: Compact display on the Omarchy status bar showing real-time rates (e.g. 1 EUR = 1,635 KRW or 1 USD = 159 JPY).
  • Interactive Quickshell Panel: Fast bidirectional currency calculator with instant typing calculation.
  • Customizable Currencies: Track any pair of world currencies (EUR, KRW, USD, JPY, GBP, CHF, CAD, AUD, and 160+ more).
  • Custom Expense Presets: Define typical daily and monthly living expenses with custom amounts and icons.
  • Korean Numeral Units: Built-in support for Korean denomination units (만 / 억).
  • Theme-Adaptive Design: Native Quickshell vector styling that automatically harmonizes with your active Omarchy theme.
  • Offline Durability: Hourly local caching ensures instant startup and full offline reliability.

Installation

Install OmaMoney directly using the Omarchy plugin manager:

omarchy plugin add https://github.com/promaaa/omamoney.git --enable

OR

  1. Open the Omarchy menu (Super + Alt + Space).
  2. Go to Install > Plugins.
  3. Paste this repo URL: https://github.com/promaaa/omamoney.git
  4. Hit Enter.

Configuration

OmaMoney automatically watches ~/.config/omarchy/omamoney.json. Any changes saved to this file hot-reload immediately without restarting the shell.

{
  "baseCurrency": "EUR",
  "targetCurrency": "KRW",
  "presets": [
    { "icon": "󰅶", "name": "Coffee / Americano", "amount": 3500, "isBase": false },
    { "icon": "󰛲", "name": "Lunch / Cafeteria", "amount": 6500, "isBase": false },
    { "icon": "󰄲", "name": "Subway / Transit", "amount": 1500, "isBase": false },
    { "icon": "󰋜", "name": "Studio Rent", "amount": 600000, "isBase": false },
    { "icon": "󰉋", "name": "Monthly Budget", "amount": 1000, "isBase": true }
  ],
  "majorCurrencies": [
    "USD",
    "JPY",
    "GBP",
    "CHF",
    "CAD",
    "AUD"
  ]
}

Controls

Action Result
Left Click Open/close the interactive currency converter panel
Middle Click Force an immediate live exchange rate refresh
Right Click Cycle between bar display modes

Keybinding / CLI

Summon the converter panel from the terminal or bind it to a Hyprland shortcut:

omarchy-shell shell toggle io.github.promaaa.omamoney

Contributing

Contributions, bug reports, feature requests, and suggestions are welcome. Feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.