From Torque Wiki
Revision as of 07:39, 17 January 2012 by Ihawkins (talk | contribs) (Properties.txt file format)

Themes can be created for Torque and used in the app, they can also be uploaded to the theme server so that others can enjoy the theme

Example screenshot using themes in 1.5.32

There are several parts to a theme which are contained within a .zip file:

  • properties.txt - This references various settings that can be adjusted, from fonts, to needle size, colours, and the position of 'ticks' within the dial surfaces
  • background.jpg - This is the main background image that is shown on the screen
  • dial_background.png - this is the background used for circular dials
  • display_background.png - this is the background used for square displays.

You can test your own themes by extracting the contents of your .zip file to the /.torque/themeDir/ folder on your SD card, then restarting Torque. An example of a theme file can be found here: [[1]]

As of 1.5.32(full version) the dial_background.png and display_background.png are further expanded, so that you can now have custom backgrounds depending on the PID (sensor) the display is showing, so for an RPM dial display that you may wish to show a different background for, you would include a file named as:


The '0c' is the PID of the display you want that background to reference, for Speed, it's '0d' (0x0D in hex), and fuel pressure would be '0a'. There is a list of what these codes are on the sensors list page PluginDocumentation

You can also set the font type - include a file 'font.ttf' inside the theme zip and the app will automatically use it when the theme is selected.

Properties.txt file format

The properties file is a simply key=value file that can be edited in a text editor. It allows you to control various things like colours, and positioning of dial elements.

  • dialTickInnerRadius=<value>
  • dialTickOuterRadius=<value>
  • displayTickColour=<colour - can be HTML notation #rrggbb, #aarrggbb or 'green'>
  • displayTextTitleColour=<colour, as described above>
  • displayTextValueColour=<colour, as described above>
  • dialNeedleLength=<value>
  • displayIndicatorColour=<colour, as described above> (dial needle colour, and/or other 'indicator' colour)
  • font=<string font, as known in android, eg: 'sans-serif'> (you can also use a .ttf file - see above)
  • globalFontScale=<number> (available in version 1.5.36)

The font= directive is the android font - bear in mind that different devices may not contain the font you are using so this really should just stick to the default android fonts. The file.ttf (if present in the theme) should override the font= directive

If you have created a theme and want to share it, [let me know] and I'll add it to the theme server!