Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/budlabs/ssrt
Wrapper script for Simplescreenrecorder
https://github.com/budlabs/ssrt
Last synced: about 1 month ago
JSON representation
Wrapper script for Simplescreenrecorder
- Host: GitHub
- URL: https://github.com/budlabs/ssrt
- Owner: budlabs
- License: bsd-2-clause
- Created: 2020-06-19T15:53:28.000Z (over 4 years ago)
- Default Branch: next
- Last Pushed: 2022-06-15T08:07:33.000Z (over 2 years ago)
- Last Synced: 2024-05-15T13:40:42.584Z (4 months ago)
- Language: Makefile
- Size: 136 KB
- Stars: 14
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ssrt - simplescreenreocrder - now even simpler
Use [simplescreenrecorder] without using the GUI.
In my global keybinding configuration (**i3wm**) i have the following:
```
bindsym Mod4+Print exec --no-startup-id ssrt
bindsym Control+Print exec --no-startup-id ssrt --pause
```
So by just pressing
Super+Print-Screen
i can start and stop a screenrecording.
The second keybinding uses
Ctrl
as the modifier and toggle play/pause.
> `--pause` would also start a recording if there is none.
> And the first keybinding will resume a paused recording*.
**ssrt** also trigger *event scripts* on certain
events (start/stop/pause/resume/delay). Any
executable file can be used as an eventscript,
in which the full path to the current recording
will be available in the environment
variable: **SSR\_OUTPUTFILE**.
Some example usecases for the event scripts:
- unmute the microphone before recording starts
- preview the recording in a videoplayer when recording stops
- convert recorded media
- display notifications on pause and delay
[simplescreenrecorder]: https://www.maartenbaert.be/simplescreenrecorder/
## installation
If you use **Arch Linux** you can get **ssrt**
from [AUR].
**ssrt** is a **bash** script and beside `bash (1)`
and `simplescreenrecorder(1)`, the only other external
commands needed are `gawk (1)`, `slop(1)`, and `xrandr(1)`.
(*configure the installation in `config.mak`, if needed*)
```
$ git clone https://github.com/budlabs/ssrt.git
$ cd ssrt
$ make
# make install
$ ssrt -v
ssrt - version: 2020.06.22.1
updated: 2020-06-22 by budRich
```
[AUR]: https://aur.archlinux.org/packages/ssrt
## usage
ssrt [OPTIONS]
-e, --codec CODEC | CODEC defaults to h264 (or vp8 for webm).
-c, --config-dir DIR | set ssr conifg directory
-n, --container CONTAINER | set CONTAINER type. example containers: mkv and webm.
-d, --delay SECONDS | delay start of recording
-h, --help | print help and exit
-i, --input-file FILE | change default (/tmp/ssrt/in) inputfile.
-m, --mute | disables audio in recording
-p, --pause | toggle play/pause or start a new recording.
-s, --select | select recording area before recording starts.
-v, --version | print version info and exit
*event scripts* are stored in
**SSR\_CONFIG\_DIR**/events\* ,
as executable files with the same name as the
event (delay|pause|resume|start|stop).
When **ssrt** is launched for the first time a sample
`events` directory will be created but
the scripts are *"empty"*.
> \* SSR\_CONFIG\_DIR defaults to simplescreenrecorders
> configuration directory: `~/.ssr`