Skip to content

Repository files navigation

Toolbar Logo

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.

DMS Compatible License Maintenance Status

Download

DMS Plugin Gallery

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.
  • gpu-screen-recorder: Required for high-performance video recording.
  • jq: Required for automatic monitor detection in video mode (parses compositor JSON output).
# Debian/Ubuntu
sudo apt install slurp gpu-screen-recorder jq
# Fedora
sudo dnf install slurp gpu-screen-recorder 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 BETA

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.
  • Separate Output Settings: Screenshots and 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 BETA: 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

Multi-Monitor Screenshots

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.

Interface

Screen Recording UI Screenshot UI

Recording Pill Collapsed Recording Pill Expanded

Configuration

Settings

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Before reporting a new issue, take a look at the FAQ, the changelog and the already opened issues.

Credits

Built with ❤️ for the Dank Material Shell community.

Screen Capture Toolbar contributors

Disclaimer

This application is an independent utility for Dank Material Shell.

📜 License

Part of DankMaterialShell. Check the main repository for license information.

About

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.

Resources

Stars

Watchers

Forks

Contributors

Languages