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