* 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>
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