6ee243cc37
* 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>
61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# Capture and Sharing
|
|
|
|
Read this before taking screenshots or screen recordings, extracting text from
|
|
the screen, or sharing files with other machines.
|
|
|
|
## Screenshots
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
omarchy capture text # Select a region; extracted text goes to the clipboard
|
|
```
|
|
|
|
## Sharing Files
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
omarchy transcode <input> [format] [resolution] # Re-encode pictures/videos for sharing
|
|
```
|