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).

--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.

--lang <language>

Override the UI language for this run, without changing the saved Preferences setting. Mutually exclusive with --pseudo-translation and --pseudo-translation-bidi. <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.

-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.