18 lines
1.4 KiB
Markdown
18 lines
1.4 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
|
|
Make sure you meet [the requirements](https://gitea.leafbla.de/dominic/dm-scripts/src/branch/master/dm-recording#requirements) and run `dm-recording`. Everything else is managed and communicated by `dmenu` and `notify-send`.
|
|
|
|
[Click me](https://gitea.leafbla.de/dominic/dm-scripts/src/branch/master/dm-recording/.media/example.mp4) to see a sample video.
|
|
|
|
|
|
|
|
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`, `slop` (for the region and window selection), `ffmpeg` (for the recording) and `libxcb` (for recording X displays using ffmpeg) installed in order to run dm-recording. It is recommended to have a notification server setup that allows communication via `notify-send`.
|