capture

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