Themes

From Torque OBD2 Wiki

Jump to: navigation, search

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:

dial_background_0c.png

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.

How dialStartAngle and dialStopAngle work

Dial stop and dial start angles are offsets from the bottom of the dial. To make a dial look like a more conventional vehicle speedometer dial you could put: dialStartAngle_0d=45 dialStopAngle_0d=45

'0d' is the PID for the speedometer. You can find the list of PIDs here: PluginDocumentation

Dials which use the start and stop angles cannot show negative numbers on the dial itself (but the number value will still be visible on the actual dial face)


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>
  • dialStartAngle_<pid>=<value>
  • dialStopAngle_<pid>=<value>
  • dialNeedleLength=<value>
  • globalDialStartAngle=<value>
  • globalDialStopAngle=<value>
  • displayTickColour=<colour - can be HTML notation #rrggbb, #aarrggbb or 'green'>
  • displayTextTitleColour=<colour, as described above>
  • displayTextValueColour=<colour, as described above>
  • 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)
  • hideTicks_<pid>=<true | false> - Hide the tick marks on dials
  • globalHideTicks=<true | false> - Global option for hiding tick marks on all dials
  • textRadius_<pid>=<multipler - eg: 1.5> - controls the dial text distance from centre of dial.
  • globalTextRadius=<multipler - eg: 1.5> - global option for all dials to control text placement


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 "font.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!

Personal tools