Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

167 lines (93 sloc) 3.157 kb

NAME

ffcast - screencast an interactively selected region

SYNOPSIS

ffcast [<options>] [<geospec>] % [<command> [<args>]]
ffcast [<options>] [<geospec>] [<command> [<args>] [--] [<args>]]

DESCRIPTION

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.

OPTIONS

Any of the <options> can be repeated. They are parsed and applied in the order they are specified.

-b

Include borders of windows to be selected.

-h

Print help message, then exit. When used with -v, print long help.

-l

List commands recognized by the double hyphen syntax, then exit.

-m

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.

-p

Print geometry of the selected region and exit without executing <command>. The dimensions are not trimmed.

-q

Be less verbose.

-s

Prompt to select a region.

-v

Be more verbose.

-w

Prompt to select a window.

FORMAT STRINGS

The format string syntax defines the following format strings:

%d

DISPLAY

%h

Height

%w

Width

%x

Left offset

%y

Top offset

%X

Right offset

%Y

Bottom offset

%%

A literal %

GEOMETRY SPECIFICATION

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.

wxh+x+y

w, h, x and y are the width, height and left and right offsets, respectively.

ENVIRONMENT

DISPLAY

To get the default host and display number.

AUTHOR

lolilolicon <lolilolicon@gmail.com>

SEE ALSO

ffmpeg(1)

Jump to Line
Something went wrong with that request. Please try again.