--no-login When additional terminals are enabled do not display login prompt on them. Can be used by scripts to display debugging information and logs on additional terminals.

--num-vts=N Specify number of enabled VTs. The default is 4, the maximum is 12.

--offset=x,y Specify absolute location of the splash image on screen.

--pre-create-vts Normally VTs are create on demand the the user switches to a VT. In some cases it may be necessary to pre-create them at startup, for instance to write a log or debug output for them while they are not active so it can be examined later. This option allows for that. This option also ensures daemon parent waits for daemon child to finish initalization so consoles are created by the time daemon parent exits.

--scale=N Set default scale for splash screen images. The scale is a positive integer number. Default scale is 1. 0 has a special meaning - using scale 1 for screens with horizontal resolution lower and equal than 1920 and 2 otherwise. Scale affects image/box size and offset.

--splash-only Exit immediately after finishing splash animation. Otherwise frecon will wait for DBUS signal (LoginScreenVisible) from Chrome before exiting when extra terminals are not enabled.

--image=/path/to/image.png

--image-hires=/path/to/image.png or any image file name specified after options Add image to splash screen animation. --image and --image-hires are added conditionally depending whether horizontal or vertical screen resolution is above 1920. This allows frecon to make runtime decision which set of images to use instead running frecon first with --print-resolution option and making this decision in a script that invokes frecon. Free form image file name in the command line are added unconditionally.

Imaging escape codes

Frecon implements rudimentary functionality to display images and draw single color boxes on the terminal screen using OSC (Operating System Command) based terminal escape codes.

The OSC sequences always start with ESC+] (\033]) and end with either the String Terminator (ST) sequence (\033\\) or a BEL (\a) character.

Two escapes are implemented, all escape parameters can be specified in any order.

image:file=/full/path/to/file.png;location=x,y;offset=x,y;scale=s

box:size=w,h;color=c;location=x,y;offset=x,y;scale=s

location is the absolute location on screen.

offset is an image offset starting with image centered on screen.

color is a 32-bit number in the same format as --clear command line argument, it defaults to 0.

Input escape code

An escape code can be used to enable/disable keyboard input processing on a terminal. The setting is stored per terminal and applies to input “within” terminal. Swithing between terminals, scrolling, backlight control etc remains operational.

Files

Frecon creates the following files and links in /run/frecon directory:

/run/frecon/pid which contains pid for frecon daemon process (only when --daemon is specified on command line).

for every VT it creates, a link from /run/frecon/vt%u to /dev/pts/X where %u is terminal number from 0 to num-vts - 1 so the user can determine which VT uses which pts since pts number assignment is not deterministic.