History

dominic 5d33b4ea23 Update 'dm-recording/README.md'		2019-11-05 21:58:35 +00:00
..
.media	Add webm	2019-11-05 23:00:05 +01:00
dm-recording.sh	Update requirements	2019-11-05 22:51:01 +01:00
README.md	Update 'dm-recording/README.md'	2019-11-05 21:58:35 +00:00

README.md

dm-recording

dm-recording is a dmenu controlled utility that manages screen recordings using ffmpegs 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 and run dm-recording. Everything else is managed and communicated by dmenu and notify-send.

Click me 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.