160 lines
4.2 KiB
Markdown
160 lines
4.2 KiB
Markdown
wf-shadow(1) "wf-shadow" "General Commands Manual"
|
|
|
|
# NAME
|
|
|
|
*wf-shadow* — An instant-replay solution for Linux-based operating systems running
|
|
a wlroots Wayland compositor
|
|
|
|
# SYNOPSIS
|
|
|
|
*wf-shadow* _OPTION_ [_OPTIONS_...]
|
|
|
|
# DESCRIPTION
|
|
|
|
*wf-shadow* is a script written in order to fill the void in instant-replay
|
|
software for Wayland, specifically wlroots compositors. It uses wf-recorder(1)
|
|
and wofi(1) in order to accomplish the task.
|
|
|
|
# OPTIONS
|
|
|
|
*-A, --acodec* _CODEC_
|
|
This option is passed directly to ffmpeg(1)'s _-acodec_. Saved between
|
|
clips over the course of a session's lifetime.
|
|
|
|
*-a, --audio* _DEVICE_
|
|
This option is used in order to set the pulseaudio/pipewire-pulse device
|
|
that is recorded by *wf-shadow*.
|
|
|
|
*-c, --vcodec* _CODEC_
|
|
This option is passed directly to ffmpeg(1)'s _-vcodec_. Saved between
|
|
clips over the course of a session's lifetime.
|
|
|
|
*-d, --debug*
|
|
Sets the bash(1) _-x_ option.
|
|
|
|
*-e, --end* [_MONITOR_]
|
|
End the current instance running on monitor _MONITOR_.
|
|
|
|
*-h, --help*
|
|
Shows a simple help menu.
|
|
|
|
*-N, --no-video*
|
|
By default, *wf-shadow* enables video recording. Saved between clips
|
|
over the course of a session's lifetime.
|
|
|
|
*-n, --no-audio*
|
|
By default, *wf-shadow* enables the -a option of wf-recorder(1). This
|
|
option disables it. Saved between clips over the course of a session's
|
|
lifetime.
|
|
|
|
*-r, --record* [_MONITOR_]
|
|
Record the last few moments of video using a wofi(1) menu.
|
|
|
|
This will use the same _MONITOR_ number as any running session of
|
|
*wf-shadow*.
|
|
|
|
*-s, --start* [_MONITOR_]
|
|
Starts a wf-shadow instance on monitor number _MONITOR_, if no _MONITOR_
|
|
is specified, then use monitor #1.
|
|
|
|
*-V, --video* _DEVICE_
|
|
This option is passed directly to wf-recorder(1)'s _-d_ option.
|
|
|
|
*-v, --verbose*
|
|
Show the output of wf-recorder(1), ffmpeg(1), and wofi(1).
|
|
|
|
*-Y, --yes-video*
|
|
Enable video recording. Overrides _-N_. Saved between clips over the
|
|
course of a session's lifetime.
|
|
|
|
*-y, --yes-audio*
|
|
Enable audio recording. Overrides _-n_. Saved between clips over the
|
|
course of a session's lifetime.
|
|
|
|
# ENVIRONMENT
|
|
|
|
*WF_SHADOW_DIR*
|
|
The path to the directory used to save clips.
|
|
|
|
*WF_SHADOW_FMT*
|
|
The date(1) _-d_ format used by *wf-shadow* to save clips.
|
|
|
|
*WF_SHADOW_EXT*
|
|
The file extension of the saved clips. Matches the container
|
|
|
|
*WF_SHADOW_SAVE*
|
|
The bash(1) command to run to get the save file for clips. The output of
|
|
the command is used as the path. Overrides *WF_SHADOW_DIR*,
|
|
*WF_SHADOW_FMT*, and *WF_SHADOW_EXT*.
|
|
|
|
*WF_SHADOW_CONFIG*
|
|
The path to the configuration file used by *wf-shadow*.
|
|
See *CONFIGURATION* for how to configure *wf-shadow*.
|
|
|
|
# CONFIGURATION
|
|
|
|
The configuration file takes the form of a bash(1) script. This file is sourced
|
|
after default variables are set. Use standard bash variable definitions in order
|
|
to set either environment variables found in *ENVIRONMENT*, or the following
|
|
variables.
|
|
|
|
*MONITOR*
|
|
The monitor number to use to start, end, or record on. Default is 1.
|
|
|
|
*AUDIO_DEV*
|
|
This variable is the same as what is passed to _-a_. See *OPTIONS* for
|
|
more information.
|
|
|
|
*AUDIO_CODEC*
|
|
This variable is the same as what is passed to _-A_. See *OPTIONS* for
|
|
more information.
|
|
|
|
*NO_AUDIO*
|
|
When this variable is set, audio recording will be disabled.
|
|
|
|
*VIDEO_DEV*
|
|
This variable is the same as what is passed to _-V_. See *OPTIONS* for
|
|
more information.
|
|
|
|
*VIDEO_CODEC*
|
|
This variable is the same as what is passed to _-c_. See *OPTIONS* for
|
|
more information.
|
|
|
|
*NO_VIDEO*
|
|
When this variable is set, video recording will be disabled in outputted
|
|
clips.
|
|
|
|
*VERBOSE*
|
|
This variable is non-empty if verbose output should be enabled. Same as
|
|
_-v_.
|
|
|
|
# EXAMPLES
|
|
|
|
*wf-shadow* _-s_ _1_
|
|
Start a *wf-shadow* session on monitor #1.
|
|
|
|
*wf-shadow* _-r_ _1_
|
|
Show a wofi(1) menu of time intervals to save as a clip for the
|
|
*wf-shadow* session on monitor #1. Fails if no such session exists.
|
|
|
|
*wf-shadow* _-e_ _3_
|
|
End the *wf-shadow* session running on monitor #3. Fails if no such
|
|
session exists.
|
|
|
|
*wf-shadow* _-s_ _2_ _-V_ _/dev/dri/renderD128_ _-v_
|
|
Start a *wf-shadow* session on monitor #2, using /dev/dri/renderD128 as
|
|
the video encoder. Print verbose output.
|
|
|
|
# EXIT STATUS
|
|
|
|
143 A session has ended.
|
|
|
|
Other See output.
|
|
|
|
# SEE ALSO
|
|
|
|
wf-recorder(1) wofi(1) ffmpeg(1) pactl(1) date(1) bash(1)
|
|
|
|
# AUTHOR
|
|
Skylar "The Cobra" Widulski <thecobra@riseup.net>
|