ffcast - screencast an interactively selected region
- ffcast [<options>] [<geospec>] % [<command> [<args>]]
- ffcast [<options>] [<geospec>] [<command> [<args>] [--] [<args>]]
ffcast is a thin glue between interactive region selection and command line tools that accept numerical geometry parameters. It makes passing geometry parameters to command line tools as easy as a mouse click. Screencasting tools are typical examples of such command line tools.
Typically, ffcast prompts the user to select a screen region and injects the geometry parameters thereof into the arguments of <command>, and then executes the resultant command line.
The first form is called the format string syntax. Format strings in <args> are substituted with the corresponding geometry parameters. See FORMAT STRINGS.
The second form is called the double hyphen syntax. Only a limited set of commands are recognized. A set of geometry-related arguments specific to <command> are inserted in place of the first argument that is `--', or if `--' is not found, immediately after <command>. <args> are left as they are specified.
If <command> is not given, a default ffmpeg command line is used.
Any of the <options> can be repeated. They are parsed and applied in the order they are specified.
Include borders of windows to be selected.
Print help message, then exit. When used with -v, print long help.
List commands recognized by the double hyphen syntax, then exit.
Trim both dimensions of the selected region to be divisible by 16. By default, both dimensions are trimmed to be divisible by 2, which is required by ffmpeg. This switch may improve video quality.
Print geometry of the selected region and exit without executing <command>. The dimensions are not trimmed.
Be less verbose.
Prompt to select a region.
Be more verbose.
Prompt to select a window.
The format string syntax defines the following format strings:
A literal %
The <geospec> specifies a geometry in one of the following forms:
- x,y X,Y
x, y, X and Y are the left, top, right and bottom offsets, respectively.
w, h, x and y are the width, height and left and right offsets, respectively.
To get the default host and display number.