Files
omarchycn/default/agents/skills/omarchy/capture.md
T
6ee243cc37 Split the end-user omarchy skill into topic guides (#6602)
* Split the end-user omarchy skill into topic guides

Move default/omarchy-skill to default/agents/skills/omarchy and break the
monolithic SKILL.md into on-demand topic files for Hyprland config, shell
plugins, theming, and hooks. Update the skill symlink wiring, relink
existing installs through a migration, and correct claims that had drifted
from the implementation: plugin hot-reload, terminal reload, menu
customization, refresh scopes, theme overlays, background locations, hook
timing, and the packaged (not git-managed) system directory.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Add capture and contributing guides to the omarchy skill

Cover screenshots, screen recording, OCR text capture, and LocalSend or
Taildrop sharing, plus how to route bug reports, suggestions, and support
questions upstream with diagnostics and captures of the problem attached.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Scope Hyprland reload guidance to the Lua config files

hyprsunset.conf and xdph.conf are read by separate processes, so hyprctl
neither applies nor validates them. Document restarting hyprsunset after
editing its config, including in the night light example.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 14:36:42 +02:00

2.2 KiB

Capture and Sharing

Read this before taking screenshots or screen recordings, extracting text from the screen, or sharing files with other machines.

Screenshots

omarchy screenshot                            # Interactive smart-region flow
omarchy capture screenshot region             # Select a region
omarchy capture screenshot windows            # Pick a window
omarchy capture screenshot fullscreen save    # Full screen, straight to disk (no editor)

The first argument picks the mode (smart|region|windows|fullscreen), the second what happens with it (slurp|copy|save). save skips the annotation editor and prints the saved path. Screenshots land in the configured Pictures directory (override with OMARCHY_SCREENSHOT_DIR).

Screen Recording

omarchy screenrecord --fullscreen             # Start recording the full screen
# ...exercise whatever you want on film...
omarchy screenrecord --stop-recording         # Stop; prints the saved path

Optional flags: --with-desktop-audio, --with-microphone-audio, --with-webcam (plus --webcam-device= and --webcam-size=), and --resolution=<size>. Without --fullscreen a region picker opens first. Recordings land in the configured Videos directory (override with OMARCHY_SCREENRECORD_DIR). Resize a live webcam overlay with omarchy capture webcam resize <smaller|larger|reset|small|medium|large>.

If recording fails to start, rerun with OMARCHY_SCREENRECORD_DEBUG=true to collect a log at /tmp/omarchy-screenrecord.log worth attaching to a bug report.

Text Capture (OCR)

omarchy capture text    # Select a region; extracted text goes to the clipboard

Sharing Files

omarchy share clipboard               # Share the clipboard via LocalSend
omarchy share file <path...>          # Share files with nearby devices
omarchy share folder <path>           # Share a folder

omarchy tailscale send <machine> <file...>    # Taildrop to a tailnet machine
omarchy tailscale receive [directory]         # Save incoming Taildrop files

Shrink large captures before sharing them:

omarchy transcode <input> [format] [resolution]   # Re-encode pictures/videos for sharing