b44fb74780
* Keep screen-recording state out of world-writable /tmp * Compare the /tmp name across the run instead of requiring it absent Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * Fall back to the state directory when there is no runtime dir * Let the /tmp snapshot come back empty Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * Resolve the region file the same way in the resizer Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * Protect recording fallback state and document its path --------- Co-authored-by: Omabot <omabot@omarchy.org> Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2.3 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 $XDG_RUNTIME_DIR/omarchy-screenrecord.log (or ${XDG_STATE_HOME:-$HOME/.local/state}/omarchy/omarchy-screenrecord.log without a session runtime directory) 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