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
-orSTDOUTto 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.
- --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-bidiand--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-translationand--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 andiso: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(seepo/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-priorityreads, instead ofpo/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.