omarchy

Source excerpt starting at line 1.

1# Capture and Sharing2 3Read this before taking screenshots or screen recordings, extracting text from4the screen, or sharing files with other machines.5 6## Screenshots7 8```bash9omarchy screenshot                            # Interactive smart-region flow10omarchy capture screenshot region             # Select a region11omarchy capture screenshot windows            # Pick a window12omarchy capture screenshot fullscreen save    # Full screen, straight to disk (no editor)13```14 15The first argument picks the mode (`smart|region|windows|fullscreen`), the16second what happens with it (`slurp|copy|save`). `save` skips the annotation17editor and prints the saved path. Screenshots land in the configured Pictures18directory (override with `OMARCHY_SCREENSHOT_DIR`).19 20## Screen Recording21 22```bash23omarchy screenrecord --fullscreen             # Start recording the full screen24# ...exercise whatever you want on film...25omarchy screenrecord --stop-recording         # Stop; prints the saved path26```27 28Optional flags: `--with-desktop-audio`, `--with-microphone-audio`,29`--with-webcam` (plus `--webcam-device=` and `--webcam-size=`), and30`--resolution=<size>`. Without `--fullscreen` a region picker opens first.31Recordings land in the configured Videos directory (override with32`OMARCHY_SCREENRECORD_DIR`). Resize a live webcam overlay with33`omarchy capture webcam resize <smaller|larger|reset|small|medium|large>`.34 35If recording fails to start, rerun with `OMARCHY_SCREENRECORD_DEBUG=true` to36collect a log at `/tmp/omarchy-screenrecord.log` worth attaching to a bug37report.38 39## Text Capture (OCR)40 41```bash42omarchy capture text    # Select a region; extracted text goes to the clipboard43```44 45## Sharing Files46 47```bash48omarchy share clipboard               # Share the clipboard via LocalSend49omarchy share file <path...>          # Share files with nearby devices50omarchy share folder <path>           # Share a folder51 52omarchy tailscale send <machine> <file...>    # Taildrop to a tailnet machine53omarchy tailscale receive [directory]         # Save incoming Taildrop files54```55 56Shrink large captures before sharing them:57 58```bash59omarchy transcode <input> [format] [resolution]   # Re-encode pictures/videos for sharing60```61