DMS-ScreenCapture_Toolbar

August 20, 2026 · View on GitHub

DMS-ScreenCapture_Toolbar

Premium Screen Capture Management

A high-end, glassmorphic floating pill toolbar for the Dank Material Shell. Seamlessly switch between photo and video modes with tactile animations and dynamic, mode-aware controls.

Download

Requires Dank Material Shell (DMS) 1.0 or higher.

Requirements

To ensure all features work correctly, the following dependencies are recommended:

View System Dependencies

Dank Material Shell (DMS) 1.0 or higher.
slurp: Required for Interactive Mode region selection.
grim: Required for screen capturing.
gpu-screen-recorder: Required for high-performance video recording.
ffmpeg: Required for standalone audio recording and encoding.
pipewire: Required for PipeWire audio capture and interactive microphone testing (pw-record/pw-play).
pulseaudio-utils: Required for audio source resolution (pactl).
jq: Required for automatic monitor detection in video mode (parses compositor JSON output).

# Debian/Ubuntu
sudo apt install slurp grim gpu-screen-recorder ffmpeg pipewire pulseaudio-utils jq

# Fedora
sudo dnf install slurp grim gpu-screen-recorder ffmpeg pipewire pulseaudio-utils jq

# Arch Linux
sudo pacman -S slurp grim gpu-screen-recorder ffmpeg pipewire libpulse jq

Keyboard Shortcuts

View Keyboard Shortcuts

The toolbar supports the following keyboard interactions when open:

Space: Trigger capture or start/stop recording (configurable behavior).
Ctrl + Space: Secondary capture mode (typically "Edit Mode", can be swapped or disabled in settings).
Escape: Dismiss the toolbar.

If the editor pipe command is empty, the toolbar uses:

{ mkdir -p "$HOME/Pictures/Screenshots"; satty --filename - --output-filename "$HOME/Pictures/Screenshots/screenshot_$(date '+%Y-%m-%d_%H-%M-%S')_edit.png"; }

If satty is not installed, a notification is shown so you can install it or set a custom editor pipe command such as swappy -f -.

You can customize the power-user workflow in the settings:

Swap Shortcuts: Exchange the functionality of Space and Ctrl + Space.
Disable Editor Shortcut: Completely remove the Ctrl + Space interaction and UI hint.

Controller Shortcuts

View Controller Shortcuts

The toolbar fully supports native gamepad and controller interactions without third-party mapping software:

D-Pad Up / Left Stick Up: Open the Monitor Selection Popup.
D-Pad Right / Left Stick Right: Open the Capture Delay Popup.
D-Pad Down / Left Stick Down: Open Settings/Options Popup.
D-Pad (All) / Left Stick (All): Navigate focus across buttons, toggles, and dropdowns.
LT / RT: Switch between Capture Modes (Photo / Video).
LB / RB: Switch between Capture Types (Interactive / Monitor / All).
A Button: Trigger capture, start/stop recording, or toggle the focused option.
B Button: Dismiss the toolbar or close the currently active popup.
Home / Guide: Stop an active screen recording (usable while the toolbar is hidden).

Features

Premium Glassmorphism: Translucent, theme-aware "Floating Pill" design with configurable toolbar and recording pill opacity.
Multi-Monitor Recording Pill: "Click-to-Move" logic with screen-aware positioning, allowing you to move the recording pill across connected displays.
Adaptive Theme Support: Intelligent UI that dynamically flips icon and text colors between black and white based on your theme brightness for guaranteed visibility.
Smart Recording Pill: A collapsible, high-frequency overlay that displays live recording duration and provides instant access to stop, pause, and screenshot actions.
Tactile Interaction: Features playful 360° spins, tilt-and-jump micro-animations, and responsive Dank Ripples on every interactive element.
Dynamic Settings: A context-aware popup bubble that automatically filters capture settings (FPS, Audio, Formats) based on your active mode (Photo vs. Video).
Flexible Recording Audio: Record system output audio and microphone input independently.
Standalone Audio Recorder: Optional audio recording capability supporting MP3, Opus, FLAC, WAV, AAC (M4A), and OGG formats with customizable quality presets.
Separate Output Settings: Screenshots, video recordings, and audio recordings can use independent custom directories and filenames.
Versatile Capture: Native support for interactive region selection, active monitor focus, full-workspace grabbing, and optional slurp + grim multi-monitor screenshots.
Configurable Capture Delay: For non-interactive screenshot modes, a Timer icon allows choosing 3s, 5s, or 10s delays for capture.
Power Workflow: Lightning-fast controls with Spacebar to trigger captures, Ctrl+Space to send a screenshot to the editor, and Escape for instant dismissal.
Controller Support : Navigate, configure, and capture entirely via gamepads and controllers using native IPC events and zero external mapping software.

DMS Shortcut Setup

To open the toolbar from a keyboard shortcut, add an entry in DMS Settings -> Keyboard Shortcuts:

Type: Run a program
Action: dms ipc call screenCaptureToolbar toggle

Interactive screenshot capture can optionally use slurp and grim for region selection across displays. Enable Multi-Monitor Screenshots in settings to use this path. When disabled, screenshots keep using the standard dms screenshot behavior.