dm-scripts/dm-recording/README.md

17 lines
1.1 KiB
Markdown

# dm-recording
dm-recording is a dmenu controlled utility that manages screen recordings using `ffmpeg`s `x11grab` mode.
## What it does
You can either select Fullscreen or Region mode. Fullscreen mode records the entire default X display, Region mode lets the user click on a window or drag a region to be recorded. A notification brief (900ms) notification is displayed after which (100ms later) the recording is started. Unless in fullscreen mode, a frame is drawn around the recorded region.
## Usage
Run `dm-recording`. Everything else is managed and communicated by `dmenu` and `notify-send`.
Please click the following sample image to see a sample video.
![Click me](https://gitea.leafbla.de/dominic/dm-scripts/raw/branch/master/dm-recording/.media/example.png)
In order to stop the recording, kill the corresponding process. While not the prettiest solution, `killall ffmpeg` works for non-nested recordings.
## Requirements
You need to have `dmenu`, `ffmpeg` and `libxcb` (for ffmpeg) installed in order to run dm-recording. It is recommended to have a notification server setup that allows communication via `notify-send`.