directvt/vtm v2025.07.26

on GitHub

Changes

• Allow access to settings from Lua.
  • bash:

    # example: Prints the value of the vtm.config["/Ns/ru-RU/NoWrapMode/on/label"] when the "PushMe" terminal menu button is pressed.
    vtm -c "<config/terminal/menu/item label='PushMe' script=OnLeftClick|'vtm.terminal.Print(vtm.config[\"/Ns/ru-RU/NoWrapMode/on/label\"])'/>" -r term

• Add UI localization support.
  The vtm user interface can be localized into any language by providing a translation and specifying the required language ID in the settings. The vtm UI interface has a built-in English en-US and Russian ru-RU localization.
  For example:
  • To activate the ru-RU interface with fallback to en-US for the desktop:

    vtm --config "<Ns=en-US|ru-RU/>"
    

  • To activate the ru-RU interface for the built-in terminal:

    vtm --config "<Ns=en-US|ru-RU/>" --run term
    

  In order to make your own translation for vtm, you need to copy the subsection <Ns><en-US>...</en-US></Ns> to, say, <Ns><it-IT>...</it-IT></Ns> and translate the quoted string values. Then you need to update the reference for the the literal lookup from <Ns=en-US> to <Ns=en-US|it-IT>. As a result, you will get a configuration like this:
  ~/.config/vtm/settings.xml:

  <config>
  ...
  </config>
  <Ns = en-US|it-IT>  <!-- Set localization to "it-IT" with fallback to "en-US". -->
    <en-US>
        <Taskbar>
            <Apps label="apps"/>
        </Taskbar>
        ...
    </en-US>
    <it-IT>
        <Taskbar>
            <Apps label="programmi"/>
        </Taskbar>
        ...
    </it-IT>
  <Ns>
  ...