Skip to content

docs: per-compositor Quick Preview keybind recipes - #7

Merged
green2grey merged 1 commit into
mainfrom
docs/keybind-recipes
Jul 6, 2026
Merged

docs: per-compositor Quick Preview keybind recipes#7
green2grey merged 1 commit into
mainfrom
docs/keybind-recipes

Conversation

@green2grey

Copy link
Copy Markdown
Member

Extends templates/keybind-examples.md with concrete niri / Hyprland / Sway snippets (Phase 6, last item). Uses the newest-screenshot recipe since compositors don't know the file-manager selection (existing caveat C). Documents the single-instance toggle (one bind suffices, PR #5) and the layer-rule (namespace quickview) vs window-rule (app ID, fallback path only) distinction.

niri snippet validated with niri validate against niri 26.04. Docs-only change.

niri, Hyprland, and Sway snippets using the newest-screenshot recipe
(compositors don't know the file-manager selection; see caveat C).
Documents the toggle behavior (one bind opens and closes, PR #5) and the
layer-rule-vs-window-rule matching distinction: layer rules match the
namespace 'quickview', window rules match the app ID and only apply on
the no-layer-shell fallback path. niri snippet validated with
'niri validate'.
@green2grey
green2grey merged commit 60e26bc into main Jul 6, 2026
@green2grey
green2grey deleted the docs/keybind-recipes branch July 6, 2026 07:23
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 48422000-bf85-4501-b7a4-cdb15ff7eb85

📥 Commits

Reviewing files that changed from the base of the PR and between ed2bd28 and c304e41.

📒 Files selected for processing (1)
  • templates/keybind-examples.md

Disabled knowledge base sources:

  • Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.


Summary by CodeRabbit

  • Documentation
    • Added a new advanced compositor keybind guide for previewing the latest screenshot.
    • Clarified how the preview behaves as a single-instance toggle.
    • Included a quick reference for matching compositor layer surfaces versus app windows.
    • Added example keybind setups for niri, Hyprland, and Sway, along with optional styling and fallback rules.

Walkthrough

Adds a new "Compositor keybind (advanced)" documentation section to templates/keybind-examples.md, describing QuickView's single-instance toggle behavior, a rule-matching cheat sheet, and compositor-specific keybind examples for niri, Hyprland, and Sway.

Changes

Keybind documentation update

Layer / File(s) Summary
Advanced workflow guidance and cheat sheet
templates/keybind-examples.md
Explains newest-screenshot glob selection, QuickView single-instance toggle behavior, and a cheat sheet contrasting layer-surface namespace matching vs app-id window matching.
Compositor-specific keybind examples
templates/keybind-examples.md
Adds example keybind config blocks for niri, Hyprland, and Sway that invoke quickview --quick-preview on the newest screenshot, with optional styling/fallback rules per compositor.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Poem

A rabbit hops with docs in paw,
New keybinds shown for all to draw,
niri, Hyprl, Sway in line,
QuickView toggles, oh so fine! 🐇
Thump-thump, the markdown's clear and bright!

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/keybind-recipes

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c304e41e13

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +66 to +69
layerrule = blur, quickview

# Fallback path only (no layer shell): keep the borderless window floating.
windowrulev2 = float, class:^(io\.github\.Green2Grey2\.QuickView)$

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the Hyprland rule examples to current syntax

For current Hyprland users on Arch, these rule examples use the old rule grammar: the Hyprland 0.54 Window Rules docs show layer rules as layerrule = blur on, match:namespace waybar and window matches as match:class, while this snippet uses layerrule = blur, quickview and windowrulev2 ... class:. Users copying the recipe on Hyprland 0.53/0.54+ will get config errors or rules that do not apply, so the example should either use the new match:namespace / match:class form or be explicitly labeled for old Hyprland versions.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant