While vgseer can be used on a remote machine using ssh or telnet, it only makes sense for vgd to be running on the same X server as the user (meaning, in most cases, locally).

After startup, vgd uses the syslog interface for error reporting if running as a daemon.

-p, --port=<number>

Listen on the given port. The default is 16108 (1-GLOB).

-P, --persistent=<on/off>

Keep vgd around even after all vgseers have disconnected. It will sit and listen for new connections instead of exiting. Persistence is off by default.

-D, --daemon=<on/off>

Run vgd as a daemon (it relinquishes its terminal). vgd runs as a daemon by default.

-d, --display=<vgclassic|vgmini|[path]>

Display program. The Viewglob package comes with vgclassic and vgmini (the new display). Though there aren't any other displays in existence at this point, one could be used by passing its path. The default is vgmini.

-s, --sort-style=<windows|ls>

In the display, sort files with directories first (Windows) or purely by name (ls). ls mode is the default.

-r, --dir-order=<descending|ascending|ascending-pwd-first>

In the display, list directories in descending order (the default), ascending (last referenced directory has the top listing), or ascending with the current directory always first.

-i, --file-icons=<on/off>

Show or hide the file type icons in the display.

-j, --jump-resize=<on/off>

Enable or disable the automatic moving+resizing feature of vgmini.

-z, --font-size-modifier=<+/-##>

Increase or decrease the base font size in the display by the given number. E.g. ``-z +2'' increases the window manager's default by 2, while ``-z -2'' decreases the default by 2.

--black=<colour> --red=<colour> --green=<colour> --yellow=<colour> --blue=<colour> --magenta=<colour> --cyan=<colour> --white=<colour>

Define the colours used for interpreting LS_COLORS as you would in an .Xdefaults file. This means <colour> can be a name such as ``DarkSlateGray'' or a hex specification like #RRGGBB (quoted on the command line). There are also other forms: see (3) for more information. The defaults are easy to read on a light coloured background, but probably not suitable for a dark background. For that case, these should be a good starting point (add to vgd.conf):

black #000000 red #c11125 green #50881e yellow #c4b400 blue #1662a2 magenta #ef709a cyan #2ca3a4 white #ffffff

-h, --help

Show summary of options.

-V, --version

Show the version of the program.

By default vgmini is in jump/resize mode, which means it'll move to be near the active terminal and change its dimensions to try to match. Some window managers just don't deal with this well and the resizing can get wacky. If you're seeing this behaviour, you can disable jump/resize mode (or switch to a different window manager).

If present, this file specifies a default configuration for vgd. The file syntax is:

<long_option_name> [ <whitespace> <value> ]

The '#' character can be used for comments.

So, to always listen on port 5555, run in persistent mode, and use a slightly smaller font than your window manager suggests, the file should contain:

port

5555

persistent

font-size-modifier

-1

Configuration file options can be overridden on the command line.

LS_COLORS

Used by the display as described in (5).

If you encounter an issue where certain filenames do not show in the display and you are using an encoding other than UTF-8, you may want to read about the GLib environment variables:

For example, for iso8859-1, run:

G_FILENAME_ENCODING=ISO-8859-1 vgd