ScreenshotX

I'm new to Linux and came from a pretty Windows only background; I had dabbled in a few distros here and there but nothing full time. So when I made the full switch to Omarchy, which I LOVE and do not regret in the slightest, I realized there were a few programs I just couldn't find a linux app to replace; the main one being ShareX. I had almost given up when I started looking at the Omarchy plugins library...

So this plugin started as a fork of varo6/screenshot-tooling-omarchy, a small Omarchy bar-widget plugin that took region and full-screen captures and dropped them into a tidy Screenshots/YYYY-MM/ folder. It was already most of the way to what a Windows user coming from ShareX would expect, and the organizer idea in particular is one worth keeping exactly as varo6 built it.

It was just missing a few things: capturing a single window, capturing every monitor at once, and giving each capture mode its own hotkey instead of one shared shortcut. This fork adds those, folds the organizer on permanently since there was never really a reason to turn it off, and simplifies the panel down to four clearly labeled actions. Everything else — the clipboard-first behavior, the folder-per-month layout, the hardened file handling — is the same foundation varo6 built.

Every capture (region, window, full screen, or all monitors) is copied to the clipboard and saved to disk in one step. The organizer keeps captures sorted automatically:

<XDG Pictures>/Screenshots/YYYY-MM/

The default format is YYYY-MM, and it's configurable under Show settings. See ORGANIZER_FORMAT.md for the supported tokens, examples, and validation rules.

The format setting persists across shell restarts. "Open screenshots folder" always opens the base Screenshots directory. Existing files are never moved or deleted when you change the format.

Install

From Git repository:

omarchy plugin add https://github.com/dbgoodm/ScreenshotX --enable

Hotkeys

Under Show settings, each of the four capture actions — Region, Window, Full Screen, All Monitors — has its own "Set hotkey" control. Click Record, then press a modifier (Super, Ctrl, Alt, or Shift) plus a letter, digit, or F1-F12; the combination is saved immediately and takes effect without needing to reopen anything.

Hotkeys are synced into a single Screenshot Tooling-managed block in ~/.config/hypr/bindings.lua, with a one-time backup and atomic-write handling. Reassigning a hotkey to the same action replaces its old binding; clearing every hotkey removes the managed block entirely, leaving the rest of the file untouched.

Use

Click the camera icon. The panel opens on a "Capture Screenshot" header above a 2×2 grid — Region, Window, Full Screen, All Monitors — followed by Open screenshots folder and Show settings. The panel also supports the keyboard:

• Arrow keys move the selection, including across the 2×2 grid.
• Enter or Space runs the selected action.
• R captures a region, W captures a window, F captures the focused screen, A captures every monitor, and O opens the folder.
• Escape closes the panel (or cancels an in-progress hotkey recording).

Omarchy's fullscreen capture means the focused monitor. Region and window capture use Omarchy's standard frozen-screen picker. All-monitors capture stitches every output into one image. Every mode copies the result to the clipboard.

Validate

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml Panel.qml
tests/run

Remove

Before removing the plugin, clear every hotkey from the panel (or delete the -- Screenshot Tooling: capture hotkeys (start) … (end) block directly from ~/.config/hypr/bindings.lua), then remove the plugin:

omarchy plugin remove io.github.dbgoodm.screenshotx

The organizer format and hotkey preferences are harmless and may be kept for a later reinstall. To remove all of the plugin's state files after uninstalling:

rm -r -- "${XDG_STATE_HOME:-$HOME/.local/state}/screenshot-tooling"

The Future...

If you have used ShareX you know one of its main features is automatically uploading screenshots to an online source such as imgur. This has never really been super useful to me but to get parity with ShareX I will work on implementing it sometime in the future. Screen Recording will not be a part of this as Omarchy has a really good screenrecorder already, but I may look to add parity for a few other ShareX features. Let me know if you have anything in particular that you wish to have me add!

Credit

The organizer, the panel foundation, and the hardened file-handling this plugin builds on came from varo6/screenshot-tooling-omarchy. This fork adds window and all-monitors capture, per-action hotkeys, and an always-on organizer with a simplified panel — see LICENSE for the original MIT terms this fork is distributed under.