Skip to main content
otter-shot frames window screenshots with a gradient background, drop shadow, rounded corners, padding, and optional synthetic window chrome. Capture a live window, a hand-drawn region, or your entire desktop. Export as PNG through the portal save picker or to the clipboard.

​
Launching

Run otter-shot from the app launcher or a terminal. The composer window opens immediately. No arguments required. 
otter-shot
otter-shot ships a .desktop file so it appears in the app launcher. Bind it to a compositor shortcut if you use it often.
otter-shot appears in your application launcher through its installed .desktop entry. No manual PATH setup needed.

​
Capture Sources

Four ways to bring content into the composer.

Focused Window

Captures the currently focused window when you click the source button. No selection step.

Selected Window

Opens a live list of all toplevels reported by the compositor. Click a row to capture that window.

All Screens

Captures the full desktop across every connected output in one frame.

Dragged Selection

Same drag-to-select UI as otter-screenshot and otter-rec. Drag to define a rectangular region.
If your compositor exposes ext_foreign_toplevel_list_v1 metadata but not the full capture protocol, the window list still appears in the inspector. Those rows are marked metadata-only instead of failing silently when you try to capture them.

​
Composer Controls

After capture, the right-hand inspector panel controls the framing. Scroll the inspector if the controls exceed the visible height.
  • Source re-captures using any of the four source modes without closing the composer.
  • Background picks a predefined gradient, a wallpaper image through the xdg-desktop-portal file picker, or the current otter-wallpaper state on your desktop. Click the wallpaper field to open the portal picker.
  • Frame adjusts padding around the captured content, corner radius, drop shadow intensity and offset, and border color.
  • Options toggles synthetic window chrome to add a mock title bar or control buttons.
  • Size sets the output canvas dimensions. Controls update the preview in real time.
  • Export saves to a file or copies to clipboard (see Exporting below).

​
Exporting

Two export paths once the composition looks right.
1

Export PNG to file

Click Export PNG in the inspector. The xdg-desktop-portal save picker opens so you can choose a filename and destination directory. otter-shot writes the framed PNG only after you confirm the picker.
2

Copy to clipboard

Click Clipboard to copy the framed PNG as image/png. Paste it into any application that accepts image data.

​
Compositor Requirements

otter-shot requires the ext_image_copy_capture_v1 protocol for all capture operations. Screen and dragged-selection capture also require output capture source support from the compositor. Window capture requires both ext_image_copy_capture_v1 and ext_foreign_toplevel_list_v1. If your compositor does not expose these protocols, the affected capture sources will be unavailable.