Command line programs

Paraphernalia ships with a few command line programs. These are self-documenting via the --help option.

render

Render a fragment shader to an MP4 file.

render [OPTIONS] FRAGMENT_SHADER

Options

-o, --output <output>

Output file

Default

output.mp4

--width <width>

Width in pixels

Default

1024

--height <height>

Height in pixels

Default

1024

--fps <fps>

Frames per second

Default

25.0

--duration <duration>

Duration in seconds

Default

30.0

--quality <quality>

Encoder quality

Default

5

Arguments

FRAGMENT_SHADER

Required argument

preview

Show a fragment shader in a window.

preview [OPTIONS] FRAGMENT_SHADER

Options

--width <width>

Target width

Default

1024

--height <height>

Target height

Default

1024

--duration <duration>

Target duration, loop if > 0

Default

30

--speed <speed>

Multiplier for elapsed time

--watch, --no-watch

Automatically reload when shader changes on disk

--scale <scale>

TODO

Default

1.0

Arguments

FRAGMENT_SHADER

Required argument

review

Review images in SOURCE.

Keymap:

  • K: keep the current image

  • L: lose the current image

  • T: (re)mark image as to-be-reviewed

  • LEFT: go to previous image

  • RIGHT: go to next unreviewed image

  • F: toggle fullscreen

  • S: toggle scaling mode

review [OPTIONS] [SOURCE]

Options

--dryrun

Don’t move files around

Arguments

SOURCE

Optional argument

sign

Manipulate basic XMP/Dublin Core metadata in PNG, JPG and TIFF images.

sign [OPTIONS] TARGET

Options

--clear, --no-clear

Clear metadata.

Default

False

-c, --creator <creators>

Set the creator(s).

--title <title>

Set the title.

-t, --tag <tags>

Add one or more tags.

-d, --description <description>

Set the description.

-r, --rights <rights>

Set the statement of rights.

Arguments

TARGET

Required argument