Screen Recorder YS for DankMaterialShell

August 13, 2026 · View on GitHub

A lightweight Wayland screen-recording widget for DankMaterialShell powered by GPU Screen Recorder.

Screen Recorder popout

Demo

Watch or download the demo recording.

The demo was recorded with this plugin itself at 2560×1440, 60 FPS maximum, Very High quality, H.264, VFR, and mixed audio. It was remuxed to MP4 for convenient GitHub playback.

Features

  • Select one monitor from a multi-monitor setup
  • Automatic native-resolution detection
  • Efficient variable frame rate (VFR) recording
  • Maximum FPS presets from 15 to 120
  • Medium, High, Very High, and Ultra quality presets
  • Native, 1080p, and 720p output
  • H.264, HEVC, AV1, and VP9 when supported by the active GPU
  • MKV and MP4 containers
  • Optional cursor capture
  • Independent system-audio and microphone toggles
  • System audio and microphone mixed into one audio track when both are enabled
  • Optional 3- or 5-second countdown
  • DankBar recording indicator, elapsed timer, and direct stop action

Requirements

  • DankMaterialShell 1.2 or newer
  • Wayland
  • gpu-screen-recorder 5.10 or newer on PATH
  • PipeWire/PulseAudio for audio recording

Installing gpu-screen-recorder

The recording backend is GPU Screen Recorder. Install it for your distribution:

Arch Linux / CachyOS / EndeavourOS (official repositories):

sudo pacman -S gpu-screen-recorder

Fedora (community COPR):

sudo dnf copr enable brycensranch/gpu-screen-recorder-git
sudo dnf install gpu-screen-recorder

Ubuntu / Debian (community package):

sudo apt install gpu-screen-recorder-cli

NixOS (nixpkgs):

{ config, pkgs, ... }: {
  programs.gpu-screen-recorder.enable = true;
  environment.systemPackages = with pkgs; [ gpu-screen-recorder ];
}

openSUSE: install gpu-screen-recorder from the openSUSE software repository.

Other distributions — Flatpak (official):

flatpak install --system flathub com.dec05eba.gpu_screen_recorder

or build from source:

git clone https://git.dec05eba.com/gpu-screen-recorder
cd gpu-screen-recorder
sudo ./install.sh

The plugin runs gpu-screen-recorder from PATH. If you installed the Flatpak, create a wrapper so the CLI is reachable:

printf '#!/bin/sh\nexec flatpak run --command=gpu-screen-recorder com.dec05eba.gpu_screen_recorder "$@"\n' > ~/.local/bin/gpu-screen-recorder && chmod +x ~/.local/bin/gpu-screen-recorder

Installation

mkdir -p ~/.config/DankMaterialShell/plugins
cd ~/.config/DankMaterialShell/plugins
git clone https://github.com/smithyyang/dms-screen-recorder.git screenRecorderYS
dms restart

Then enable Screen Recorder YS from DMS Settings → Plugins and add it to DankBar.

Usage

  1. Enable Screen Recorder YS in DMS Settings → Plugins.
  2. Add the widget to DankBar.
  3. Click the video-camera icon.
  4. Select a monitor and start recording.
  5. Click the REC pill or the popout Stop button to finalize the file.

Recordings are saved to ~/Videos/ScreenRecordings by default.

Frame Rate

The FPS setting is a maximum FPS. VFR stores fewer frames when the screen is static, reducing file size and encoder load without changing playback speed.

Audio

The system-audio and microphone switches are independent:

  • both off: no audio
  • system only: desktop/output audio
  • microphone only: microphone audio
  • both on: mixed into one audio track

Notes

  • MKV is recommended because it is more resilient if recording is interrupted.
  • V1 records one monitor at a time.
  • Strict constant-frame-rate output, region capture, pause, and replay buffer are not included in V1.

License

MIT — see LICENSE.