omashot - GitLite

KO | EN

gitlite — search

#hacktoberfest #privacy #ai-agents #windows #machine-learning #anthropic #github #json #animation #http

omashot

(★ 9)

Screenshot and screen recording overlay for Omarchy

File Explorer

ZIP Download

- demo-screenshot.test.sh
- freeze-frame.test.sh
- keystrokes.test.sh
- measurement-mode.test.sh
- overlay-interaction.test.sh
- recording-destination.test.sh
- recording-escape.test.sh
- recording-marker-security.test.sh
- recording-reload.test.sh
- recording.test.sh
- shell-configuration.test.sh
KeystrokeOverlay.qml
LICENSE
manifest.json
omashot
omashot-subject
Overlay.qml
preview.png
preview2.png
preview3.png
preview4.png
preview5.png
README.md
SaveLocationPopup.qml
Service.qml

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Omashot is a screenshot and screen-recording overlay, inspired by macOS and Spectacle.

## Annotations and Editing

Omashot uses Omarchy's built-in tools, which do what they do best. To annotate a screenshot, first select `Save: Editor` from the toolbar. If you have a workflow that involves Pinta, GIMP, et al, you can set `editorCommand` in `~/.config/omarchy/shell.json`.

All completed screen recordings open automatically in Omacut.

![Omashot UI](https://raw.githubusercontent.com/brianblakely/omashot/master/preview.png)
![Video trimming](https://raw.githubusercontent.com/brianblakely/omashot/master/preview2.png)
![Screenshot annotation](https://raw.githubusercontent.com/brianblakely/omashot/master/preview3.png)
![Measure margins](https://raw.githubusercontent.com/brianblakely/omashot/master/preview4.png)
![Shrink to subject](https://raw.githubusercontent.com/brianblakely/omashot/master/preview5.png)

## Install

```bash
omarchy plugin add https://github.com/brianblakely/omashot.git
```

## Usage

### Use Your Mouse

* Click the top edge of the screen to capture the whole screen.
* Click a window to capture it.
* Click and drag to create a capture region. Then press `Enter`.

### Quick Capture Hotkeys

* Press `Space` to capture the whole screen at any time.
* Press `Enter` to capture a highlighted window or a region.
* Press `Escape` to end a screen recording. When Keystroke Display is enabled, hold `Escape` for two seconds.

### Choose a Save Folder

Open **Location → Custom folder…** in the toolbar, enter an absolute path (for example, `/home/alex/Captures`), and select **Save**. Omashot remembers the folder for both screenshots and screen recordings and creates it when needed. The Location menu also offers Pictures (Videos for recordings), Documents, and Downloads.

You can also set `saveLocation` in the `b.omashot` plugin entry in `~/.config/omarchy/shell.json`:

```json
{
  "id": "b.omashot",
  "saveLocation": "/home/alex/Captures"
}
```

Use the full path; `~` and environment variables are not expanded.

### Tweak Region Sizing and Position with the Keyboard

* Use the arrow keys or `HJKL` to move the region by one pixel.
* Hold `Shift` and a direction to grow the region.
* Hold `Shift+Ctrl` and a direction to shrink the region.
* Hold `Alt` while moving or resizing to use ten-pixel increments.

## Shortcuts

```lua
hl.unbind("PRINT")
o.bind("PRINT", "Omashot", "omarchy-shell b.omashot show")
```

## All Commands

* `omarchy-shell b.omashot show`
* `omarchy-shell b.omashot captureScreen`
* `omarchy-shell b.omashot captureWindow`
* `omarchy-shell b.omashot captureToFile`
* `omarchy-shell b.omashot captureToClipboard`
* `omarchy-shell b.omashot record`
* `omarchy-shell b.omashot stopRecording`
* `omarchy-shell b.omashot keystrokes true`
* `omarchy-shell b.omashot keystrokes false`

## Update

```bash
omarchy plugin update b.omashot
```

## Uninstall

```bash
omarchy plugin remove b.omashot
```