A minimal image viewer built with Quickshell, designed for screenshot workflows. Display images in always-on-top floating windows with zoom, drag, trackpad support, and drag-to-app functionality. Supports viewing multiple images simultaneously with automatic staggered positioning.

Note: Only supports wlr-based compositors.

• Quickshell - Required runtime
• For screenshot workflow (optional): grim, slurp

1. Start the viewer:

   qs -p shell.qml

2. Load images via IPC:

   qs -p shell.qml ipc call viewer load /absolute/path/to/image.png

   Important: Image paths must be absolute for drag functionality to work correctly.

3. Load multiple images by calling the load command multiple times:

   qs -p shell.qml ipc call viewer load /absolute/path/to/image1.png
   qs -p shell.qml ipc call viewer load /absolute/path/to/image2.png

1. Modify the screenshot.sh example script to update the QS_QML path:

   QS_QML="/path/to/qsview/shell.qml"

   The script uses grim and slurp to capture a screenshot, then displays it in qsview.

2. Set up with your window manager by binding the script to a key (e.g., Print/Screenshot key).

3. Ensure qsview is running in the background before taking screenshots.

• Scroll wheel / Pinch: Zoom in/out (0.1x - 5.0x)
• Drag: Move image around
• Click: Bring image to front
• X button: Close image
• Bottom handle: Drag image to other applications