# pcb-rnd - user manual

## 4. User Invocation (running pcb-rnd)

pcb-rnd is typically run by invoking it from the shell after installation

`pcb-rnd [options]` or `pcb-rnd [options] path`

When a path is provided, it is either a board file or a subcircuit which will be automatically opened for editing. When invoked with a path referring to a non-existing file, pcb-rnd assumes a new board is to be created and saved using the file name provided as path. This makes it very easy to make new boards from the command line.

The list of available options can be acquired by running

`pcb-rnd --help`

The most commonly used option is to export a file: `pcb-rnd -x format [format_options] path`

For example a photo-realistic png export pwr.png from the board saved in pwr.lht can be exported as: `pcb-rnd --export png --dpi 600 --photo-mode pwr.lht`

Listing exporter-specific options is possible running pcb-rnd --help exporter, e.g.: `pcb-rnd --help png`

Another typical application of options is to select the user interface to start pcb-rnd with (as pcb-rnd normally comes with multiple UIs compiled in):

    pcb-rnd --gui=batch
    pcb-rnd --gui=gtk2_gdk
    pcb-rnd --gui=gtk2_gl
    pcb-rnd --gui=lesstif

The most notable UI is the batch UI: it reads the standard input for action commands, executes them and quits on EOF. This allows pcb-rnd to be run as a UNIX filter (just like a sed, awk or perl), loading, manipulating and saving boards, without starting a GUI.