Omahub
← All plugins
B

Omaga Sync

by bisma

MEGA two-way sync status and control in the Omarchy bar, powered by the MEGAcmd engine.

GitHub

Security review

Potentially dangerous behavior detected · 4 findings

Deterministic scan — not a security guarantee

High
Risk level
High
Analyzed commit
17e3d70
Scanned
14 hours ago

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
17e3d70
Reviewed
14 hours ago

The plugin is a transparent MEGA sync status/control widget. The deterministic scan's high risk comes from bundling systemd units and a README git clone, but the units are user-level and match the documented daemon architecture, and the README snippet is documentation only. The installer and scripts are straightforward, use argument-list execution rather than shell interpolation, and contain no obfuscation, credential theft, or destructive behavior.

  • The installer enables persistent user systemd services and kills any existing mega-cmd-server process, which may briefly disrupt an existing MEGAcmd session.
  • The login helper bridges terminal input to mega-cmd over a pty and handles password/2FA input, but it does not store or exfiltrate credentials.
  • The systemd units are flagged as persistence, but they are user-level and only run the expected MEGAcmd engine and status monitor.
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/bismawy/omaga-sync --enable
Productivity #bar #quickshell #system

⚡ Omaga Sync

Lightweight MEGA two-way sync bar widget, monitor daemon, and GNOME Files / Nautilus emblem integrator for Omarchy (Quickshell / Wayland / Hyprland).

Powered directly by the headless mega-cmd-server engine—designed as a reliable, glitch-free Wayland alternative to the official MEGAsync desktop app.

Platform: Omarchy Engine: MEGAcmd License: MIT Version: 1.1.2

English | Bahasa Indonesia

<p align="center"> <img src="preview.webp" alt="Omaga Sync Preview" width="720" /> </p>

⚡ Architecture

mega-cmd-server ── systemd (omaga-sync-engine.service)     Headless MEGAcmd sync daemon
      │ Local UNIX socket
omaga-sync monitor ── systemd (omaga-sync-monitor.service) 5s poll → status.json (bounded reader)
      ├── GNOME Files / Nautilus Integrator                └─ In-process Gio metadata::emblems
      └── Desktop Notification Dispatcher                  └─ notify-send on errors/issues
Bar Widget (bisma.omaga-sync) ── Quickshell QML Panel      ├─ Storage quota, transfer progress
                                                           ├─ Pause / Resume / Add / Remove pairs
                                                           └─ Interactive cloud folder picker & creator

🚀 Key Features

  • 📊 Dynamic Status Bar Indicator:
    • Real-time synced status icon, smooth pulse animation while actively transferring, dimmed icon when paused, and high-visibility alert state during sync issues or offline engine.
  • 📂 Rich Interactive Panel:
    • Account storage quota progress bar (used vs. total quota).
    • List of local ↔ remote folder pairs with individual sync status.
    • Global & per-folder Pause / Resume controls.
    • Remove Sync button (safe; files on both local and cloud stay intact).
    • Interactive Remote Folder Picker & Creator: browse and select existing remote MEGA folders or create new cloud directories straight from the UI.
    • Integrated session management with Logout and terminal-assisted Login onboarding.
  • 🏷️ Nautilus / GNOME Files Sync Emblems:
    • Corner status badges on synced folders and files via metadata::emblems (emblem-omaga-synced, emblem-omaga-syncing, emblem-omaga-error, and emblem-omaga-transfer).
    • High-performance in-process Gio integration with diffed writes, rate-budget chunking, and automatic cleanup on monitor stop/uninstall.
  • 🌐 Bilingual Internationalization (i18n):
    • Full English (en) and Bahasa Indonesia (id) support with automatic system locale detection or configurable widget preference.
  • 🔔 Actionable & Spam-Free Notifications:
    • Sent only when user intervention is required (login expired, engine offline, or sync issue encountered).
  • 🛡️ Systemd Supervision & Auto-Healing:
    • Supervises mega-cmd-server under systemd user session with automatic startup repair for unmanaged instances.

📦 Installation & Setup

1. Prerequisite: Install MEGAcmd

omarchy pkg aur add megacmd

2. Install Plugin & Services

Clone the repository and run the installer:

git clone https://github.com/bismawy/omaga-sync.git
cd omaga-sync
./install.sh

3. Log in to MEGA (One-time)

mega-login your-email@example.com

(Or click the Login button directly from the Omaga Sync bar panel to open the interactive login helper).

🛠️ CLI Commands (omaga-sync)

The omaga-sync utility can be executed directly from terminal or custom scripts:

Command Description
omaga-sync status Print current bounded status JSON from the monitor daemon
omaga-sync pause [folder] Pause syncing for a specific folder or all active pairs
omaga-sync resume [folder] Resume syncing for a specific folder or all active pairs
omaga-sync add <mega-folder> [base] Pair remote MEGA folder to a local directory (default ~/MEGA)
omaga-sync remove <local-folder> Remove sync pair safely (keeps files intact on disk & cloud)
omaga-sync logout Log out of active MEGA session
omaga-sync login [email] Launch interactive terminal login helper
omaga-sync open <folder> Open local folder in default file manager (xdg-open)
omaga-sync repair Terminate unmanaged server instances and restart via systemd

🔧 Development & Hot Reload

To reload QML / JS changes without restarting daemon services:

./install.sh --plugin-only

Validate plugin:

omarchy plugin validate ~/.config/omarchy/plugins/bisma.omaga-sync

📜 License

Distributed under the MIT License © 2026 Bisma.