Command Line Options

Besides opening a file by clicking on it, Virtaal can be launched directly from the command line:

virtaal [options] [filename]

filename is optional, and is the translation file to open on startup (see Opening a File).

-h, --help

Show a summary of these options and exit.

-v, --version

Print Virtaal’s version and exit.

-l <filename>, --log <filename>

Turn on logging, storing the result to the supplied filename. Use - or STDOUT to log to the console instead of a file.

-c <filename>, --config <filename>

Use the configuration file given by the supplied filename, instead of Virtaal’s default configuration location.

-D, --debug

Enable debugging features, and turn on debug-level logging (see --log).

--lang <language>

Override the UI language for this run, without changing the saved Preferences setting. Mutually exclusive with the pseudo-translation options. <language> is one of:

  • a language code (e.g. fr) - Virtaal must have a translation for it (see Localising Virtaal).

  • en - Virtaal’s own untranslated source strings.

  • system - the OS’s own default locale, ignoring the saved Preferences setting.

Developer options

These are for developing Virtaal itself, so --help doesn’t list them.

--pseudo-translation

Wrap every translatable UI string in brackets (e.g. [Save]), using a synthetic pseudo-translation rather than a real one. Useful for spotting hardcoded strings and layout truncation. Mutually exclusive with --pseudo-translation-bidi and --lang.

--pseudo-translation-bidi

Like --pseudo-translation, but also wraps every string in Unicode right-to-left isolate marks, simulating a right-to-left UI layout while keeping the text itself readable. Mutually exclusive with --pseudo-translation and --lang.

--pseudo-translation-source

Prefix every UI string with the catalog it comes from: vt: for Virtaal’s own, gtk: for GTK’s, glib: for GLib’s and iso: for language and country names (e.g. gtk:_Open). A string with no prefix isn’t translatable. Mutually exclusive with the other pseudo-translation options and --lang.

--pseudo-translation-priority

Prefix every UI string with its translation priority from po/virtaal.priorities.yaml (see po/README.md): 1: for the core of level 1, 1~: for the rest of it, 2:, 3:, x: for one translators are never asked for, and ?: for one the file doesn’t list (e.g. 1:_Open). Mutually exclusive with the other pseudo-translation options and --lang.

--priorities <filename>

The priority file --pseudo-translation-priority reads, instead of po/virtaal.priorities.yaml - for checking one before it’s committed.

-P <filename>, --profile <filename>

Perform profiling, storing the result to the supplied filename in KCacheGrind format. Only available in a development checkout, not in a packaged build.