Note: following guide is updated to match latest released version.

TinyPedal offers a wide range of customization options for widget and module controls, which can be accessed from corresponding tabs in main window.

TinyPedal stores global user configuration in config.json file, which is used for none-preset specific options.

• For Windows, config.json is stored under username\AppData\Roaming\TinyPedal folder.
• For Linux, config.json is stored under home/username/.config/TinyPedal folder.

Available settings:

• Application, can be accessed from Config menu in main window, see Application section for details.
• Telemetry API, can be accessed from API menu in main window, see Telemetry API section for details.
• Compatibility, can be accessed from Config menu in main window, see Compatibility section for details.
• User path, can be accessed from Config menu in main window, see User Path section for details.
• Auto load preset, can be accessed from Preset tab in main window, see Preset Management section for details.

Reload or Restart:

• To reload all presets, select Reload from Overlay menu in main window.
• To restart game API, select Restart API from API menu in main window.
• To restart TinyPedal, select Restart TinyPedal from Window menu in main window.

Back to Top

TinyPedal stores all customization options in JSON format preset files, and can be managed from Preset tab in main window.

All user preset files, by default, are located in TinyPedal\settings folder. Those JSON files can also be manually edited with text editor.

Double-Click on a preset name in Preset tab to load selected preset.

Click Transfer button to transfer settings from currently loaded preset to another preset. See Preset Transfer section for details.

Right-Click on a preset name in Preset tab opens up a context menu that provides additional preset file management options:

• Lock Preset

  Lock selected preset, which prevents any changes that made through TinyPedal from saving to locked preset file. APP version tag will be attached to the preset that is locked with.

  Note, this feature does not prevent user from modifying or deleting locked preset file by other means. Locked preset file info is stored in config.lock file in Global User Configuration folder.

• Unlock Preset

  Unlock selected preset.

• Set Primary for Class

  Add primary class tag to selected preset, which will be auto loaded by Auto load preset system. Class tags and colors are defined in classes.json file, which can be modified in Vehicle Class Editor.

  Note, a single preset can have tags from multiple classes. Auto loading primary class preset (if available) always takes priority over primary sim.

• Clear Primary Tag

  Clear all primary tags from selected preset.

• Duplicate

  Duplicate selected preset with a new name.

• Rename

  Rename selected preset with a new name. This option is not available for locked preset.

• Delete

  Delete selected preset with confirmation. This option is not available for locked preset.

Back to Top

TinyPedal automatically saves setting when user makes changes to widget position, or has toggled widget visibility, auto-hide, overlay-lock, etc. Changes will only take effect after Reload preset, or clicked Save or Apply button in Config dialog, or Restart APP.

Back to Top

TinyPedal will automatically create backup file with time stamp suffix if old setting file fails to load, and new default JSON with same filename will be generated.

A newer released version will auto-update old setting and add new setting after loading. It may still be a good idea to manually backup files before upgrading to newer version.

Back to Top

Customization can be done through various configuration dialogs and menus from main window. Manual editing JSON file is not recommended.

Back to Top

Preset transfer dialog is used for transferring settings from one preset to another.

Note, you can only transfer settings from a currently loaded preset to another preset, this is done to ensure one-way transfer.

A confirmation dialog will be shown before transfer.

It is recommended to first load a preset, then unhide the preset and double-check if you wish to transfer its settings to another preset.

For important preset, it is recommended to make a backup copy, and/or lock the preset.

To transfer settings from currently loaded preset to another specific preset, select a preset name from preset selector on the top right. Locked presets are not available from preset selector.

To select one or more settings, select and check setting name from Setting list on the left side. Only selected settings will be transferred.

To select one or more option types, select and check option type name from Option Type list on the right side. Only selected options will be transferred.

To select or deselect all settings or option types from list, click All or None button on list header.

Option types:

• Enable State: widget or module enable state.
• Feature Toggle: widget or module feature enable state, such as enable_XXX or show_XXX.
• Update Interval: widget or module update interval and idle update interval.
• Position: widget position.
• Opacity: widget opacity.
• Layout: widget layout.
• Color: color options.
• Font: font name, font weight, font size options.
• Column Index: column index options.
• Decimal Places: decimal places options.
• Other Options: all other options that are not part of above option types.

For example, to only transfer all widgets position setting to another preset, select and check all settings from Setting list on the left side, then select only position from Option Type list on the right side, and click Transfer button.

Back to Top

Brands preset is used for customizing brand name that matches specific vehicle name.

Brands preset can be customized by accessing Vehicle brand editor from Tools menu in main window. See Vehicle Brand Editor section for complete editing guide.

brands.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Classes preset is used for customizing class name and color that matches specific vehicle class.

Classes preset can be customized by accessing Vehicle class editor from Tools menu in main window. See Vehicle Class Editor section for complete editing guide.

classes.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Brakes preset is used for customizing brake failure thickness and heatmap style that matches specific vehicle class.

Brakes preset can be customized by accessing Brake editor from Tools menu in main window. See Brake Editor section for complete editing guide.

brakes.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Compounds preset is used for customizing tyre compound symbol and heatmap style that matches specific tyre compound.

Compounds preset can be customized by accessing Tyre compound editor from Tools menu in main window. See Tyre Compound Editor section for complete editing guide.

compounds.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Heatmap preset is used for customizing heatmap color that matches specific value range of telemetry data, such as brake and tyre temperature.

Heatmap preset can be customized by accessing Heatmap editor from Tools menu in main window. See Heatmap Editor section for complete editing guide.

heatmap.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Tracks preset is used for storing and customizing track info for various track-related calculation.

Tracks preset can be customized by accessing Track info editor from Tools menu in main window. See Track Info Editor section for complete editing guide.

Track info recording is handled by Mapping Module.

tracks.json preset will be generated and saved in TinyPedal\settings folder after first time launch of the APP.

Back to Top

Shortcuts preset is used for customizing global hotkey binding.

Shortcuts preset can be customized by accessing Hotkey Tab in main window.

shortcuts.json preset will be generated and saved in Global User Configuration folder after first time launch of the APP.

Back to Top

TinyPedal generates and saves user session data in specific folders defined in User path. Session data can be reset by accessing Reset data menu from Overlay menu in main window; or, delete data file from corresponding folder.

Back to Top

Driver stats data is stored as JSON format (.stats extension) under Global User Configuration folder. Driver stats can be viewed with Driver Stats Viewer from Tools menu in main window.

Data recording is handled by Stats Module.

Back to Top

Delta best data is stored as CSV format (.csv extension) under TinyPedal\deltabest folder (default). Those files can be opened in spreadsheet or notepad programs.

Data recording is handled by Delta Module.

Back to Top

Energy delta data is stored as CSV format (.energy extension) under TinyPedal\deltabest folder (default). Those files can be opened in spreadsheet or notepad programs.

Data recording is handled by Fuel Module.

Back to Top

Fuel delta data is stored as CSV format (.fuel extension) under TinyPedal\deltabest folder (default). Those files can be opened in spreadsheet or notepad programs.

Data recording is handled by Fuel Module.

Back to Top

Consumption history data is stored as CSV format (.consumption extension) under TinyPedal\deltabest folder (default). Those files can be opened in spreadsheet or notepad programs.

Consumption history data stores lap time, fuel consumption, battery charge, tyre wear usage data per track and vehicle class, which can be loaded in Fuel Calculator. Up to 100 most recent lap entries are saved per track and vehicle class. Data recording is handled by Fuel Module.

Back to Top

Sector best data is stored as CSV format (.sector extension) under TinyPedal\deltabest folder (default). Those files can be opened in spreadsheet or notepad programs.

Data recording is handled by Sectors Module.

Back to Top

Track map is stored as SVG vector image format (.svg extension) under TinyPedal\trackmap folder (default). Track map can be viewed with Track Map Viewer from Tools menu in main window.

Data recording is handled by Mapping Module.

The SVG vector map data contains two coordinate paths:

• First is global x,y position path, used for drawing track map.
• Second is corresponding track distance and elevation path, used for drawing elevation plot.

Each sector position index is also stored in SVG file for finding sector coordinates.

Back to Top

TinyPedal Pace Notes data is stored as TPPN format (.tppn extension) under TinyPedal\pacenotes folder (default). Pace notes can be created or edited with Track Notes Editor from Tools menu in main window.

Pace notes data is mainly used for Pace Notes Playback for specific tracks.

To allow auto notes loading function to work, pace notes file name must match same track map file name.

Back to Top

TinyPedal Track Notes data is stored as TPTN format (.tptn extension) under TinyPedal\tracknotes folder (default). Track notes can be created or edited with Track Notes Editor from Tools menu in main window.

Track notes data is mainly used for displaying corner and section names for specific tracks, or providing additional info at specific track location while driving.

To allow auto notes loading function to work, track notes file name must match same track map file name.

Back to Top

TinyPedal Tyre Strategy file is stored as JSON format (.tyre-strategy extension). Tyre strategy file can be created or edited with Tyre Strategy Planner from Tools menu in main window.

Back to Top

TinyPedal supports user-defined brand logo image in PNG format (.png extension) which is placed under TinyPedal\brandlogo folder (default).

Note: TinyPedal does not provide brand logo image assets, it is up to user to prepare images. Maximum PNG file size is limited to 5MB.

How to prepare brand logo image:

1. Brand logo image should have all transparent borders cropped. For example, in GIMP this can be done by selecting Image > Crop to Content.
2. Make sure image dimension is not too big, usually around 100 pixel width or height is good enough. Bigger dimension may consume more RAM or exceed maximum supported file size.
3. Save image to TinyPedal\brandlogo folder, image filename must match corresponding brand name that defined in Vehicle Brand Editor. For cross-platform compatibility, filename matching is set to be case-sensitive, make sure filename has the same upper or lower case as set in brand name.
4. Reload preset to load newly added brand logo images for displaying in overlay.

Back to Top

Car setup files for specific games are stored under TinyPedal\carsetups folder (default). Those files are auto generated backups via Auto Backup Car Setup function.

See Telemetry API section for details about Auto Backup Car Setup function.

Back to Top

Command line arguments can be passed to script or executable to enable additional features.

-h, --help

List all available command line arguments.

Usage: python .\run.py -h or .\tinypedal.exe --help

-l, --log-level

Set logging output level. Supported values are:

• --log-level 0 outputs only warning or error log to console.
• --log-level 1 outputs all log to console.
• --log-level 2 outputs all log to both console and tinypedal.log file.

Log location:

• On windows, tinypedal.log is located under username\AppData\Roaming\TinyPedal folder.
• On Linux, tinypedal.log is located under home/username/.config/TinyPedal folder.

Default logging output level is set on 1 if argument is not set.

Usage: python .\run.py -l 2 or .\tinypedal.exe --log-level 2

-s, --single-instance

Set running mode. 0 allows running multiple instances (copies) of TinyPedal. 1 allows only single instance (default).

To run multiple copies of TinyPedal at same time: python .\run.py -s 0 or .\tinypedal.exe --single-instance 0

Single instance mode saves pid.log file in the same folder as tinypedal.log, which is used for instance identification.

-p, --pyside

Set PySide (Qt for Python) module version. Set 2 for PySide2 (default). Set 6 for PySide6. Currently, this option is only available while running from source, and mainly for testing purpose or used on platform where PySide2 is no longer available.

Back to Top

Console log can be accessed in Show Log dialog from Help menu in main window.

To save all log, click Save button.

To copy all log to clipboard, click Copy button.

To clear all log, click Clear button.

To refresh log, click Refresh button.

To enable auto-refreshing, toggle on Auto Refresh check box.

Back to Top

Telemetry API options can be accessed from API menu in main window.

See Requirements section from project page for list of supported API and setup info.

api_name

Set API name for accessing data from supported API.

enable_api_selection_from_preset

Set true to remember and load API selection from preset; set false to select API globally for all presets.

enable_legacy_api_selection

Enable legacy API selection. This option is disabled by default.

Important note, legacy APIs are deprecated and no longer maintained or supported, and will be removed in the future. It is not recommended to use them.

enable_auto_backup_car_setup

Enable Auto Backup Car Setup function, currently support LMU and RF2.

This option allows to auto backup Car Setup file whenever exits pit lane with new adjustment to setup, which can be handy in various situations, especially in the event such as unexpectedly disconnected from server.

To allow Auto Backup Car Setup function to work, following additional options must be enabled:

• Stats Module from Module tab.
• Enable RestAPI Access & Enable Garage Setup Info from API option dialog.

Additional notes:

• Auto backup car setup function is disabled while in spectate mode or state overriding, or not running in single instance mode.
• Backup file is only generated after leaving pit lane. Stint best lap time (if available) will be auto-appended to backup file name after back to garage.
• Only one backup file of the most recent setup will be generated if no changes were made.
• Backup file name format:
  [game name] - [date & time] - [track name] - [class name] - [brand name] - [stint best lap time]
  *If brand name is not available, vehicle name will be used instead.

Back to Top

Le Mans Ultimate API options can be accessed from Options while this API is enabled in API menu in main window.

access_mode

Set access mode for API. Mode value 0 uses copy access and additional data check to avoid data desynchronized or interruption issues. Mode value 1 uses direct access, which may result data desynchronized or interruption issues. Default mode is copy access.

enable_active_state_override

Set true to enable active state manual override. While enabled, overriding notification will be shown on API status bar from main window.

active_state

This option overrides local player on-track status check, and updates or stops overlay and data processing accordingly. Set true to activate state. Set false to deactivate state. This option works only when enable_active_state_override enabled.

enable_player_index_override

Set true to enable player index manual override.

player_index

Set player index override for displaying data from specific player. Valid player index range starts from 0 to maximum number players minus one, and must not exceed 127. Set value to -1 for unspecified player, which can be useful for display general standings and trackmap data (ex. broadcasting). This option works only when enable_player_index_override enabled.

character_encoding

Set character encoding for displaying text in correct encoding. Available encoding: UTF-8, ISO-8859-1. Default encoding is UTF-8.

enable_restapi_access

Enable Rest API accessing, which connects to game's Rest API for accessing additional data that is not available through sharedmemory API.

restapi_update_interval

Set update interval (in milliseconds) for requesting data from Rest API.

Note, minimum update interval is hard-limited to 200 milliseconds or higher, and some data are accessed only once per garage-exit. Update interval is auto-delayed up to 5 seconds if has not received new data recently. See individual data description for details.

url_host

Set Rest API host address. Default is localhost.

url_port

Set port for Rest API host address. Port value must match WebUI port value that sets in LMU (UserData\player\Settings.JSON) setting file in order to successfully connect to Rest API and receive data. The default port value for LMU is 6397.

Note, WebUI port value from game setting file may change in some situations, and would require manual correction to match WebUI port value.

connection_timeout

Set connection timeout duration in seconds for Rest API. Value range in 0.5 to 10. Default is 1 second.

connection_retry

Set number of attempts to retry connection for Rest API. Value range in 0 to 10. Default is 3 retries.

connection_retry_delay

Set time delay in seconds to retry connection for Rest API. Value range in 0 to 60. Default is 1 second.

enable_energy_remaining

Enable access to remaining energy data from Rest API. This is required for showing remaining energy data in widgets such as Relative, Rivals, Standings. Minimum request interval is hard-limited to 1.0 second (1 request per second) for this data.

enable_garage_setup_info

Enable access to garage setup data from Rest API. This is required for accessing various vehicle setup data. This data is requested only once when player exited garage each time.

enable_session_info

Enable access to session data from Rest API. This is required for accessing various session data, such as time-scale. This data is requested only once when player exited garage each time.

enable_vehicle_info

Enable access to vehicle data from Rest API. This is essential for accessing brake wear, vehicle damage, pit stop timing data. Minimum request interval is hard-limited to 0.2 second (5 requests per second) for this data.

enable_weather_info

Enable access to weather data from Rest API. This is required for showing weather forecast. This data is requested only once when player exited garage each time.

Back to Top

rFactor 2 API options can be accessed from Options while this API is enabled in API menu in main window.

access_mode

Set access mode for API. Mode value 0 uses copy access and additional data check to avoid data desynchronized or interruption issues. Mode value 1 uses direct access, which may result data desynchronized or interruption issues. Default mode is copy access.

process_id

Set process ID string for accessing API from server. This option is for server use only.

enable_active_state_override

Set true to enable active state manual override. While enabled, overriding notification will be shown on API status bar from main window.

active_state

This option overrides local player on-track status check, and updates or stops overlay and data processing accordingly. Set true to activate state. Set false to deactivate state. This option works only when enable_active_state_override enabled.

enable_player_index_override

Set true to enable player index manual override.

player_index

Set player index override for displaying data from specific player. Valid player index range starts from 0 to maximum number players minus one, and must not exceed 127. Set value to -1 for unspecified player, which can be useful for display general standings and trackmap data (ex. broadcasting). This option works only when enable_player_index_override enabled.

character_encoding

Set character encoding for displaying text in correct encoding. Available encoding: UTF-8, ISO-8859-1. Default encoding is UTF-8. Note, UTF-8 may not work well for some Latin characters in RF2, try use ISO-8859-1 instead.

enable_restapi_access

Enable Rest API accessing, which connects to game's Rest API for accessing additional data that is not available through sharedmemory API.

restapi_update_interval

Set update interval (in milliseconds) for requesting data from Rest API.

Note, minimum update interval is hard-limited to 200 milliseconds or higher, and some data are accessed only once per garage-exit. Update interval is auto-delayed up to 5 seconds if has not received new data recently. See individual data description for details.

url_host

Set Rest API host address. Default is localhost.

url_port

Set port for Rest API host address. Port value must match WebUI port value that sets in RF2 (UserData\player\player.JSON) setting file in order to successfully connect to Rest API and receive data. The default port value for RF2 is 5397.

Note, WebUI port value from game setting file may change in some situations, and would require manual correction to match WebUI port value.

connection_timeout

Set connection timeout duration in seconds for Rest API. Value range in 0.5 to 10. Default is 1 second.

connection_retry

Set number of attempts to retry connection for Rest API. Value range in 0 to 10. Default is 3 retries.

connection_retry_delay

Set time delay in seconds to retry connection for Rest API. Value range in 0 to 60. Default is 1 second.

enable_garage_setup_info

Enable access to garage setup data from Rest API. This is required for accessing various vehicle setup data. This data is requested only once when player exited garage each time.

enable_session_info

Enable access to session data from Rest API. This is required for accessing various session data, such as time-scale. This data is requested only once when player exited garage each time.

enable_weather_info

Enable access to weather data from Rest API. This is required for showing weather forecast. This data is requested only once when player exited garage each time.

Back to Top

General options can be accessed from main window menu.

Back to Top

These are the commonly used setting terms and keywords.

enable

Check whether a widget or module will be loaded at startup.

update_interval

Set refresh rate for widget or module in milliseconds. A value of 20 means refreshing every 20ms, which equals 50fps. Since most data from sharedmemory plugin is capped at 50fps, and most operation system has a roughly 15ms minimum sleep time, setting value less than 10 has no benefit, and extreme low value may result significant increase of CPU usage.

idle_update_interval

Set refresh rate for module while idling for conserving resources.

position_x, position_y

Define widget position on screen in pixels. Those values will be auto updated and saved.

opacity

Set opacity for entire widget. By default, all widgets have a 90% opacity setting, which equals value 0.9. Lower value adds more transparency to widget. Acceptable value range in 0.0 to 1.0. Note, opacity can also be set by adjusting alpha value in color options for individual elements.

bar_gap, inner_gap

Set gap (screen pixel) between elements in a widget, only accept integer, 1 = 1 pixel.

font_name

Select a font to be displayed in widget. Mono type font is highly recommended.

Note, selected font must be already installed in operation system; if not, manually install required font. Default fallback font will be used if font is not found or installed in operation system.

font_size

Set font size in pixel, increase or decrease font size will also apply to widget size.

font_weight

Acceptable values: Thin, Extra Light, Light, Normal, Medium, Semi Bold, Bold, Extra Bold, Black.

Note, not every weight may be available for selected font.

enable_auto_font_offset

Automatically adjust font vertical offset based on font geometry for better vertical alignment, and should give good result in most case. This option is enabled by default, and only available to certain widgets. Set false to disable.

font_offset_vertical

Manually set font vertical offset. Default is 0. Negative value will offset font upward, and position value for downward. This option only takes effect when enable_auto_font_offset is set to false.

*_offset_x, *_offset_y

Set text offset position (percentage), value range in 0.0 to 1.0.

bar_padding

Set widget edge padding value that multiplies and scales with font_size. Default is 0.2 for most widgets. Increase padding value will further increase each element width in widget.

color

Set color in hexadecimal color codes with alpha value (opacity). The color code format starts with #, then follows by two-digit hexadecimal numbers for each channel in the order of alpha, red, green, blue. Note, alpha is optional and can be omitted. User can select a new color without manual editing, by double-clicking on color entry box in Config dialog.

text_alignment

Set text alignment. Acceptable value: Left, Center, Right.

prefix

Set prefix text that displayed beside corresponding data. Set to "" to hide prefix text.

show_caption

Show short caption description on widget.

display_order

Set display order of each info column or row.

decimal_places

Set amount decimal places to keep.

Back to Top

Application options can be accessed from Config and Window menu in main window.

show_at_startup

Show main window at startup, otherwise hides to tray icon.

check_for_updates_on_startup

Enable automatically checking for updates on startup, and display notification message in main window. This option is enabled by default.

Click on the notification message will bring up a menu, where user can click View Updates On GitHub to open Latest Releases page in web browser, or Dismiss the message.

Note, this option is checked only once per startup, and notification message will only be displayed if new updates is available. This option only checks for new updates info, it does not provide updates downloading or installing feature.

User can also manually check for updates any time by accessing Check for Updates option from Help menu in main window.

minimize_to_tray

Minimize to tray when user clicks X close button.

remember_position

Remember main window last position.

remember_size

Remember main window last size.

enable_high_dpi_scaling

Enable window dialog and overlay widget auto-scaling under high DPI screen resolution. This option requires restarting TinyPedal to take effect. This option is enabled by default.

High DPI scaling mode can be quickly toggled via Scale button on main window status bar.

On Windows, scaling is determined by percentage value set in Display > Scale and Layout setting. For example, 200% scale in windows setting will double the size of main window dialog and also every widget.

On Linux, DPI scaling may already be forced ON in some system, which this option may not have effect.

enable_auto_load_preset

Enable Auto load preset system to allow auto loading user-defined game-specific preset depends on active game (currently supports RF2 and LMU).

Auto loading preset is triggered when a new or different game is started and active. Auto loading will only trigger once per game change. A preset must be tagged as primary for specific game before it can be auto loaded. See Preset Management section for details.

This option is disabled by default.

enable_global_hotkey

Enable Global Hotkey support. This option can be toggled from Hotkey Tab in main window.

show_option_group_title

Show option group title in Config dialog.

show_confirmation_for_batch_toggle

Show confirmation dialog for enabling or disabling all widgets or modules. This option is enabled by default.

snap_distance

The distance (in pixels) at which the widget will snap to screen edges or other widgets. Default 10. Hold Ctrl to enable snapping.

snap_gap

The gap (in pixels) to leave between the widget and the snapped widget edges. Default 0.

grid_move_size

Set grid size for grid move, value in pixel. Default is 8 pixel. Minimum value is limited to 1.

minimum_update_interval

Set minimum refresh rate limit for widget and module in milliseconds. This option is used for preventing extremely low refresh rate that may cause performance issues in case user incorrectly sets update_interval and idle_update_interval values. Default value is 10, and should not be modified.

maximum_saving_attempts

Set maximum retry attempts for preset saving. Default value is 10. Minimum value is limited to 3 maximum attempts. Note, each attempt has a roughly 50ms delay. If all saving attempts failed, saving will be aborted, and old preset file will be restored to avoid preset file corruption.

position_x, position_y

Define main window position on screen in pixels. Those values will be auto updated and saved while remember_position option is enabled.

window_width, window_height

Define main window size on screen in pixels. Those values will be auto updated and saved while remember_size option is enabled.

window_color_theme

Set color theme for main window and dialog. Default theme is Dark. This option does not affect overlay widget.

Color theme can be quickly toggled via UI button on main window status bar.

Back to Top

Compatibility options can be accessed from Config menu in main window.

enable_bypass_window_manager

Set true to bypass window manager on Linux. This option does not affect windows system. This option is enabled by default on Linux. Note, while this option is enabled, OBS may not be able to capture overlay widgets in streaming on Linux.

enable_translucent_background

Set false to disable translucent background.

enable_window_position_correction

Set true to enable main application window position correction, which is used to correct window-off-screen issue with multi-screen. This option is enabled by default.

enable_x11_platform_plugin_override

Set Qt platform plugin type to X11 via environment variable on Linux. This option may help work around some issues with overlay dragging and position on Wayland. This option requires restarting TinyPedal to take effect. This option is enabled by default on Linux.

background_color_global

Sets global background color for all widgets.

Note, global background color will only be visible when enable_translucent_background option is disabled or translucent background is not supported. Some widgets with own background setting may override this option.

multimedia_plugin_on_windows

Set multimedia plugin for playing sound file on windows. Default is using WMF plugin.

Note, if the option is set on DirectShow, additional audio decoder software may be required to play certain sound formats, such as MP3. This option requires restarting TinyPedal to take effect.

Back to Top

User path options can be accessed from Config menu in main window.

User path dialog allows customization to global user path for storing different user data.

To change user path, double-clicking on edit box to open Select folder dialog; or manually editing path text. Folder will be automatically created if does not exist.

Click Apply or Save button to verify and apply new paths. Invalid path will not be applied.

User folders can be opened in File Manager via Open Folder sub-menu from Config menu.

Notes to relative and absolute path

User path that sets inside TinyPedal root folder will be automatically converted to relative path. Relative path is not considered global path, and does not share data between multiple copies of TinyPedal. This is done to retain portability and compatibility with old version.

To share user path across multiple copies of TinyPedal, user must set path to place outside TinyPedal APP root folder.

Default user path

• On windows, all user paths are set inside TinyPedal root folder as relative paths:

    brandlogo/
    deltabest/
    settings/
    trackmap/
    pacenotes/
    tracknotes/
    carsetups/
  

• On Linux, all user paths are set outside TinyPedal root folder as absolute paths:

    home/username/.config/TinyPedal/brandlogo/
    home/username/.config/TinyPedal/settings/
    home/username/.config/TinyPedal/pacenotes/
    home/username/.config/TinyPedal/tracknotes/
    home/username/.local/share/TinyPedal/deltabest/
    home/username/.local/share/TinyPedal/trackmap/
    home/username/.local/share/TinyPedal/carsetups/
  

Back to Top

Notification options can be accessed from Config menu in main window.

Note, notifications are displayed in main window. Click on any notification to quickly switch to corresponding tab. It's recommended to keep all notifications enabled.

notify_locked_preset

Show notification for loading locked preset.

notify_spectate_mode

Show notification while spectate mode is enabled.

notify_pace_notes_playback

Show notification while pace notes playback is enabled.

notify_global_hotkey

Show notification while global hotkey is enabled.

Back to Top

Overlay options can be accessed from Overlay menu in main window, or from tray icon menu.

fixed_position

Check whether widget is locked at startup. This setting can be toggled from tray icon menu.

auto_hide

Check whether auto hide is enabled. This setting can be toggled from tray icon menu.

enable_grid_move

Enable grid-snap effect while moving widget for easy alignment and repositioning.

vr_compatibility

Enable widget visibility as windows on taskbar in order to be used in VR via APPs such as OpenKneeboard. Non-VR user should not enable this option.

Note, you will still need a third party program (such as OpenKneeboard) to project overlay windows (widgets) into VR.

Back to Top

Units options can be accessed from Config menu in main window.

distance_unit

2 unit types are available: Meter, Feet.

fuel_unit

2 unit types are available: Liter, Gallon.

odometer_unit

3 unit types are available: Kilometer, Mile, Meter.

power_unit

3 unit types are available: Kilowatt, Horsepower, Metric Horsepower.

speed_unit

3 unit types are available: KPH, MPH, m/s.

temperature_unit

2 unit types are available: Celsius, Fahrenheit.

turbo_pressure_unit

3 unit types are available: bar, psi, kPa.

tyre_pressure_unit

3 unit types are available: kPa, psi, bar.

Back to Top

Global font override options can be accessed from Config menu in main window, which allow changing font setting globally for all widgets.

Font Name

Select a font name to replace font_name setting of all widgets. Default selection is no change, which no changes will be applied.

Font Size Addend

Set a value that will be added (or subtracted if negative) to font_size value of all widgets. Default is 0, which no changes will be applied.

Font Weight

Set font weight to replace font_weight setting of all widgets. Default selection is no change, which no changes will be applied.

Enable Auto Font Offset

Enable or disable auto font offset for all widgets. Default selection is no change, which no changes will be applied.

Font Offset Vertical Addend

Set a value that will be added (or subtracted if negative) to font_offset_vertical value of all widgets. Default is 0, which no changes will be applied.

Back to Top

Spectate mode can be accessed from Spectate tab in main window.

Click Enabled or Disabled button to toggle spectate mode on and off. Note, spectate mode can also be enabled by setting enable_player_index_override option to true in Telemetry API dialog.

While Spectate mode is enabled, double-click on a player name in the list to access telemetry data and overlay readings from selected player; alternatively, select a player name and click Spectate button. Current spectating player name is displayed on top of player name list. Player names are listed in alphabetical order.

Select Anonymous for unspecified player, which is equivalent to player index -1 in JSON file.

Click Refresh button to manually refresh player name list.

Back to Top

Pace notes playback control panel can be accessed from Pacenotes tab in main window.

Note, Notes Module must be enabled to allow pace notes playback.

Click Playback Enabled or Playback Disabled button to quickly enable or disable pace notes playback. Disabling this option does not affect Notes Module or Pace notes Widget.

Click Enable Playback While in Pit Lane check box to enable or disable pace notes playback while in pit lane. This option takes immediate effect when changed.

Enable Manually Select Pace Notes File check box to disable auto-file-name matching, and manually select a pace notes file that can be played on any track. By default, pace notes file is automatically loaded from pace_notes_path if a file that matches current track name is found. This option takes immediate effect when changed.

Sound file path sets path for loading pace notes sound files that matches name value (exclude file extension) from pace note column found in pace notes file. If no sound file found, sound won't be played. This option takes immediate effect when changed.

Sound format sets sound format for loading sound file, which should match sound file extension. This option only takes effect after clicked Apply button.

Global offset adds global position offset (in meters) to current vehicle position on track, which affects when next pace note line will be played. This option only takes effect after clicked Apply button.

Maximum duration sets maximum playback duration for each sound file, which can be used to limit sound file maximum playing duration. Default duration is 10 seconds. This option only takes effect after clicked Apply button.

Maximum Queue sets maximum number of sound files in playback queues. Default is 5 sound files. This option only takes effect after clicked Apply button.

Playback volume sets output volume for sound file. This option takes immediate effect when adjusted.

Back to Top

Hotkey control panel can be accessed from Hotkey tab in main window.

Note, hotkey bindings are non-exclusive in TinyPedal, which means they will not interfere with other programs. Hotkey history can be view in Show Log dialog from Help menu. Currently global hotkey feature is not supported on Linux.

Click Enabled or Disabled button to toggle global hotkey on and off. Note, global hotkey can also be enabled by setting enable_global_hotkey option to true in Application dialog.

To change key binding, click key button on right side of each hotkey option, then in Key Binding dialog, press a key or key combination to register new key binding.

Note, assign same key for multiple options will cause those options to be toggled at the same time. However, each option's toggle state is still handled individually.

To clear key binding, click Clear button from Key Binding dialog.

To clear all key bindings, click Clear All from Hotkey Tab.

Available options:

overlay_visibility

Show or hide overlay.

overlay_lock

Lock or unlock overlay.

vr_compatibility

Enable or disable VR Compatibility.

restart_api

Restart current Telemetry API.

select_next_api, select_previous_api

Select next or previous Telemetry API from available API list.

reload_preset

Reload current preset.

load_next_preset, load_previous_preset

Load next or previous preset relative to current preset (by preset name in ascending order).

spectate_mode

Enable or disable spectate mode.

spectate_next_driver, spectate_previous_driver

Spectate next or previous driver relative to current driver (by driver's overall standing).

pace_notes_playback

Enable or disable pace notes playback.

restart_application

Restart TinyPedal.

quit_application

Quit TinyPedal.

Back to Top

Tools can be accessed from main window menu.

Back to Top

Fuel calculator can be accessed from Tools menu in main window.

Fuel value and unit symbol depend on Fuel Unit setting from Units config dialog, L = liter, gal = gallon. Virtual energy unit is % = percentage. Note, after changed Fuel Unit setting, it is required to close and reopen Fuel calculator in order to update units info for calculation.

Calculation panel

On the left side is calculation panel, which handles fuel and virtual energy usage calculation and results display.

This panel also includes a vertical pit stop preview bar on the left, which visualizes pit stops as blue marks and stint laps as grey marks. Each pit stop mark shows a reference lap completion number. Total estimated number of race laps is displayed at bottom of the bar.

Note, when Energy consumption value is higher than zero, pit stops and stint laps from preview bar will be calculated based on energy usage. Stint lap mark may not be displayed if there is not enough space to draw.

Consumption history table

On the right side is consumption history table, which lists lap number, lap time, fuel consumption, virtual energy consumption, battery drain, battery regen, average tyre tread wear, tank capacity data from Consumption History data. Invalid lap time or consumption data is highlighted in red.

Click Load Live button to load or update consumption history from live session to history table and automatically fill in latest data to calculator.

Click Load File button to load data from specific consumption history file to history table and automatically fill in latest data to calculator.

Loaded data source and track and class name will be displayed on status bar.

Select one or more Time, Fuel, Energy, Tyre, Tank values from history table and click Add selected data button to send value to calculator.

Select multiple values from history table and click Add selected data button to calculate average reading of selected values and send to calculator.

Lap time

Set lap time in minutes : seconds : milliseconds format. Values are automatically carried over between spin boxes when exceeded minimum or maximum value range. This value can be retrieved from Time column.

Tank capacity

Set vehicle fuel tank capacity. This value can be retrieved from Tank column.

Fuel consumption

Set fuel consumption per lap. This value can be retrieved from Fuel column.

Energy consumption

Set virtual energy consumption per lap. This value can be retrieved from Energy column.

Fuel ratio

Show fuel ratio between fuel and virtual energy consumption.

Race minutes

Set race length in minutes for time-based race. Note, option is disabled if Race laps is set.

Race laps

Set race length in laps for lap-based race. Note, option is disabled if Race minutes is set.

Formation/Rolling

Set number of formation or rolling start laps.

Average pit seconds

Set average pit stop time in seconds.

Total race fuel, Total race energy

Show total required fuel or energy to finish race. First value is raw reading with decimal places, second value behind ≈ sign is rounded up integer reading.

End stint fuel, End stint energy

Show remaining fuel or energy at the end of stint.

Total pit stops

Show total number of pit stops required to finish race. First value is raw reading with decimal places, second value behind ≈ sign is rounded up integer reading.

Note, sometimes when Average pit seconds is set to longer duration, ceiling integer reading may be rounded up 2 units higher than raw reading, this is not an error. For example, it may show 5.978 ≈ 7 instead of 5.978 ≈ 6, this is because when calculating from 6 pit stops, due to less amount time spent in pit stop compare to 7, more fuel is required per pit stop which would exceed tank capacity, hence calculator adds 1 more pit stop.

One less pit stop

Show theoretical fuel or energy consumption in order to make one less pit stop.

Total laps, Total minutes

Show total laps and minutes can run based on Total race fuel or Total race energy value.

Maximum stint laps, Maximum stint minutes

Show maximum laps and minutes can run per stint based on Tank capacity value (or 100% capacity for virtual energy).

Starting fuel, Starting energy

Set amount fuel or energy to carry at the starting of race (first stint). This value affects Total race fuel (or energy) and Total pit stops calculation, and is used for calculating Average refueling or Average replenishing per pit stop. Maximum value cannot exceed Tank capacity for fuel (or 100% for energy). If value is set to 0 (default), Tank capacity value will be used as starting fuel (or 100% for starting energy) for Average refueling calculation.

Average refueling, Average replenishing

Show average refueling or replenishing per pit stop, and display warning color if value exceeds Tank capacity (fuel) or 100% (energy).

Starting tyre tread

Set average starting tyre tread (percent). For example, 100% for new tyres, and less for worn tyres.

Tread wear per lap

Set average tyre tread wear (percent) per lap. This value can be retrieved from Tyre column.

Tread wear per stint

Show total average tyre tread wear (percent) per stint. Note, while virtual energy is available, this value will be calculated based on the least maximum stint laps between fuel and virtual energy.

Lifespan laps, Lifespan minutes

Show total tyre lifespan in laps and minutes based on tread wear per lap and lap time.

Lifespan stints

Show estimated tyre lifespan in number of stints. Note, while virtual energy is available, this value will be calculated based on the least maximum stint laps between fuel and virtual energy.

Back to Top

Driver stats viewer can be accessed from Tools menu in main window.

Driver stats viewer is used for viewing Driver Stats. Note, the viewer only allows limited reset or removal, stat value cannot be edited by design. Any changes will take immediate effect after confirmation, changes cannot be undone.

Driver stats are grouped under specific track name, which can be switched from track name selector on the top.

To sort by specific stat, click on corresponding column name. Stats are sorted by personal best lap time by default.

To view corresponding track map, click View Map button.

To reload stats data, click Reload button.

To delete all stats from a specific track, click Delete button.

To remove all stats from a specific vehicle, right-click on vehicle name and select Remove Vehicle.

To reset personal best lap time to default, right-click on personal best lap time and select Reset Lap Time.

Vehicle column is vehicle classification info, which is determined by vehicle_classification option in Stats Module.

PB column is personal best lap time. This value can be reset via right-click menu.

Qualifying column is personal best lap time from qualifying session only. This value can be reset via right-click menu.

Race column is personal best lap time from race session only. This value can be reset via right-click menu.

Km column is total driven distance in kilometers. Note, odometer_unit setting from Units affects how this column is displayed.

Hours column is total time spent in driving (only counts when vehicle speed higher than 1 m/s).

Liter column is total fuel consumed. Note, fuel_unit setting from Units affects how this column is displayed.

Valid column is total valid laps completed.

Invalid column is total invalid laps completed.

Penalties column is total penalties received in race. Non-race penalties are not recorded.

Finishes column is total races completed.

Wins column is total races won.

Podiums column is total podiums from race.

Note, race completion and final standings stats are retrieved at the moment when local driver crossed finish line on final lap, it does not concern any post-race penalties or finish state from team mate.

Back to Top

Vehicle brand editor can be accessed from Tools menu in main window.

Vehicle brand editor is used for editing Brands Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

For brand logo image preparation, see Brand Logo section.

Vehicle name is full vehicle name that must match in-game vehicle name.

Brand name is custom brand name.

Note, brands data are automatically imported for LMU while driving, there is no need to manually import them. However it is required to manually import for RF2.

To import vehicle brand data from Rest API, click Import from menu, and select either RF2 Rest API or LMU Rest API. Note, game updates may introduce new vehicles, it is recommended to re-import after each game update to keep brand info updated.

Note, there are currently two sources for importing from LMU Rest API:

• Primary: allows to import brands from both original and custom vehicle skins.
• Alternative: may allow to import some brands that are missing from Primary source. This is normally not required.

Important notes

Game must be running in order to import from Rest API. Newly imported data will be appended on top of existing data, existing data will not be changed.

If importing fails while game is running, check if URL Port option in RestAPI module that matches WebUI port value that sets in LMU (UserData\player\Settings.JSON) or RF2 (UserData\player\player.JSON) setting file. See Telemetry API section for details.

Alternatively, to import vehicle brand data from vehicle JSON file, click Import from menu, and select JSON file.

How to manually export vehicle brand data from RF2 Rest API:
1. Start RF2, then open following link in web browser:
localhost:5397/rest/race/car
2. Click "Save" button which saves vehicle data to JSON file.

How to manually export vehicle brand data from LMU Rest API:
1. Start LMU, then open following link in web browser:
localhost:6397/rest/race/car
localhost:6397/rest/sessions/getAllVehicles
2. Click "Save" button which saves vehicle data to JSON file.

Note: importing feature is experimental. Maximum acceptable JSON file size is limited to "5MB".

To add new brand name, click Add button. Note, the editor can auto-detect and fill-in missing vehicle names found from current active session, existing data will not be changed.

To sort brand name in orders, click Sort button.

To remove a brand name, select a vehicle name and click Delete button.

To batch replace name, click Replace button.

To reset all brands setting to default, click Reset button; or manually delete brands.json preset.

Back to Top

Vehicle class editor can be accessed from Tools menu in main window.

Vehicle class editor is used for editing Classes Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

Class name column is full vehicle class name that must match in-game vehicle.

Alias name column is alternative name that replaces class name for displaying.

Color column is class color style (HEX code). Double-click on color to open color dialog.

To add new class, click Add button. Note, the editor can auto-detect and fill-in missing vehicle classes found from current active session, existing data will not be changed.

To sort class name in orders, click Sort button.

To remove class, select one or more rows and click Delete.

To reset all classes setting to default, click Reset button; or manually delete classes.json preset.

Back to Top

Brake editor can be accessed from Tools menu in main window.

Brake editor is used for editing Brakes Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

Brake name column is full vehicle class name plus brake name that must match in-game vehicle. Brand name may also be added if vehicle brand data is available.

Failure (mm) column is millimeter thickness threshold at brake failure and affects brake wear calculation. See Brake Wear widget for details.

Heatmap name column is heatmap style name selector. Click on heatmap selector to open drop down list and select a heatmap style.

To add new brake, click Add button. Note, the editor can auto-detect and fill-in missing brakes found from running vehicles in current active session, existing data will not be changed.

To sort brake name in orders, click Sort button.

To remove brake, select one or more rows and click Delete.

To reset all brakes setting to default, click Reset button; or manually delete brakes.json preset.

Back to Top

Track info editor can be accessed from Tools menu in main window.

Track info editor is used for editing Tracks Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

Track name column is full track name that must match in-game track.

Pit entry (m) column is pit entry position (in meters) relative to track length. This value is automatically recorded or updated by Mapping Module.

Pit exit (m) column is pit exit position (in meters) relative to track length. This value is automatically recorded or updated by Mapping Module.

Pit speed (m/s) column is pit lane speed limit (in meters per second). This value is automatically recorded or updated by Mapping Module. Note, vehicle pit limiter must be activated while in pit lane to allow recording speed limit.

Speed trap (m) column is speed trap position (in meters) relative to track length. To manually set speed trap position at your current on-track position, Right-Click on corresponding track's speed trap column and select Set from Telemetry.

Sunrise column is sunrise hour in Hour:Minute format. This value has to be manually defined.

Sunset column is sunset hour in Hour:Minute format. This value has to be manually defined.

To add new track, click Add button. Note, the editor can auto-detect and fill-in missing track found from current active session, existing data will not be changed.

To sort track name in orders, click Sort button.

To remove track, select one or more rows and click Delete.

To reset all tracks setting to default, click Reset button; or manually delete tracks.json preset.

Back to Top

Tyre compound editor can be accessed from Tools menu in main window.

Tyre compound editor is used for editing Compounds Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

Compound name column is full vehicle class name plus full tyre compound name that must match in-game vehicle.

Symbol column is alternative symbol character that replaces full tyre compound name for displaying.

Color column is custom compound color for each different compound type.

Heatmap name column is heatmap style name selector. Click on heatmap selector to open drop down list and select a heatmap style.

To add new tyre compound, click Add button. Note, the editor can auto-detect and fill-in missing tyre compounds found from running vehicles in current active session, existing data will not be changed.

To sort tyre compound name in orders, click Sort button.

To remove tyre compound, select one or more rows and click Delete.

To batch replace name, click Replace button.

To reset all tyre compounds setting to default, click Reset button; or manually delete compounds.json preset.

Back to Top

Heatmap editor can be accessed from Tools menu in main window.

Heatmap editor is used for editing Heatmap Preset. Note, any changes will only be saved and take effect after clicking Apply or Save Button.

Each row represents a target temperature and corresponding color. First column is temperature degree value in Celsius, and up to one decimal place is kept. Second column is corresponding color (HEX code). Double-click on color to open color dialog.

To add temperature, click Add button.

To sort temperature list in orders, click Sort button.

To batch offset temperature values, select one or more temperature from temperature column, then click Offset button. Click Scale Mode check box to scale temperature values. Note, offset option will be reset to 0 each time after applying. Last applied offset value is displayed on top of dialog.

To remove a temperature, select one or more temperature and click Remove button.

To select a different heatmap preset, click drop-down list at top, and select a preset name. Note: by selecting a different preset, any changes to previously selected heatmap will be saved in cache, and only be saved to file after clicking Apply or Save Button.

To create a new heatmap preset, click New button. Note: only alphabetic characters, numbers, underscores are accepted in preset name, and renaming preset is not supported.

To duplicate a heatmap preset, click Copy button.

To delete selected heatmap preset, click Delete button. Note: built-in presets cannot be deleted.

To reset selected heatmap preset, click Reset button. Note: only built-in presets can be reset.

To assign a heatmap preset to specific widget, select corresponding heatmap name in widget config dialog.

In case of errors found in heatmap.json preset, the APP will automatically fall back to built-in default heatmap preset.

To restore all heatmap settings back to default, just delete heatmap.json preset.

Back to Top

Track map viewer can be accessed from Tools menu in main window.

To load a track map, click Load Map button. Map file name will be displayed alongside if file is successfully loaded. Note, only track map files (.svg extension) that generated from TinyPedal Mapping Module are supported.

To customize map display, click Config button. Note, some display options may require reload track map file to be updated.

To zoom map in or out, scroll mouse wheel in map display area; or adjust Zoom spin box value.

To move current position on map, use position slider at bottom of map display; or adjust Position spin box value.

To increase or decrease current nodes selection, adjust Nodes spin box value. Note, minimum nodes selection is limited to 3 nodes, maximum nodes selection cannot exceed total map nodes.

To toggle on or off specific map display, Right-Click on map display area to open context menu, includes:

• Map info - Show map length, total map nodes.
• Position info - Show current node position and global XYZ coordinates (Z is elevation).
• Curve info - Show curve section length, grade, radius, angle, curvature.
• Slope info - Show slope grade, percent, angle, height delta.
• Center mark - Mark current node position.
• Distance circle - Show reference distance circles.
• Osculating circle - Show osculating circle that calculated from curve section.
• Curve section - Show curve section from current nodes selection.
• Marked coordinates - Show marked coordinates if available.
• Highlighted coordinates - Show highlighted coordinates if available.
• Dark background - Show dark background color.

inner_margin

Set inner margin for info display.

position_increment_step

Set single increment step for position slider and spin box. Default is 5 meters.

curve_grade_*

Set corner curve classification by radius (meters). Set value to -1 to exclude from grade selection.

length_grade_*

Set corner length classification by meters.

slope_grade_*

Set road slope classification by slope percent.

Back to Top

Track notes editor allows to create and edit track or pace notes, which can be accessed from Tools menu in main window.

Note, by default the editor starts in Pace Notes edit mode as displayed in status bar.

Important notes: The editor does not provide undo function, it is recommended to save file before doing heavy modification.

The editor consists of two panel views:

• Left panel is the Track Map Viewer, which can be used to visualize track map and providing analytic info for assisting notes creation. See Track Map Viewer section for details.
• Right panel is the track and pace notes editor, which allows to create, open, and save track or pace notes file.

The table view consists of multiple columns:

• distance column defines track position (in meters) of a note line.
• pace note column (in Pace Notes edit mode) defines pace note name that is used to match pace note sound file name. Because windows system excludes some special characters from used in file name, the pace note column will automatically strip off invalid characters. Note, DO NOT write file extension (format) in pace note column. File extension should be set in Pace Notes control panel tab from main window.
• track note column (in Track Notes edit mode) defines track corner name or section name or any thing user wish to note.
• comment column defines optional extra info for pace note or track note column for user. Note, a comment can be broken into multiple lines by adding \n to any part of the comment.

To create or open pace notes, click File and select New Pace Notes or Open Pace Notes.

To create or open track notes, click File and select New Track Notes or Open Track Notes.

To save notes file, click Save. Note, notes file name should exactly match with track name from track map file name for auto notes loading function to work. The editor will try to retrieve track name automatically in an active session, or from an opened track map in Track Map Viewer.

To save notes file to other formats for used in other games, select a file format name from save type in save dialog, such as GPL Pace Notes (*.ini) which saves pace notes in GPL pace notes file format. Note, only TinyPedal notes file formats are supported for used in TinyPedal.

To hide map viewer, click Hide Map. To show map viewer, click Show Map.

To edit metadata info, click Info. Metadata info provides optional info to notes:

• Title of notes.
• Author of notes.
• Date when notes created or modified.
• Description about notes.

To set distance (position) value, first select one cell from distance column, then click Set Pos and click either From Map or From Telemetry. Note, From Map retrieves distance data from track map that opened in Track Map Viewer; From Telemetry retrieves distance data from current on-track vehicle position.

To add a note line, click Add, which adds a new note line at the end of notes table.

To insert a note line, first select a note line from notes table, then click Insert to insert a new note line above selected note line. To insert below selected note line, right-click on selected note line and click Insert Row Below from context menu.

To sort notes table, click Sort.

To delete notes, first select one or multiple note lines from notes table, then click Delete.

To replace words, click Replace and select a column, then use Find and Replace to find and replace words.

To batch offset distance (position) values, first select one or multiple note lines from distance column, then click Offset button. Click Scale Mode check box to scale distance values. Note, offset option will be reset to 0 each time after applying. Last applied offset value is displayed on top of dialog.

To highlight a distance value on Track Map Viewer, right-click on a note line and click Highlight on Map.

Back to Top

Tyre strategy planner allows to create and edit tyre strategy plan, which can be accessed from Tools menu in main window.

Note, all setting and data are saved per file as Tyre strategy format.

Important notes: The planner does not provide undo function, it is recommended to save file before doing heavy modification.

Tyre rule setting (top panel):

• Maximum Tyres: set number of available tyres allowed for race.
• Change Time: set tyre change time during pit stop for corresponding number of tyres. Default values match LMU tyre change rule.
• Restrict Allocation: enable restricted tyre allocation, where an already used tyre cannot be allocated on a different wheel in later stint, which matches LMU tyre allocation rule.

Tyre set & stock list (left panel):

• Tyre compound selector: select a predefined tyre compound to be added or configured. Tyre name that starts with Q is the tyre reused from qualifying session.
• Add: add selected tyre compound to tyre stock list. Each newly added tyre compound will be attached with a unique number and stints label that indicates number of running stints for each tyre.
• Config: set tyre compound setting for currently selected tyre compound in tyre compound selector. See Tyre compound setting below for details.
• Sort By: sort tyre stock list by either Compound Type or Number of Stints.
• Remove: remove selected tyre from tyre stock list. This will also remove corresponding tyre from tyre plan table.
• Clear All: remove all tyres from tyre stock list and tyre plan table.

Tyre compound setting (Config button):

• Enable Limited Stock: enable limited stock for this tyre compound, which counts towards Maximum Tyres from tyre rule setting. This option is enabled for all dry compound tyres, and disabled for all wet compound tyres by default, which matches LMU tyre rule.
• Starting Tread: set starting tyre tread (percent). Set 100 for fresh new tyre, and less for worn tyre such as reused from qualifying session.
• Wear Per Stint: set average tyre tread wear (percent) per stint.

Tyre plan table (right panel):

• Duplicate Row: duplicate selected row and associated tyres.
• New Row: add a new row at the bottom of table.
• Insert Below: insert a new row below selected row.
• Insert Above: insert a new row above selected row.
• Delete Row: delete selected rows.

File menu:

• New File: create new tyre strategy file.
• Open File: open a tyre strategy file, only support Tyre strategy format.
• Save As: save current tyre strategy as Tyre strategy format to file.
• Export As: export current tyre strategy as spreadsheet (CSV) format to file.

Table rows:

• Each row represents a stint with corresponding tyre usage info.

Table columns:

• Front Left: tyre that installed on front left wheel.
• Front Right: tyre that installed on front right wheel.
• Rear Left: tyre that installed on rear left wheel.
• Rear Right: tyre that installed on rear right wheel.
• Change: amount tyre change time during pit stop.

Status bar

• Stock: shows total number of tyres in tyre stock list, and maximum available tyres allowed for race. A invalid text is displayed if exceeded maximum available tyres. Note, tyres that without limited stock are not counted toward total stock, such as wet tyres (from default setting).
• Used: shows total number of tyres used in tyre plan table, including tyres that without limited stock.
• Stints: number of stints that corresponds to rows in tyre plan table.
• Pits: number of pit stops that corresponds to rows in tyre plan table.
• Changes: number of pit stops with tyre changes.
• Time: sum of tyre change time from all stints.

Usage

• To add tyre from list to table, select a tyre name in tyre stock list, then hold and drag it into tyre plan table. You can also drag & copy tyre in the table.
• To select multiple tyres, hold Ctrl or Shift while clicking on tyres. Note, drag is disabled while selected multiple tyres.
• Right-click on tyre list or table to open context menu for quick-access options.
• To highlight new tyres (first time installed in race session) in table, enabled Highlight New Tyre check box at top panel.
• To delete tyres from list or table, select one or more tyres, then right-click and select Removed Selected. A confirmation dialog will be displayed before deletion.

Back to Top

Modules provide important data that updated in real-time for other widgets. Widgets may stop updating or receiving readings if corresponding modules were turned off. Each module can be configured by accessing Config button from Module tab in main window.

Back to Top

This module provides deltabest and timing data.

module_delta

Enable delta module.

minimum_delta_distance

Set minimum recording distance (in meters) between each lap time sample. Default value is 5 meters. Lower value may result more samples recorded and bigger file size; higher value may result less samples recorded and inaccuracy. Recommended value range in 5 to 10 meters.

delta_smoothing_samples

Set number of samples for reducing data fluctuation. Higher value results more smoothness, but may lose accuracy. Default is 30 samples. Set to 1 to disable smoothing.

laptime_pace_samples

Set number of samples for average laptime pace calculation. Default is 6 samples. Set 1 to disable averaging. Note, initial laptime pace is always based on player's all time personal best laptime if available. If a new laptime is faster than current laptime pace, it will replace current laptime pace without calculating average. Invalid lap, pit-in/out laps are always excluded from laptime pace calculation.

laptime_pace_margin

Set additional margin for laptime pace that cannot exceed the sum of previous laptime pace and margin. This option is used to minimize the impact of unusually slow laptime. Default value is 5 seconds. Minimum value is limited to 0.1.

Back to Top

This module provides vehicle g force, downforce, braking rate data.

module_force

Enable force module.

gravitational_acceleration

Set gravitational acceleration value on earth.

maximum_g_force_reset_delay

Set time delay in seconds for resetting maximum g force reading.

maximum_average_g_force_samples

Set amount samples for calculating maximum average g force. Minimum value is limited to 3.

maximum_average_g_force_difference

Set maximum average g force difference threshold which compares with the standard deviation calculated from maximum average g force samples. Default is 0.2 g.

maximum_average_g_force_reset_delay

Set time delay in seconds for resetting maximum average g force. Default is 30 seconds.

maximum_braking_rate_reset_delay

Set time delay in seconds for resetting maximum braking rate. Default is 60 seconds.

Back to Top

This module provides vehicle fuel and virtual energy usage data.

module_fuel

Enable fuel module.

minimum_delta_distance

Set minimum recording distance (in meters) between each fuel usage sample. Default value is 5 meters. Lower value may result more samples recorded and bigger file size; higher value may result less samples recorded and inaccuracy. Recommended value range in 5 to 10 meters.

Back to Top

This module provides vehicle battery usage and electric motor data.

module_hybrid

Enable hybrid module.

minimum_delta_distance

Set minimum recording distance (in meters) between each battery charge usage sample. Default value is 5 meters. Lower value may result more samples recorded and bigger file size; higher value may result less samples recorded and inaccuracy. Recommended value range in 5 to 10 meters.

Back to Top

This module records and processes track map data.

module_mapping

Enable mapping module.

Back to Top

This module processes track and pace notes data.

module_notes

Enable notes module.

Back to Top

This module provides vehicle relative and standings data.

module_relative

Enable relative module.

Back to Top

This module provides sectors timing data.

module_sectors

Enable sectors module.

Back to Top

This module records driver stats data.

Important notes: Driver stats will not be recorded while:

• enable_player_index_override or enable_active_state_override option is enabled in Telemetry API.
• Single instance mode is disabled via Command Line Arguments.

Stats are only saved when driver returned to garage.

module_stats

Enable stats module.

vehicle_classification

Set one of the three vehicle classifications where stats will be saved.

Class - Brand saves corresponding stats under class and brand name. Make sure to use Vehicle Brand Editor to import brand name. If brand name does not exist, only class name will be used instead.

Class saves corresponding stats under class name only.

Vehicle saves corresponding stats under vehicle name only. Saving stats under vehicle name is not recommended, because each single vehicle in RF2 or LMU uses unique vehicle name, which will result multiple records of the same vehicle.

enable_podium_by_class

Enable to count race finish position by class instead of overall position.

Back to Top

This module provides lap and stint history data.

module_stint

Enable stint module.

minimum_stint_threshold_minutes

Set the minimum stint time threshold in minutes for concluding current stint. This only affects ESC.

minimum_pitstop_threshold_seconds

Set the minimum pit stop time threshold in seconds for concluding current stint. Default is 3 seconds.

This option is useful for detecting pit stop that does not refuel or change tyres. It also allows to detect pit stop while spectating other player with Spectate Mode.

minimum_tyre_temperature_threshold

Set the minimum tyre carcass temperature (Celsius) threshold for calculating lap time delta and consistency. Default is 55 degrees.

This option helps to exclude slow lap time due to cold tyres from calculation.

Back to Top

This module provides additional processed vehicles data.

module_vehicles

Enable vehicles module.

lap_difference_ahead_threshold

Lap difference (percentage) threshold for tagging opponents as ahead. Default is 0.9 lap.

lap_difference_behind_threshold

Lap difference (percentage) threshold for tagging opponents as behind. Default is 0.9 lap.

finish_time_difference_threshold

Set estimated finish time difference threshold between race leader and local player for determine the shortest race length (either in laps or time). Default threshold is 200 seconds (roughly a lap at LeMans).

• When finish time difference is lower than threshold, shortest race length is determined by player's lap time pace. This is useful for compensating strategy difference within the same leading class, and potentially catching up with leader.
• When finish time difference is higher than threshold, shortest race length is determined by leader's lap time pace. This is useful for much slower classes to align their finish time towards the leading class.

This option is used for adaptive race length and fuel calculation for Lap or Laps & Time finish criteria based race, which automatically determines the shortest race length and calculates fuel usage accordingly for increased accuracy and efficiency. This option only affects Lap or Laps & Time based race. Time based race is not affected by this option.

Unlike Time based race, finish criteria in Laps & Time based race is determined by both remaining laps and remaining time (whichever reaches zero first), such as seen from Qatar 1812km event.

Back to Top

This module provides wheel radius, slip ratio, tyre wear, brake wear data.

minimum_axle_rotation

Set minimum axle rotation (radians per second) for calculating wheel radius and differential locking percent. Default value is 4.

maximum_rotation_difference_front, maximum_rotation_difference_rear

Set maximum rotation difference between left or right wheel rotation and same axle rotation for limiting wheel radius calculation. Default value is 0.002 (0.2%). Setting higher difference value may result inaccurate wheel radius reading.

wheel_lock_threshold

Set percentage threshold for counting wheel lock duration under braking. 0.3 means 30% of tyre slip ratio.

cornering_radius_sampling_interval

Set position sampling interval for cornering radius calculation. Value range in 5 to 100. Default sampling interval is 10, which is roughly 200ms interval between each recorded position. Higher value may result inaccuracy. Note, this option does not affect position recording interval.

minimum_delta_distance

Set minimum recording distance (in meters) between each tyre wear sample. Default value is 5 meters. Lower value may result more samples recorded and bigger file size; higher value may result less samples recorded and inaccuracy. Recommended value range in 5 to 10 meters.

enable_suspension_measurement_while_offroad

Enable suspension travel measurement while vehicle is offroad. This option should be disabled for road racing for more accurate suspension measurement. This option is disabled by default.

average_suspension_position_samples

Set amount samples for calculating average suspension position, which helps to filter out unusual data. Default is 20. Minimum value is limited to 3.

average_suspension_position_margin

Set additional margin that cannot exceed the sum of previous average suspension position and margin. This option is used to minimize the impact of unusual data. Default value is 1 millimeter. Minimum value is limited to 0.1.

wheel_lift_off_threshold

Set millimeter threshold of tyre vertical deflection for detecting lifted wheels. Suspension travel is not calculated from wheel that is lifted off the ground (as below the threshold). Default threshold is 1 millimeter. Set to -1 to always calculate suspension travel even if wheel is lifted off.

Back to Top

Each widget can be configured by accessing Config button from Widget tab in main window.

Widget context menu can be accessed by Right-Click on widget, which provides additional options:

• Center horizontally: align widget to the center of active screen horizontally.
• Center vertically: align widget to the center of active screen vertically.

Back to Top

This widget displays battery usage info.

Note, there are some electric vehicles in RF2 that are not based on the new electric motor and battery charge system, which there is no battery usage info available.

show_battery_charge

Show percentage available battery charge.

show_battery_drain

Show percentage battery charge drained in current lap.

show_battery_regen

Show percentage battery charge regenerated in current lap.

show_estimated_net_change

Show estimated battery charge net change from current lap. Positive value indicates net gain (regen higher than drain); negative indicates net loss (drain higher than regen).

Total net change reading is more accurate for vehicles that constantly consume battery charge, such as FE or Hypercar class. It is less useful for vehicles that only utilize electric motor for a short duration, such as Push to pass.

Note, at least one full lap (excludes pit-out or first lap) is required to generate estimated net change data.

show_activation_timer

Show electric boost motor activation timer.

high_battery_threshold, low_battery_threshold

Set percentage threshold for displaying low or high battery charge warning indicator. Default high threshold is 95 percent (default color purple), low threshold is 10 percent (default color red).

show_battery_charge_warning_flash

Show battery charge warning flash effect when battery charge decreased below low_battery_threshold or increased above high_battery_threshold.

number_of_warning_flashes

Set number of warning flashes that will be played for a limited number of times. Default is 10 flashes. Minimum value is limited to 3.

warning_flash_highlight_duration

Set color highlight duration for each warning flash. Default is 0.4 seconds. Minimum value is limited to 0.2.

warning_flash_interval

Set minimum time interval between each warning flash. Default is 0.4 seconds. Minimum value is limited to 0.2.

freeze_duration

Set freeze duration (seconds) for displaying previous lap total drained/regenerated battery charge after crossing finish line. Value range in 0 to 30 seconds. Default is 10 seconds.

Back to Top

This widget displays brake bias info.

show_front_and_rear

Show both front and rear bias. Default is false.

show_percentage_sign

Set true to show percentage sign for brake bias value.

show_baseline_bias_delta

Show delta between current and baseline brake bias, which can be useful for keeping track of brake bias changes easier during a long race. Baseline brake bias is automatically set (and reset) while vehicle is stationary in pit lane or stationary during formation lap.

show_brake_migration

Show real-time brake migration change, as commonly seen in LMH and LMDh classes.

Note, brake migration is calculated based on brake input and brake pressure telemetry data, and is affected by pedal force setting from car setup and electric braking allocation of specific vehicle.

To get accurate brake migration reading, it is necessary for brake pedal to reach fully pressed state for at least once while entering track to recalibrate brake pressure scaling for brake migration calculation. It is normally not required to do manually, as game's auto-hold brake assist is on by default. However if auto-hold brake assist is off, or the APP was reloaded while player was already on track, then it is required to do a full braking for at least once to get accurate brake migration reading.

electric_braking_allocation

Set allocation for calculating brake migration under different electric braking allocation from specific vehicle. Note, vehicle that has not electric braking, or has disabled regeneration, is not affected by this option. Incorrect allocation value will result wrong brake migration reading from vehicle that has electric braking activated.

Set value to -1 to enable auto-detection, which automatically checks whether electric braking is activated on either axles while braking, and sets allocation accordingly. This is enabled by default. Note, it may take a few brakes to detect correct allocation.

Set value to 0 to manual override and use front allocation, which is commonly seen in LMH class.

Set value to 1 to manual override and use rear allocation, which is commonly seen in LMDh class.

Back to Top

This widget displays brake performance info.

show_transient_maximum_braking_rate

Show transient maximum braking rate (g) from last braking input, and resets after 3 seconds.

show_maximum_braking_rate

Show maximum braking rate (g), and resets after a set period of time that defined by maximum_braking_rate_reset_delay value in Force Module.

show_delta_braking_rate

Show maximum braking rate difference (g) against transient maximum braking rate, and resets on the next braking.

show_delta_braking_rate_in_percentage

Show maximum braking rate difference (g) in percentage (%) instead.

show_front_wheel_lock_duration, show_rear_wheel_lock_duration

Show maximum front and rear wheel lock duration (seconds) per lap under braking. Duration increases when tyre slip ratio has exceeded wheel_lock_threshold value that set in Wheels Module, and resets on first braking input of a new lap.

Back to Top

This widget displays visualized percentage brake pressure info.

show_brake_input

Show raw brake input on each brake. This option can be useful to check amount difference between brake input and applied brake pressure.

Back to Top

This widget displays brake temperature info.

Note, if temperature drops below -100 degrees Celsius, temperature readings will be replaced by unavailable sign as -. This usually indicates brake failure, or brake is not available on one of the wheels.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

enable_heatmap_auto_matching

Enable automatically heatmap style matching for specific brakes defined in brakes.json preset. This option applies matching heatmap style to front and rear brakes separately.

heatmap_name

Set heatmap preset name that is defined in heatmap.json preset. Note, this option has no effect while enable_heatmap_auto_matching is enabled.

swap_style

Swap heatmap color between font and background color.

show_degree_sign

Set true to show degree sign for each temperature value.

leading_zero

Set amount leading zeros for each temperature value. Default is 2. Minimum value is limited to 1.

show_average

Show average brake temperature calculated from most recent braking period. The braking period is defined by average_sampling_duration and off_brake_duration options.

average_sampling_duration

Set duration (seconds) for calculating average brake temperature from most recent braking period. Default is 10 seconds. Maximum duration is limited to 600 seconds.

off_brake_duration

Set duration (seconds) for continuously updating average brake temperature for a short period after fully released brakes. Default is 1 seconds.

Back to Top

This widget displays brake wear info.

Important notes: Brake wear data is currently only available on LMU. RF2 currently doesn't provide brake wear data. Depends on vehicle, brake may or may not have noticeable wear.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_thickness

Show brake thickness (millimeter) instead of percentage, which also affects wear difference readings.

Note, brake maximum thickness (for percentage wear calculation) is retrieved at the moment when car leaves garage or has brake repaired or changed. Reloading a preset or restarting APP in the middle of a running stint could result wrong maximum thickness and percentage wear calculation, which should be avoided.

Notes to brake failure thickness:

Brake failure thickness is millimeter thickness threshold at brake failure, which affects brake wear calculation accuracy, and can be customized for specific vehicle class in Brake Editor.

For example, if brake thickness is 40mm, and failure thickness is 25mm, then effective thickness is 40 - 25 = 15mm. And brake fails upon reaching 25mm thickness. Note, each installed brake may have a random failure thickness variation of ±0.1mm.

Since brake failure thickness threshold data is not available from game API, it requires testing to find out, and may vary from vehicle to vehicle. Front brake failure thickness threshold can be different from rear brake. Thickness threshold value should not exceed brake maximum thickness, otherwise brake wear readings will not be displayed correctly.

Note, failure thickness values are automatically saved to brakes.json preset when brakes failed, and most recent brake failures are logged and can be found in Show Log dialog from Help menu.

Tips for testing failure thickness:

Before start, make sure vehicle brand data is imported via Vehicle Brand Editor. This is necessary to save brake failure thickness settings per vehicle brand.

First, set all brake duct settings to closed in car setup, then keeps brakes on while driving at around 100kph speed until brakes failed (use brake bias to control front and rear wear rate), and failure thickness value will be automatically saved for this vehicle. Be aware that testing may take a very long time for some vehicles.

show_remaining

Show total remaining brake in percentage that changes color according to wear. A FAIL text will be shown on failed brakes.

show_wear_difference

Show estimated brake wear difference per lap (at least one valid lap is required).

show_live_wear_difference

Show current lap brake wear difference.

show_lifespan_laps

Show estimated brake lifespan in laps.

show_lifespan_minutes

Show estimated brake lifespan in minutes.

warning_threshold_remaining

Set warning threshold for total remaining brake in percentage. Default is 30 percent.

warning_threshold_wear

Set warning threshold for total amount brake wear of last lap in percentage. Default is 1 percent.

warning_threshold_laps

Set warning threshold for estimated brake lifespan in laps. Default is 5 laps.

warning_threshold_minutes

Set warning threshold for estimated brake lifespan in minutes. Default is 5 laps.

Back to Top

This widget displays compass, elevation, odometer info.

show_compass

Show compass directions with three-figure bearings that matches game's cardinal directions.

show_elevation

Show elevation difference in game's coordinate system.

show_odometer

Show odometer that displays total driven distance of local player.

odometer_maximum_digits

Set maximum number of display digits.

show_distance_into_lap

Show distance into current lap.

show_cornering_radius

Show cornering radius calculated in real-time.

Back to Top

This widget displays visualized vehicle damage info.

Wheel (suspension) damage levels

1. No damage to suspension or wheel (default color: green).
2. Light suspension damage (default damage range: 2% - 15%, default color: yellow).
3. Medium suspension damage (default damage range: 15% - 40%, default color: orange).
4. Heavy suspension damage (default damage range: 40% - 80%, default color: purple).
5. Totaled suspension (default damage range: 80% - 100%, default color: blue).
6. Wheel detached (default color: black).

Note, body aero integrity and suspension damage display is only available for LMU.

display_margin

Set display margin in pixels.

inner_gap

Set body parts inner gap in pixels.

part_width

Set body parts width in pixels. Minimum value is limited to 1.

parts_width_ratio

Set width ratio between side and center body parts. Value range in 0.1 to 1.0.

parts_maximum_width, parts_maximum_height

Set maximum body parts width, height in pixels. Minimum value is limited to 4.

wheel_width, wheel_height

Set wheel width, height in pixels. Minimum value is limited to 1.

show_background

Show widget background.

suspension_damage_*_threshold

Set suspension damage level percentage threshold for suspension damage color indication, which better reflects severity of suspension damage that would affect handling.

show_detached_warning_flash

Show warning flash for detached parts, such as wings and wheels.

warning_flash_highlight_duration

Set color highlight duration for each warning flash. Default is 0.5 seconds. Minimum value is limited to 0.2.

warning_flash_interval

Set minimum time interval between each warning flash. Default is 0.5 seconds. Minimum value is limited to 0.2.

show_last_impact_cone

Show cone indicator towards last known impact (collision) position.

last_impact_cone_angle

Set cone angle (size) in degree. Value range in 2 to 90. Default is 15.

last_impact_cone_duration

Set cone indicator display duration (seconds) for last known impact. Default is 15 seconds.

show_integrity_reading

Show vehicle bodywork integrity reading in percentage. Note, bodywork damage may not necessarily affect aero or handling.

show_aero_integrity_if_available

Show vehicle body aero integrity reading in percentage if available, which better reflects severity of bodywork damage that would affect performance.

show_inverted_integrity

Invert integrity reading.

Back to Top

This widget displays vehicle damage stats info.

show_integrity_prefix

Show prefix for each integrity reading.

show_aero_integrity

Show body aero integrity reading.

show_body_integrity

Show bodywork integrity reading.

show_suspension_integrity

Show suspension integrity reading, measured from the wheel with the lowest suspension integrity.

show_tyre_integrity

Show tyre integrity reading, measured from the wheel with the lowest tread depth.

low_*_integrity_threshold

Set low integrity threshold for displaying warning indication.

Back to Top

This widget displays deltabest info.

layout

2 layouts are available: 0 = delta bar above deltabest text, 1 = delta bar below deltabest text.

swap_style

Swap time gain and loss color between font and background color.

deltabest_source

Set lap time source for deltabest display. Available values are: Best = all time best lap time, Session = session best lap time, Stint = stint best lap time, Last = last lap time.

show_delta_bar

Show visualized delta bar.

delta_bar_length, delta_bar_height

Set delta bar length and height in pixels.

delta_bar_display_range

Set maximum display range (gain or loss) in seconds for delta bar, accepts decimal place. Default is 2 seconds.

delta_display_range

Set maximum display range (gain or loss) in seconds for delta reading, accepts decimal place. Default is 99.999 seconds.

freeze_duration

Set freeze duration (seconds) for displaying previous lap time difference against best lap time source after crossing finish line. Value range in 0 to 30 seconds. Default is 3 seconds. Set to 0 to disable.

enable_animated_deltabest

Deltabest display follows delta bar progress.

Back to Top

This widget displays deltabest info against multiple lap time sources.

show_all_time_deltabest

Show deltabest against personal all time best lap time.

show_session_deltabest

Show deltabest against current personal session best lap time. Note: session deltabest will be reset upon changing session, or reload preset/restart APP.

show_stint_deltabest

Show deltabest against current personal stint best lap time. Note: stint deltabest will be reset if vehicle stops in pit lane.

show_deltalast

Show delta against personal last lap time (deltalast). Note: deltalast will be reset upon ESC.

Back to Top

This widget displays wheel differential locking info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_inverted_locking

Invert minimum differential locking percent reading.

show_power_locking_*, show_coast_locking_*

Show minimum differential locking percent between left and right wheels on the same axle under power (on throttle) or coasting (off throttle).

A 100% reading indicates two wheels on the same axle are rotating at same speed; while 0% indicates that one of the wheels is completely spinning or locked.

off_throttle_threshold

Set percentage threshold which counts as off throttle if throttle position is lower, value range in 0.0 to 1.0. Default is 0.01 (1%).

on_throttle_threshold

Set percentage threshold which counts as on throttle if throttle position is higher, value range in 0.0 to 1.0. Default is 0.01 (1%).

power_locking_reset_cooldown, coast_locking_reset_cooldown

Set cooldown duration (seconds) before resetting minimum power or coast locking percent value if value hasn't changed during cooldown period. Default is 5 seconds.

Back to Top

This widget displays DRS(rear flap) usage info.

drs_text

Set custom DRS text.

font_color_activated, background_color_activated

Set color when DRS is activated by player.

font_color_allowed, background_color_allowed

Set color when DRS is allowed but not yet activated by player.

font_color_available, background_color_available

Set color when DRS is available but current disallowed to use.

font_color_not_available, background_color_not_available

Set color when DRS is unavailable for current track or car.

Back to Top

This widget displays electric motor usage info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_motor_temperature

Show electric motor temperature.

show_water_temperature

Show electric motor cooler water temperature.

overheat_threshold_motor, overheat_threshold_water

Set temperature threshold for electric motor and water overheat color indicator, unit in Celsius.

show_rpm

Show electric motor RPM.

show_torque

Show electric motor torque.

show_power

Show electric motor power.

show_regeneration_level

Show electric motor regeneration level.

Back to Top

This widget displays elevation plot. Note: elevation plot data is recorded together with track map. At least one complete and valid lap is required to generate elevation plot.

display_detail_level

Sets detail level for track map. Default value is 1, which auto adjusts map detail according to display size. Higher value reduces map detail and RAM usage, and may also help reduce rough edges from large map. Set to 0 for full detail.

display_width

Set widget display width in pixels. Minimum width is limited to 20.

display_height

Set widget display height in pixels. Minimum height is limited to 10.

display_margin_*

Set widget display margin in pixels. Maximum margin is limited to half of display_height value.

show_elevation_reading

Show elevation difference in game's coordinate system.

show_elevation_scale

Show elevation plot scale reading, which is ratio between screen pixel and real world elevation. A 1:10.5 reading means 1 pixel equals 10.5 meters (or feet, depends on distance unit setting).

show_background

Show widget background.

show_elevation_background

Show background of elevation plot.

show_elevation_progress

Show elevation progress bar according player's current position.

show_elevation_progress_line

Show elevation progress line according player's current position.

show_elevation_line

Show elevation reference line.

show_zero_elevation_line

Show zero elevation reference line in game's coordinate system.

show_start_line

Show start line mark.

show_sector_line

Show sector line mark.

show_position_mark

Show player's current position line mark.

Back to Top

This widget displays engine usage info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_oil_temperature

Show oil temperature.

show_water_temperature

Show water temperature.

overheat_threshold_oil, overheat_threshold_water

Set temperature threshold for oil and water overheat color indicator, unit in Celsius.

show_turbo_pressure

Show turbo pressure.

show_rpm

Show engine RPM.

show_rpm_maximum

Show maximum engine RPM (rev limit).

show_torque

Show engine torque.

show_power

Show engine power.

Back to Top

This widget displays additional engine temperature info.

show_oil_temperature

Show oil temperature.

show_water_temperature

Show water temperature.

overheat_threshold_oil, overheat_threshold_water

Set temperature threshold for oil and water overheat color indicator, unit in Celsius.

show_rate_of_change

Show temperature rate of change for a specific time interval.

rate_of_change_interval

Set time interval in seconds for rate of change calculation. Default interval is 10 seconds. Minimum interval is limited to 1 second, maximum interval is limited to 60 seconds.

rate_of_change_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

show_net_change_per_lap

Show temperature net change per lap.

Back to Top

This widget displays flags, pit state, warnings, start lights info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_pit_timer

Show pit timer, and total amount time spent in pit after exit pit.

pit_time_highlight_duration

Set highlight duration for total amount time spent in pit after exit pit.

pit_closed_text

Set custom pit closed text.

font_color_pit_closed, background_color_pit_closed

Set color indicator on pit timer when pit lane is closed.

show_low_fuel

Show low fuel (or low virtual energy if available) indicator when below certain amount value. Only one indicator will be displayed for low fuel (LF) or low virtual energy (LE), depends on which one would deplete sooner.

show_low_fuel_for_race_only

Only show low fuel indicator during race session.

low_fuel_volume_threshold

Set fuel volume threshold (in Liter) to show low fuel indicator when total amount of remaining fuel is equal or less than this value. This setting is used to limit low fuel warning when racing on lengthy tracks, where fuel tank may only hold for a lap or two. Default is 20 Liter.

low_fuel_lap_threshold

Set amount lap threshold to show low fuel indicator when total completable laps of remaining fuel is equal or less than this value. Default is 2 laps before running out of fuel.

show_speed_limiter

Show speed limiter indicator.

show_current_speed_while_limiter_on

Show current vehicle speed while speed limiter is on. This option is enabled by default.

Note, while enabled, the first letter of speed_limiter_text option will be displayed as prefix beside speed reading. Remove all text from speed_limiter_text option will show only speed reading.

speed_limiter_text

Set custom pit speed limiter text which shows when speed limiter is engaged.

show_yellow_flag

Show yellow flag indicator and distance display which shows nearest yellow flag vehicle distance. Note, positive distance reading indicates yellow flag that ahead of driver, negative indicates behind.

show_yellow_flag_for_race_only

Only show yellow flag indicator during race session.

yellow_flag_maximum_range_ahead, yellow_flag_maximum_range_behind

Set maximum range (meters) for displaying yellow flags that ahead of or behind driver. Default range ahead is 500 meters, range behind is 50 meters. To disable yellow flag that behind driver, set range behind to 0.

Note, yellow flags that ahead of driver take priority over those from behind.

show_blue_flag

Show blue flag indicator with nearest leading vehicle class name displayed on the left, and total duration (seconds) under blue flag on the right. Note, the class name is limited and trimmed to 4 characters.

show_blue_flag_for_race_only

Only show blue flag indicator during race session.

show_start_lights

Show race start lights indicator with light frame number for standing-type start.

red_lights_text

Set custom text for red lights.

green_flag_text

Set custom text for green flag.

green_flag_duration

Set display duration(seconds) for green flag text before it disappears. Default is 3.

show_traffic

Show nearest incoming on-track traffic indicator (time gap) while in pit lane or after pit-out.

traffic_maximum_time_gap

Set maximum time gap (seconds) of incoming on-track traffic.

traffic_pitout_duration

Set traffic indicator extended duration (seconds) after pit-out.

traffic_low_speed_threshold

Set low speed threshold for showing nearest incoming traffic indicator. Default is 8 m/s (roughly 28kph). Set to 0 to disable. This option can be useful to quickly determine nearby traffic situation after a spin or crash.

show_pit_request

Show pit request indicator and pit-in laps countdown alongside estimated remaining laps reading that current fuel or energy can run. Note, pit-in laps countdown value is always calculated towards the finish line of current stint's final lap, and thus is always less than or equal to estimated remaining laps reading. If countdown drops below 1.0 (laps), it indicates the final lap of current stint, and driver should pit in before the end of current lap to refuel. If countdown reaches zero or negative, there may still be some fuel or energy left in tank, however it will not be enough to complete another full lap.

show_finish_state

Show finish or disqualify state.

Back to Top

This widget displays g force and downforce info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_longitudinal_g_force

Show longitudinal g force with direction indicator.

show_lateral_g_force

Show lateral g force with direction indicator.

show_downforce_ratio

Show downforce ratio between front and rear. 50% indicates equal downforce; higher than 50% indicates front has more downforce.

show_front_downforce, show_rear_downforce

Show front and rear downforce reading in Newtons.

warning_color_liftforce

Set lift force indicator color.

Back to Top

This widget displays g force in circle diagram.

display_size

Set widget size in pixels.

display_radius_g

Set viewable g force range by radius(g).

show_inverted_orientation

Set true to invert display orientation for longitudinal and lateral g force axis. Default is false, which shows brake at top, acceleration at bottom, right-turn at left, left-turn at right.

show_readings

Show values from g force reading. Value at top is current longitudinal g force, and value at bottom is maximum longitudinal g force. Value at left is maximum lateral g force, and value at right is current lateral g force.

show_background

Show background color that covers entire widget.

show_circle_background

Show circle background color.

show_fade_out

Fade out circle background edge.

fade_in_radius, fade_out_radius

Set fade in/out radius, value range in 0.0 to 1.0.

show_maximum_average_lateral_g_circle

Show maximum average lateral g force reference circle.

maximum_average_lateral_g_circle_style

Set circle line style. 0 for dashed line, 1 for solid line.

maximum_average_lateral_g_circle_width

Set circle line width in pixels.

show_dot

Show g force dot.

dot_size

Set g force dot size in pixels.

show_trace

Show g force trace.

trace_maximum_samples

Set maximum amount g force trace samples.

trace_style

Set g force trace style. 0 for line style. 1 for point style.

trace_width

Set g force trace width in pixels.

show_trace_fade_out

Show trace fade out effect.

trace_fade_out_step

Set trace fade out speed. Value range in 0.1 to 0.9, higher value increases trace fade out speed. Default value is 0.2.

show_center_mark

Show center mark.

center_mark_radius_g

Set center mark size by radius(g).

center_mark_style

Set center mark line style. 0 for dashed line, 1 for solid line.

center_mark_width

Set center mark line width in pixels.

show_reference_circle

Show reference circle.

reference_circle_*_radius_g

Set reference circle size by radius(g). Circle will not be displayed if radius is bigger than display_radius_g.

reference_circle_*_style

Set reference circle line style. 0 for dashed line, 1 for solid line.

reference_circle_*_width

Set reference circle line width in pixels.

Back to Top

This widget displays fuel usage info.

Note, for non-hybrid pure electric vehicle, this widget will show battery charge usage (in percentage) info instead. Since multiple different electric systems exist in RF2, there is no reliable way to distinguish pure electric vehicles from fuel or hybrid vehicles, it is important to make sure fuel_unit option in Units setting is set to Liter in order to correctly display battery charge usage in percentage for pure electric vehicles.

Differences between relative and absolute refueling:

• Relative refueling value shows total amount additional fuel required to finish the remaining race length, which matches relative refueling mechanism (amount to add on top of remaining fuel in tank) in RF2.

• Absolute refueling value shows absolute total amount fuel required to finish the remaining race length, which matches absolute refueling mechanism (amount total fuel to fill tank up to) in LMU.

Also see estimated laps display option in Session widget that can be used for absolute refueling.

show_absolute_refueling

Show absolute refueling value instead of relative refueling when enabled. Note, + or - sign is not displayed with absolute refueling.

show_estimated_pitstop_count

Show estimated number of pit stop counts column.

show_delta_consumption_and_end_remaining

Show delta consumption and estimated end stint remaining fuel column.

*remaining

Remaining fuel in tank.

*refueling

Estimated refueling reading, which is the total amount additional fuel required to finish race.

Note, for relative refueling (show_absolute_refueling disabled), positive value indicates additional refueling and pit stop would be required, while negative value indicates total remaining fuel at the end of race, and no extra pit stop required. For example, a -1.5 value indicates 1.5 remaining fuel after crossed finish line.

For absolute refueling (show_absolute_refueling enabled), total remaining fuel at the end of race can be found by subtracting refuel value from remain value. For example, 6 (remain column) - 4.5 (refuel column) = 1.5 remaining fuel after crossed finish line.

*estimated_laps

Estimated laps reading that current fuel can last.

*estimated_minutes

Estimated minutes reading that current fuel can last.

*estimated_consumption

Estimated fuel consumption reading, which is calculated from last-valid-lap fuel consumption and delta fuel consumption. Note, when vehicle is in garage stall, this reading only shows last-valid-lap fuel consumption without delta calculation.

*saving_target

Estimated fuel saving target consumption reading for making one less pit stop.

*delta_consumption

Estimated delta fuel consumption reading. Positive value indicates an increase in consumption, while negative indicates a decrease in consumption.

*end_remaining

Estimated remaining fuel reading at the end of current stint before next pit stop, which reflects fuel usage efficiency.

Note, this value does not count towards the end of race; instead, this value always counts towards the end of last completeable lap. To find out total remaining fuel at the end of race, see refuel column and explanation.

*pitstop_count

Estimate number of pit stop counts when making a pit stop at end of current stint. Any non-zero decimal places would be considered for an additional pit stop.

*early_pitstop_count

Estimate number of pit stop counts when making an early pit stop at end of current lap. This value can be used to determine whether an early pit stop is worth performing comparing to pits value.

Example 1: When this value is just below 1.0 (such as 0.97), it indicates an early pit stop can be made right at the end of current lap with enough empty capacity to refuel according to refuel reading which would last to the end of race.

Example 2: When this value is just below 2.0 (such as 1.96), and pits value is also in 1.x range (such as 1.32), it indicates 2 required pit stops, and an early pit stop can be made right at the end of current lap with tank fully refueled according to refuel reading. After refueling, pits reading would show an approximately 0.96 value which indicates one more required pit stop.

Example 3: If this value is one or more integers higher than pits value, then additional pit stops would be required after making a pit stop at the end of current lap.

bar_width

Set each column width, value in chars, such as 10 = 10 chars. Default is 5. Minimum width is limited to 3.

low_fuel_lap_threshold

Set amount lap threshold to show low fuel indicator when total completable laps of remaining fuel is equal or less than this value. Default is 2 laps before running out of fuel.

warning_color_low_fuel

Set low fuel color indicator, which changes widget background color when there is just 2 laps of fuel left.

show_low_fuel_warning_flash

Show low fuel warning flash effect when below low_fuel_lap_threshold.

number_of_warning_flashes

Set number of warning flashes that will be played for a limited number of times. Default is 10 flashes. Minimum value is limited to 3.

warning_flash_highlight_duration

Set color highlight duration for each warning flash. Default is 0.4 seconds. Minimum value is limited to 0.2.

warning_flash_interval

Set minimum time interval between each warning flash. Default is 0.4 seconds. Minimum value is limited to 0.2.

show_fuel_level_bar

Show visualized horizontal fuel level bar.

fuel_level_bar_height

Set fuel level bar height in pixels.

show_starting_fuel_level_mark

Show starting fuel level mark of current stint. Default mark color is red.

show_refueling_level_mark

Show estimated fuel level mark after refueling. If the mark is not visible on fuel level bar, it indicates total refueling has exceeded fuel tank capacity. Default mark color is green.

starting_fuel_level_mark_width, refueling_level_mark_width

Set fuel level mark width in pixels.

caption_text

Set custom caption text.

swap_upper_caption, swap_lower_caption

Swap caption row position.

Back to Top

This widget displays fuel or virtual energy saving info.

Show current stint estimated total completable laps and completed laps based on current consumption.

Show estimated target lap consumption to save (extend) one or more total stint laps.

Show delta consumption against target lap consumption, which allows fuel or energy saving to be visualized and easily controlled in real-time.

Show consumption type in FUEL or NRG (if virtual energy available).

Show last lap consumption.

layout

Set target laps horizontal display order. Set 0 to show from left (less laps) to right (more laps). Set 1 to show from right to left instead.

minimum_reserve

Set minimum amount fuel or virtual energy in tank that is excluded from saving calculation and reserved for the end of stint. Default is 0.2 Liter for fuel (or % for virtual energy).

number_of_more_laps

Set number of target slots for more completable laps. Default is 3. Range in 1 to 10.

number_of_less_laps

Set number of target slots for less completable laps. Default is 0. Range in 0 to 5.

enable_pit_entry_bias

Auto calibrate target fuel (or energy) saving bias towards either pit entry position or finish line, depending on number of estimated remaining pit stops.

This feature is made specially for tracks that have pit entry position located far away from finish line, which it is necessary to take pit entry position into fuel saving calculation for increased accuracy.

While enabled, a new BIAS column will be added, which shows amount added fuel (or energy) bias towards pit entry position, as well as percentage pit entry bias from finish line, When bias is 0, it means there is no pit entry bias added.

Important notes: Do not enable this feature if you are not sure what it does. You must enter pit at least once to record pit entry position of the track for this feature to work.

remaining_pitstop_threshold

Set number of remaining pit stops threshold for auto calibrating target fuel (or energy) saving bias. Default value is 0.1.

Fuel (or energy) saving calculation is biased towards pit entry position when number of estimated remaining pit stops is greater than the threshold, otherwise biased towards finish line.

Back to Top

This widget displays gear, RPM, speed, battery info.

inner_gap

Set inner gap between gear and speed readings. Negative value reduces gap, while positive value increases gap. Default is 0.

show_speed

Show speed reading.

show_speed_below_gear

Show speed reading below gear.

font_scale_speed

Set font scale for speed reading. This option only takes effect when show_speed_below_gear is enabled. Default is 0.5.

show_speed_limiter

Show pit speed limiter indicator.

speed_limiter_text

Set custom pit speed limiter text which shows when speed limiter is engaged.

show_battery_bar

Show battery bar, which is only visible if electric motor available.

show_inverted_battery

Invert battery bar progression.

battery_bar_height

Set battery bar height in pixels.

high_battery_threshold, low_battery_threshold

Set percentage threshold for displaying low or high battery charge warning indicator. Default high threshold is 95 percent (default color purple), low threshold is 10 percent (default color red).

show_battery_reading

Show battery charge (in percentage) reading text on battery bar.

show_rpm_bar

Show a RPM bar at bottom of gear widget, which moves when RPM reaches range between safe and maximum RPM.

show_inverted_rpm

Invert RPM bar progression.

rpm_bar_height

RPM bar height, in pixel.

show_rpm_reading

Show RPM reading text on RPM bar.

rpm_multiplier_safe

This value multiplies maximum RPM value, which sets relative safe RPM range for RPM color indicator (changes gear widget background color upon reaching this RPM value).

rpm_multiplier_redline

This value multiplies maximum RPM value, which sets relative redline RPM range for RPM color indicator.

rpm_multiplier_critical

This value multiplies maximum RPM value, which sets critical RPM range for RPM color indicator.

show_rpm_flickering_above_critical

Show flickering effects when RPM is above critical range and gear is lower than maximum gear.

neutral_warning_speed_threshold, neutral_warning_time_threshold

Set speed/time threshold value for neutral gear color warning, which activates color warning when speed and time-in-neutral is higher than threshold. Speed unit in meters per second, Default is 28. Time unit in seconds, Default is 0.3 seconds.

Back to Top

This widget displays vehicle yaw angle, slip angle, heading info.

display_size

Set widget size in pixels.

show_yaw_angle_reading

Show yaw angle reading in degree.

show_slip_angle_reading

Show slip angle reading in degree.

show_degree_sign

Set true to show degree sign for yaw angle reading.

show_background

Show background color that covers entire widget.

show_circle_background

Show circle background color.

show_yaw_line

Show yaw line (vehicle heading).

show_direction_line

Show vehicle's direction of travel line.

show_slip_angle_line

Show slip angle (average of the front tyres) line.

*_line_head_scale

Set line length scale from center to head, value range in 0.0 to 1.0.

*_line_tail_scale

Set line length scale from center to tail, value range in 0.0 to 1.0.

*_line_width

Set line width in pixels.

show_dot

Show center dot.

show_center_mark

Show center mark.

center_mark_length_scale

Set center mark length scale, value range in 0.0 to 1.0.

center_mark_style

Set center mark line style. 0 for dashed line, 1 for solid line.

center_mark_width

Set center mark line width in pixels.

Back to Top

This widget displays vehicle instruments info.

icon_size

Set size of instrument icon in pixel. Minimum value is limited to 16.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_headlights

Show headlights state.

show_ignition

Show engine ignition, starter, stalling state.

stalling_rpm_threshold

Set RPM threshold for triggering engine stalling warning. Default is 100 RPM.

show_clutch

Show auto-clutch and clutch state.

show_wheel_lock

Show wheel lock state.

show_wheel_slip

Show wheel slip state.

wheel_lock_threshold

Set percentage threshold for triggering wheel lock warning under braking. 0.3 means 30% of tyre slip ratio.

wheel_slip_threshold

Set percentage threshold for triggering wheel slip warning under acceleration. 0.1 means 10% of tyre slip ratio.

Back to Top

This widget displays lap number, driver overall position, position in class info.

show_lap_number

Show your current lap number (lap progression) and total race laps. If total race laps is not available, such as in time-based session, estimated total laps will be displayed instead, and a ~ sign will be displayed before estimated total laps reading, and up to two decimal places will be kept.

Note, estimated total laps reading is calculated based on local player's lap time pace data from Delta Module, which can be different from in-game HUD reading. This reading does not concern about race leader's lap time pace, which means there may be an extra final lap on top of it.

warning_color_maximum_laps

Set warning color that shows 1 lap before exceeding maximum laps in qualify (or indicates the last lap of a lap-type race).

show_position_overall

Show your current overall position against all drivers in a session.

show_position_in_class

Show your current position in class against all drivers from the same class.

show_track_limits_points

Show current track cut points against total track limits points per penalty.

show_position_change

Show overall driver position change relative to overall qualification position.

show_position_change_in_class

Show driver position change in class instead of overall. This option is enabled by default.

Back to Top

This widget displays lap time history info.

Note, history data are loaded and updated from corresponding Consumption History file.

layout

2 layouts are available: 0 = vertical layout, 1 = reversed vertical layout.

lap_time_history_count

Set the number of lap time history display. Default is to show 10 most recent lap times.

show_empty_history

Show empty lap time history. Default is false, which hides empty rows.

show_laps

Show lap number.

show_time

Show lap time.

show_delta

Show lap time delta between two consecutive laps.

show_fuel

Show fuel consumption per lap.

show_virtual_energy_if_available

Show virtual energy consumption instead of fuel consumption if available. This option is enabled by default.

show_fuel_sign

Show fuel (or virtual energy) unit sign. L for liter, G for Gallon, E for virtual energy.

show_wear

Show average tyre wear (percent) per lap.

show_wear_sign

Show tyre wear percentage sign.

Back to Top

This widget displays lift and coast, TC & ABS activation LED info.

Note, currently this widget only works for LMU.

display_orientation

Set LED display orientation: 0 = left to right (horizontal), 1 = bottom to top (vertical), 2 = right to left (horizontal), 3 = top to bottom (vertical).

enable_double_side_led

Show a second set of LEDs on the opposite side.

double_side_led_gap

Set horizontal gap (in pixels) between double side LEDs.

number_of_led

Set number of LED to display. Minimum LED is limited to 3.

led_width, led_height, led_radius

Set LED width, height, radius in pixels. To achieve circle LED, set a higher radius value.

lift_and_coast_multiplier_critical

This value multiplies maximum lift and coast range, which sets critical range of lift and coast LED.

Back to Top

This widget displays a zoomed navigation map that centered on player's vehicle. Note: at least one complete and valid lap is required to generate map.

display_size

Set widget size in pixels.

view_radius

Set viewable area by radius(unit meter). Default is 500 meters. Minimum value is limited to 5.

show_background

Show background color that covers entire widget.

show_circle_background

Show circle background color.

circle_outline_width

Set circle background outline width. Set value to 0 to hide outline.

show_fade_out

Fade out view edge.

fade_in_radius, fade_out_radius

Set fade in/out radius, value range in 0.0 to 1.0.

map_width

Set navigation map line width.

map_outline_width

Set navigation map outline width.

show_start_line

Show start line mark.

show_sector_line

Show sector line mark.

show_vehicle_standings

Show vehicle standings info on navigation map.

show_circle_vehicle_shape

Set True to show vehicle in circle shape, set False for arrow shape.

vehicle_size

Set vehicle size in pixels.

vehicle_offset

Set vehicle vertical position offset (percentage) relative to display size, value range in 0.0 to 1.0.

vehicle_outline_width

Set vehicle outline width.

Back to Top

This widget displays push to pass (P2P) usage info.

show_battery_charge

Show percentage available battery charge.

show_activation_timer

Show electric boost motor activation timer.

activation_threshold_gear

Set minimum gear threshold for P2P ready indicator.

activation_threshold_speed

Set minimum speed threshold for P2P ready indicator, unit in KPH.

activation_threshold_throttle

Set minimum throttle input percentage threshold for P2P ready indicator, value range in 0.0 to 1.0. Default is 0.6 (60%).

minimum_activation_time_delay

Set minimum time delay between each P2P activation, unit in seconds.

maximum_activation_time_per_lap

Set maximum P2P activation time per lap, unit in seconds.

Back to Top

This widget displays onboard setting info.

Note, currently this widget only works for LMU.

show_abs

Show current ABS level.

show_tc

Show current TC level.

show_tc_cut

Show current TC power cut level.

show_tc_slip

Show current TC slip angle level.

show_brake_migration

Show current brake migration level.

show_motor_map

Show current motor (or engine) map level.

show_front_arb

Show current front anti-roll bar level.

show_rear_arb

Show current rear anti-roll bar level.

Back to Top

This widget displays pace notes, comments, debugging info.

show_background

Show background color. Turn off to show text only.

show_pit_notes_while_in_pit

Show custom notes while in pit lane.

pit_notes_text, pit_comments_text

Set custom notes and comments to be displayed while in pit lane.

show_pace_notes

Show nearest pace notes info behind current vehicle position.

show_comments

Show nearest pace notes comments info behind current vehicle position.

enable_comments_line_break

Enable line break for displaying multi-line comments. To break a line into multiple lines, add \n to any part of the comment.

show_debugging

Show nearest pace notes index number behind current vehicle position, and distance value (meters) behind current position to next index position.

pace_notes_width, comments_width, debugging_width

Set maximum display width, value in chars, such as 10 = 10 chars.

enable_auto_hide_if_not_available

Auto hide this widget if pace notes data is not available for current track.

maximum_display_duration

Set maximum display duration (seconds) of each note. Set to -1 to always display notes. Default is -1.

Back to Top

This widget displays pedal input and force feedback info.

show_readings

Show pedal input and force feedback readings. Note, while show_*_filtered option is enabled, only the highest reading between filtered and raw input is displayed.

readings_offset

Set reading text offset position (percentage), value range in 0.0 to 1.0.

enable_horizontal_style

Show pedal bar in horizontal style.

bar_length, bar_width_unfiltered, bar_width_filtered

Set pedal bar length and width in pixels.

inner_gap

Set gap between pedal and maximum indicator.

maximum_indicator_height

This is the indicator height when pedal reaches maximum travel (100%), value in pixel.

show_brake_pressure

Show brake pressure changes applied on all wheels, which auto scales with maximum brake pressure and indicates amount brake released by ABS on all wheels. This option is enabled by default, which replaces game's filtered brake input that cannot show ABS.

show_throttle

Show throttle bar.

show_brake

Show brake bar.

show_clutch

Show clutch bar.

show_ffb_meter

Show Force Feedback meter.

show_*_filtered

Show filtered pedal input if available. Note, some vehicles may not provide filtered pedal input value, which the value will be zero. Disable this option to show raw input only.

Back to Top

This widget displays estimated pit stop duration and refilling info.

Note, this widget is designed for LMU. Most readings are not available for RF2 due to lack of API data.

lengthy_stop_duration_threshold

Set warning threshold for lengthy pit stop duration in seconds. Default is 60 seconds. This option can be useful to check for unusually long pit stop duration, such as repairing.

pass_duration

Show estimated pit-lane pass through (drive-through) time, calculated from pit-entry to pit-exit line. Average accuracy is within 0.5 seconds. Note, for any new tracks, at least one pit-lane pass through is required to record data for pass through time calculation.

pit_timer

Show pit timer, useful for comparing against other pit time readings.

stop_duration

Show estimated pit stop time while making a service stop or serving a penalty, calculated according to each setting from MFD Pitstop page and underlying service timing and concurrency differences. Average accuracy is within 1 seconds.

Note, for unscheduled pit stop (without requesting pit), game sometimes will add random amount extra delay (as part of pit crew preparation time) on top of pit stop time. To avoid this, always requests pit before entering pit.

minimum_total_duration

Show estimated minimum total pit time, which is the sum of pass_duration, stop_duration, and additional_pitstop_time. Note, this reading is recalculated only while not in pit lane.

stop_go_penalty_time

Set stop go penalty time in seconds. Default value is 10 seconds. Note, this value is only used if penalty time data is not available from game API.

additional_pitstop_time

Set additional pit stop time that is not part of pass_duration or stop_duration. Default value is 2 seconds, which is the average time it takes to decelerate and accelerate towards and away from pit spot.

show_relative_refilling

Show actual_relative_refill and total_relative_refill columns.

actual_relative_refill

Show actual relative refilling, as the total additional fuel or virtual energy that will be added in next pit stop according to remaining fuel or virtual energy and user refill setting from MFD Pitstop page.

total_relative_refill

Show total relative refilling, as the total additional fuel or virtual energy that is required to finish the race. This is the same value as seen from refill column of Fuel Widget or Virtual energy Widget.

With both actual and total relative refilling readings, users can determine precisely how much fuel or virtual energy that will be added in next pit stop, and whether the refilling will be enough or more pit stops are required.

show_pit_occupancy

Show pit_occupancy and pit_requests columns.

pit_occupancy

Show number of vehicles that stopped in pit lane, and number of vehicles currently in pit lane (whether passing or stopped). This does not include vehicles that are parked in garage.

pit_requests

Show number of vehicles that requested for pit stop, and number of vehicles currently outside pit lane.

Back to Top

This widget displays vehicle radar info.

global_scale

Sets global scale of radar display. Default is 6, which is 6 times of original size.

radar_radius

Set the radar display area by radius(unit meter). Default is 30 meters. Minimum value is limited to 5.

show_vehicle_orientation

Show opponent vehicle orientation (heading) relative to player. Disable this option to show player and opponent vehicle headings in parallel.

vehicle_length, vehicle_width

Set vehicle overall size (length and width), value in meters.

vehicle_border_radius

Set vehicle round border radius.

vehicle_outline_width

Set vehicle outline width.

enable_radar_fade

Enable radar gradually fade in/out effect.

radar_fade_out_radius

Set radar fade out radius relative to radar radius. Value range in 0.5 to 1.0. Default value is 0.98.

radar_fade_in_radius

Set radar fade in radius relative to radar radius. Minimum value is limited to 0.1, maximum value cannot exceed radar_fade_out_radius. Default value is 0.8.

show_background

Show background color that covers entire widget.

show_circle_background

Show circle background color.

show_edge_fade_out

Fade out radar edge.

edge_fade_in_radius, edge_fade_out_radius

Set fade in/out radius relative to radar radius, value range in 0.0 to 1.0.

show_overlap_indicator

Show overlap indicator when there are nearby side by side vehicles. This option shows boundary style indicator if show_overlap_indicator_in_cone_style option is disabled.

show_overlap_indicator_in_cone_style

Show overlap indicator in cone style instead of boundary style.

overlap_cone_angle

Set cone display angle in degrees. This option does not affect overlap detection range. Default is 120 degrees.

overlap_nearby_range_multiplier

Set nearby vehicle overlap detection range multiplier that scales with vehicle width. A value of 5 would result a 5-vehicle-wide detection range. Default is 5 vehicle-wide.

overlap_critical_range_multiplier

Set nearby vehicle critical overlap detection range multiplier that scales with vehicle width. Default is 1 vehicle-wide.

indicator_size_multiplier

Set indicator size multiplier that scales with vehicle width.

show_center_mark

Show center mark on radar.

center_mark_style

Set center mark line style. 0 for dashed line, 1 for solid line.

center_mark_radius

Set center mark size by radius(unit meter).

center_mark_width

Set center mark line width in pixels.

show_angle_mark

Show angle mark (fixed 45 degrees) on radar.

show_distance_circle

Show distance circle line on radar for distance reference.

distance_circle_*_style

Set distance circle line style. 0 for dashed line, 1 for solid line.

distance_circle_*_radius

Set distance circle size by radius(unit meter). Circle will not be displayed if radius is bigger than radar_radius.

distance_circle_*_width

Set distance circle line width in pixels.

enable_auto_hide

Auto hides radar display when no nearby vehicles.

enable_auto_hide_in_private_qualifying

Auto hides radar in private qualifying session, requires both enable_auto_hide and enable_restapi_access enabled.

auto_hide_time_threshold

Set amount time(unit second) before triggering auto hide. Default is 1 second. Note, this option has no effect while enable_radar_fade is enabled.

auto_hide_minimum_distance_ahead, behind, side

The three values define an invisible rectangle area(unit meter) that auto hides radar if no vehicle is within the rectangle area. Default value is -1, which auto scales with radar_radius value. Set to any positive value to customize radar auto-hide range. Note, each value is measured from center of player's vehicle position.

vehicle_maximum_visible_distance_ahead, behind, side

The three values define an invisible rectangle area(unit meter) that hides any vehicle outside the rectangle area. Default value is -1, which auto scales with radar_radius value. Set to any positive value to customize vehicle visible range. Note, each value is measured from center of player's vehicle position.

Back to Top

This widget displays vehicle rake angle info.

wheelbase

Set wheelbase in millimeters, for used in rake angle calculation.

rake_angle_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

show_degree_sign

Set true to show degree sign for rake angle value.

show_ride_height_difference

Show average front and rear ride height difference in millimeters.

Back to Top

This widget displays relative standings info.

show_player_highlighted

Highlight player row with customizable specific color.

show_lap_difference

Show different font color based on lap difference between player and opponents. Note, this option will override font_color setting from position, driver name, vehicle name.

font_color_same_lap, font_color_laps_ahead, font_color_laps_behind

Set font color for lap difference. Note, font_color_laps_ahead and font_color_laps_behind applies to race session only.

show_position

Show overall position standings.

show_position_change

Show overall driver position change relative to overall qualification position.

show_position_change_in_class

Show driver position change in class instead of overall. This option is enabled by default.

show_driver_name

Show driver name.

driver_name_shorten

Shorten driver's first name to a single letter with a period separating driver's last name, and any middle names will not be displayed. Note, if a driver is using nickname that consists only a single word, the name will not be shortened.

driver_name_uppercase

Set driver name to uppercase.

driver_name_width

Set drive name display width, value in chars, such as 10 = 10 chars.

driver_name_align_center

Align driver name in the center when enabled. Default is left alignment when disabled.

show_vehicle_name

Show vehicle name. Note, game API outputs skin livery name as vehicle name, which means actual displayed name depends on what skin livery name is called. For example, some vehicles may add team name and/or class name in skin livery name, some may not.

show_vehicle_brand_as_name

Show vehicle brand name instead of vehicle name. If brand name does not exist, vehicle name will be displayed instead.

vehicle_name_uppercase

Set vehicle name to uppercase.

vehicle_name_width

Set vehicle name display width, value in chars, such as 10 = 10 chars.

vehicle_name_align_center

Align vehicle name in the center when enabled. Default is left alignment when disabled.

show_brand_logo

Show user-defined brand logo if available.

brand_logo_width

Set maximum brand logo display width in pixels. Note, maximum brand logo display height is automatically adapted to font_size.

show_time_gap

Show relative time gap between player and opponents.

show_time_gap_sign

Show plus or minus sign for time gap. - sign indicates opponent's relative position is in front of player, + sign indicates the opposite.

time_gap_width

Set time gap display width, value is in chars, 5 = 5 chars wide.

time_gap_align_center

Align time gap in the center when enabled. Default is right alignment when disabled.

show_highlighted_nearest_time_gap

Show highlighted color on opponents within nearest time gap threshold.

nearest_time_gap_threshold_front, nearest_time_gap_threshold_behind

Set nearest time gap threshold (in seconds) for opponent who is in front of or behind player. Default is 1 second for front, and 2 seconds for behind.

show_laptime

Show driver's last lap time or pit stop duration if available. Invalid lap time is preceded by asterisk mark, such as *1:23.54.

show_pitstop_duration_while_requested_pitstop

Show driver's last recorded pit stop duration (in lap time column) while you have requested pit stop.

show_highlighted_fastest_last_laptime

Highlight the fastest last lap time within the same class if available.

show_position_in_class

Show driver's position standing in class.

show_class_style_for_position_in_class

Show class style background color for position in class.

show_class

Show vehicle class categories. Class alias name and color are fully customizable in classes.json preset, see Vehicle Class Editor section for details.

Note, random color will be displayed for unknown class name that is not defined in classes.json preset.

class_width

Set class name display width, value is in chars, 4 = 4 chars wide. Set to 0 to hide class name while showing only class color.

show_pit_status

Show indicator whether driver is currently in pit or garage, or causes yellow flag.

pit_status_text

Set custom pit status text which shows when driver is in pit.

garage_status_text

Set custom garage status text which shows when driver is in garage.

yellow_flag_status_text

Set custom yellow flag status text which shows when driver causes (or likely to) yellow flag. Note, unlike in-game yellow flag, the indicator is always displayed when driver's speed is below 28kph (outside pit lane), regardless whether driver has caused yellow flag on track.

finish_status_text

Set custom finish (checkered flag) status text which shows when driver finished race.

show_tyre_compound

Show tyre compound symbol for tyre that matches specific tyre compounds defined in compounds.json preset.

show_compound_for_each_wheel

Show tyre compound symbol for each wheel. Compound symbol display order is arranged as front left, front right, rear left, rear right. This option is enabled by default.

Disable this option to show a single symbol for all tyres, which allows a more compact view. If mixed tyres are used, a X symbol will be displayed instead, which can be customized by mixed_compound_symbol option.

show_compound_color_by_type

Show different compound color by compound type, which can be customized in Tyre Compound Editor.

Note, player's compound color is not affected by this setting while show_player_highlighted option is enabled.

tyre_compound_spacing

Set display spacing (in pixels) between each compound symbol. Default is 1 pixel.

show_pitstop_count

Show each driver's pit stop count and penalty count if available. Note, when a driver accumulates one or more penalties, this column will show the number of penalties in negative value with purple (default) background to distinguish from number of pit stops.

show_pit_request

Show pit request color indicator on pit stop count column.

show_vehicle_in_garage

Show vehicles parked in garage stall. Default is false. Note, local player is always displayed.

additional_players_front, additional_players_behind

Set additional players shown on relative list. Each value is limited to a maximum of 60 additional players (for a total of 120 additional players). Default is 0.

Back to Top

This widget displays estimated relative finish order between leader and local player with corresponding refilling estimate in a table view.

Overview

This widget predicts relative final lap progress (percent into lap) at the moment when session timer ended in time-type race, or leader crossed finish line in laps-type race, which can be used to determine whether extra laps are required to finish race.

Simple example: in time-type race, at the moment when session timer ended, assume race leader's vehicle is in Sector 1 (or 20% into lap), and local player is in Sector 3 (or 80% into lap) which is ahead of leader in terms of relative lap progress (0% from start line to 100% at finish line). When local player finishes his current lap, the race does not end for him because leader is behind local player and has not yet crossed finish line. This means local player has to complete another lap in order to finish the race, and needs an extra lap of fuel.

The table consists of 5 fixed rows, 1 optional row, 3 fixed columns, and 10 optional prediction columns that can be customized. Example:

First and fourth rows, starting from second cell, show estimated leader's pit time and local player's pit time, where first row first cell shows current session type in TIME or LAPS. Last cell shows last recorded total time that leader and local player had spent in pit. Note, last recorded total pit time counts from pit entry to pit exit point, it doesn't include the extra few seconds that spent while approaching or exiting from pit.

Second and third rows, starting from second cell, show estimated leader's final lap progress (fraction of lap) and local player's final lap progress that depend on current session type:

• For TIME type race, it shows final lap progress at the moment when session timer ended.
• For LAPS type race, it shows relative final total lap difference between leader and local player. Leader's value from second row second cell always shows integer value, because laps-type race has no timer, and the end of race is determined at the moment when leader crossed finish line, which can only be full laps. Local player's value from third row second cell always shows final lap progress relative to leader's value from second row second cell. Both leader's and local player's final lap progress values starting from third cell are offset from second cell of same row.

Third row, first cell shows relative lap difference between leader and local player that is calculated from lap time pace difference of both players, which can be used to determine whether leader has the chance to overtake local player on final lap. For example:

• If relative lap difference value shows 0.25, that means for every full lap, leader is faster than local player by 0.25 lap. If leader is at start line and player is just within 0.25 lap distance from leader, that means leader can catch up and overtake player before the end of lap.
• If relative lap difference value shows 0.25 and leader is at middle of current lap (0.5 lap), that means leader now only has roughly half of the lap distance (0.12 lap) to make successful overtake before the end of lap. If player is not within this 0.12 lap distance, then leader may not be able to overtake.

Fifth row, first cell shows refilling type in FUEL or NRG (if virtual energy available). Starting from second cell, shows estimated local player's refilling that depends on current session type:

• For TIME type race, refilling value from each column is calculated based on local player's current laptime pace, consumption, and local player's final lap progress from third row of same column. Note, each refilling value has no relation to leader's final lap progress value from same column. Refilling value from 0s column gives same reading as seen from Fuel or Virtual Energy Widget in time-type race.
• For LAPS type race, only refilling value from 0s column is calculated and displayed according to leader's leader's final lap progress value. Other column values are not displayed, this is done to avoid confusion. Because unlike TIME type race where all final lap progress values are within 0.0 to 1.0 range, in LAPS type race values can exceed 1.0 or below 0.0 (negative), which the number of possible lap differences would increase exponentially and not possible to list all of them in the widget.

Sixth row (optional), first cell shows number of extra laps for extra refilling display. Starting from second cell, shows estimated extra refilling value that depends on local player's refilling value and number of extra laps setting. Each extra refilling value equals extra laps of consumption plus local player's refilling value of same column. Those values save the trouble from manual calculation in case there will be extra laps.

See TIME or LAPS type race example usages below for details.

Important notes

• Prediction accuracy depends on many variables and is meant for final stint estimate. Such as laptime pace, pit time, penalties, weather condition, safety car, yellow flag, can all affect prediction accuracy. It requires at least 2-3 laps to get sensible readings, and more laps to have better accuracy.

• Final lap progress values will not be displayed if no corresponding valid lap time pace data found, which requires at least 1 or 2 laps to record. If local player is the leader, then all values from leader's row will not be displayed. Refilling values will not be displayed during formation lap for the reasons mentioned in first note.

• Refilling estimate calculation is different between TIME and LAPS type races, make sure to look at the correct value, check out example usage below for details.

• LMU currently uses absolute refueling mechanism (amount total fuel to fill tank up to), as opposite to relative fuel (amount to add on top of remaining fuel in tank). User can enabled show_absolute_refilling option to display total amount fuel/energy required (including fuel/energy in tank) to finish race.

Time-type race example usage

1. Determine leader's next pit time and select leader's final lap progress (second row) value from corresponding pit time (first row) column. 0s column means no pit stop.

2. Determine local player's next pit time and select local player's final lap progress (third row) value from corresponding pit time (fourth row) column.

3. Compare the two final lap progress values from leader and local player, assume fuel per lap is 3.8:

   • If leader's final lap progress value is greater than local player, such as leader's 0.91 (50s column) vs player's 0.47 (30s column), it indicates that leader will be ahead of local player when timer ended, and there will be no extra final lap. So local player's refilling value from corresponding 30s column can be used, in this case, it's +7.4 fuel to add. However, if leader is closer to finish line (as show in orange color indicator), there is a chance that leader may be fast enough to cross finish line before the end of timer, which would result an extra final lap for local player, and requires adding an extra lap of fuel (3.8) on top of +7.4 fuel. In this case it would be +11.2 refuel, or you can simply look at the refuel value from extra refilling row of same column.

   • If local player's final lap progress value is greater than leader, such as leader's 0.10 (30s column) vs player's 0.39 (40s column), it indicates that local player will be ahead of leader when timer ended, and there will be an extra final lap for local player, and here again requires adding an extra lap of fuel (3.8) on top of +7.4 fuel from 40s column, which is +11.2 refuel. However, if the difference between the two final lap progress values is smaller than relative lap difference (from third row first cell) value, it may indicate that leader could overtake local player on final lap, which would result no extra final lap.

4. To sum up, if comparison shows no extra final lap, then just refill according to local player's refilling (fifth row) value from the same column of local player's final lap progress (third row). If comparison shows an extra final lap, then just add an extra lap of fuel on top of local player's refilling value; or, just look at the refuel value from extra refilling row of same column.

Laps-type race example usage

Note, there is generally no reason to use this widget in LAPS type race unless you are doing multi-class laps-type race which is very rarely seen.

1. Determine leader's next pit time and select leader's final lap progress (second row) value from corresponding pit time (first row) column. 0s means no pit stop.

2. Determine local player's next pit time and select local player's final lap progress (third row) value from corresponding pit time (fourth row) column.

3. Subtract local player's final lap progress value from leader's final lap progress, then round down value:

   • If leader's final lap progress value is 2.00 (0s column), and local player's final lap progress value is 0.40 (0s column), then after subtracting (2 - 0.4 = 1.6) and rounding down, the final value is 1 lap difference, which means local player will do one less lap than leader. As mentioned earlier, for laps-type race, refilling value from 0s column is calculated according to leader's leader's final lap progress value, which any lap difference is already included in the result from local player's refilling value (fifth row second cell), in this case, it's +12.8 fuel to add.

   • If leader's final lap progress value is 1.43 (40s column), and local player's final lap progress value is -0.24 (50s column), then after subtracting (1.43 - -0.24 = 1.67) and rounding down, the final value is also 1 lap difference, which means local player will do the same one less lap than leader. So in this case, it's still +12.8 fuel to add.

   • If leader's final lap progress value is 2.00 (0s column), and local player's final lap progress value is -0.11 (40s column), then after subtracting (2 - -0.11 = 2.11) and rounding down, the final value is 2 lap difference, which means local player will do two less laps than leader. So an extra lap of fuel may be removed from local player's refilling value from fifth row second cell, in this case, it's 12.8 minus one lap of fuel 2.2, equals +10.6 fuel to add. Alternatively, it can be calculated from full lap refuel (as show in Fuel Widget), which will be 15.0 minus two lap of fuel 4.4, and equals +10.6 fuel to add. Be aware that carrying less fuel is risky in laps-type race due to reasons below.

4. Last note, since the end of laps-type race is determined by the moment that leader completed all race laps, leader can greatly affect final prediction outcome. To give an extreme example, if leader is ahead of everyone by a few laps, and decides to wait a few minutes on his final lap before finish line, then everyone else will be catching up and do a few extra laps which would require more fuel. Thus it is always risky to carry less fuel in laps-type race.

layout

2 layouts are available: 0 = show columns from left to right, 1 = show columns from right to left.

near_start_range

Set detection range (in seconds) near (after) start/finish line to show color indicator when vehicle is within the range (or less). Default is 20 seconds. Default color is green.

near_finish_range

Set detection range (in seconds) near (before) start/finish line to show color indicator when vehicle is within the range (or less). Default is 20 seconds. Default color is orange.

show_absolute_refilling

Show absolute refilling value instead of relative refilling when enabled. Note, + or - sign is not displayed with absolute refilling.

show_extra_refilling

Show readings of extra refilling row below local player's refilling row. Each extra refilling value equals extra laps of consumption plus local player's refilling value of same column. Those values save the trouble from manual calculation in case there will be extra laps.

The first column of extra refilling row shows number of extra laps depends on number of extra laps setting, such as EX+1 for 1 extra lap, or EX+3 for 3 extra laps.

number_of_extra_laps

Set number of extra laps for extra refilling calculation. Default is 1 extra lap.

number_of_prediction

Set number of optional prediction columns with customizable pit time. Value range in 0 to 10. Default is 4 extra customizable columns.

prediction_*_leader_pit_time, prediction_*_player_pit_time

Set prediction pit time for leader or local player.

Back to Top

This widget displays visualized ride height info.

ride_height_maximum_range

Set visualized maximum ride height display range (millimeter).

rideheight_offset*

Set ride height offset for bottoming indicator. Value in millimeters, but without decimal place.

Back to Top

This widget displays standings info from opponent ahead and behind local player from same vehicle class.

Note, most options are inherited from Relative and Standings widgets, with some additions noted below.

time_interval_align_center

Align time interval in the center when enabled. Default is right alignment when disabled.

*_color_time_interval_ahead, *_color_time_interval_behind

Set custom time interval color of opponent ahead and behind.

Back to Top

This widget displays vehicle front and rear roll angles info.

show_degree_and_percentage_sign

Set true to show degree and percentage sign.

wheel_track_front, wheel_track_rear

Set front and rear wheel track in millimeters, for used in roll angle calculation. Default is 2000 millimeters.

roll_angle_smoothing_samples, roll_angle_ratio_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

show_roll_angle_difference

Show roll angle difference between front and rear roll angles.

show_roll_angle_ratio

Show roll angle ratio between front and rear. 50% indicates equal roll angle; less than 50% indicates rear rolls more than front.

Back to Top

This widget displays RPM LED info.

number_of_led

Set number of LED to display. Minimum LED is limited to 3.

enable_double_side_led

Enable Outside to Center LED layout (as opposite to Left to Right layout). While this option is enabled, total number of LED is doubled.

led_width, led_height, led_radius

Set LED width, height, radius in pixels. To achieve circle LED, set a higher radius value.

rpm_multiplier_low

This value multiplies maximum RPM value, which sets starting range of RPM LED.

rpm_multiplier_safe

This value multiplies maximum RPM value, which sets safe range of RPM LED.

rpm_multiplier_redline

This value multiplies maximum RPM value, which sets redline range of RPM LED.

rpm_multiplier_critical

This value multiplies maximum RPM value, which sets critical range of RPM LED.

rpm_multiplier_over_rev

This value multiplies maximum RPM value, which sets over rev range of RPM LED.

show_rpm_flickering_above_critical

Show flickering effects when RPM is above critical range and gear is lower than maximum gear.

show_speed_limiter_flash

Show RPM LED flash effect when speed limiter is activated.

speed_limiter_flash_interval

Set minimum time interval between each LED flash. Default is 0.25 seconds. Minimum value is limited to 0.2.

Back to Top

This widget displays sectors timing info.

layout

2 layouts are available: 0 = target and current sectors above deltabest sectors, 1 = deltabest sectors above target and current sectors.

enable_all_time_best_sectors

Show sectors timing based on all time best sectors instead of current session. This option is enabled by default. Set false to show sectors timing from current session only.

target_laptime

Set target laptime for display target reference lap and sector time. Set Theoretical to show theoretical best sector time. Set Personal to show sector time from personal best lap time. Note, if enable_all_time_best_sectors option is enabled in Sectors Module, all time best sectors data will be displayed instead, otherwise only current session best sectors data will be displayed.

freeze_duration

Set freeze duration (seconds) for displaying previous sector time. Default is 5 seconds.

Back to Top

This widget displays system clock, session name, timing, lap number, overall position info.

show_session_name

Show current session name that includes testday, practice, qualify, warmup, race.

session_text_*

Set custom session name text.

show_system_clock

Show current system clock time.

system_clock_format

Set clock format string. To show seconds, add %S, such as %H:%M:%S %p. See link for full list of format codes.

show_session_time

Show total remaining session time.

show_estimated_laps

Show estimated total remaining laps (from current lap position towards finish line) based on total remaining session time and local player's lap time pace. This value can be used for adjusting absolute refueling.

Note, this is the same value that used for calculating estimated refueling value in Fuel Module. As with estimation, there may be a margin of error of one lap, and may be affected by other variables such as those mentioned in Relative Finish Order widget.

Back to Top

This widget displays visualized slip ratio info.

slip_ratio_optimal_range

Set optimal slip ratio range (percentage) for optimal and critical slip ratio color indication, value range in 0 to 100. Default is 30 percent.

slip_ratio_maximum_range

Set visualized maximum slip ratio display range (percentage), value range in 10 to 100. Default is 50 percent.

Back to Top

This widget displays conditional speed info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_speed

Show current vehicle speed.

show_speed_minimum

Show minimum speed that is updated while off throttle.

show_speed_maximum

Show maximum speed that is updated while on throttle.

show_speed_fastest

Show fastest recorded speed. To reset current record, shift gear into reverse, or reload preset.

off_throttle_threshold

Set throttle threshold which counts as off throttle if throttle position is lower, value range in 0.0 to 1.0. Default is 0.5.

on_throttle_threshold

Set throttle threshold which counts as on throttle if throttle position is higher, value range in 0.0 to 1.0. Default is 0.01.

speed_minimum_reset_cooldown, speed_maximum_reset_cooldown

Set cooldown duration (seconds) before resetting minimum or maximum speed value.

Back to Top

This widget displays standings info.

Note, most options are inherited from Relative widget, with some additions noted below.

enable_single_class_exclusive_mode

Enable single-class exclusive mode, which displays vehicles from player's class only. This mode takes priority over all other display mode.

enable_multi_class_split_mode

Enable multi-class split mode, which splits and displays each vehicle class in separated groups. This mode will only take effect when there is more than one vehicle class present in a session, otherwise it will automatically fall back to normal single class mode.

minimum_top_vehicles

Set minimum amount top place vehicles to display. This value has higher priority over other maximum_vehicles settings. Default is 3, which always shows top 3 vehicles if present.

maximum_vehicles_exclusive_mode

Set maximum amount vehicles to display in exclusive mode, which takes effect when enable_single_class_exclusive_mode is enabled.

maximum_vehicles_combined_mode

Set maximum amount vehicles to display in combined mode, which takes effect when enable_multi_class_split_mode is not enabled. When total vehicle number is lower than this value, extra rows will auto-hide. When total vehicle number is above this value, the top 3 vehicles will always show, and rest of the vehicles will be selected from the nearest front and behind places related to player.

maximum_vehicles_split_mode

Set maximum amount vehicles to display in split mode, which takes effect when in multi-class session and enable_multi_class_split_mode is enabled. If total vehicle number is above this value, any extra vehicles will not be shown. Default is 50, which is sufficient in most case.

maximum_vehicles_per_split_player

Set maximum amount vehicles to display for class where player is in. Default is 7. Note that, if player is not in first place, then at least one opponent ahead of player will always be displayed, even if this value sets lower.

maximum_vehicles_per_split_others

Set maximum amount vehicles to display for classes where player is not in. Default is 3.

split_gap

Set split gap between each class.

show_time_gap

Show each driver's time gap behind overall leader in race session. In none race sessions, time gap is calculated from overall leader's session best lap time.

show_time_gap_from_same_class

Show time gap from same class leader instead of overall leader. This option only takes effect while enable_multi_class_split_mode is enabled.

time_gap_leader_text

Set text indicator for race leader in time gap column.

show_time_interval

Show time interval between each closest driver in order.

show_time_interval_from_same_class

Show time interval from same class. This option only takes effect while enable_multi_class_split_mode is enabled.

time_interval_leader_text

Set text indicator for race leader in time interval column.

show_laptime

Show driver's last lap time or pit stop duration if available. Invalid lap time is preceded by asterisk mark, such as *1:23.54.

Note, if show_best_laptime is not enabled, this option will show driver's session best lap time in none-race sessions.

show_best_laptime

Show driver's session best lap time.

show_best_laptime_from_recent_laps_in_race

Show driver's best lap time from (five) most recent laps in race session. This option provides a better view of driver's recent performance during longer race.

show_delta_laptime

Show lap time difference (delta) between player and opponents from most recent laps (up to 5 recent lap time records). The default layout order shows delta lap time records from right side column (most recent lap) to left.

A green color (default) delta indicates that player's recent lap time is faster than opponent, while orange color delta indicates the opposite.

show_inverted_delta_laptime_layout

Enable this option to invert layout order for delta lap time records.

number_of_delta_laptime

Set number of delta lap time records to display. Minimum number is limited to 2, maximum is limited to 5.

show_stint_laps

Show number of completed laps from current stint and estimated total stint laps. Note, it may require a few laps to get accurate estimate.

show_energy_remaining

Show remaining virtual energy reading in percentage from each driver, with 4 different states:

• Unavailable: virtual energy reading is not available currently, default color grey.
• High: above 30% remaining, default color green.
• low: from 30% to 10% remaining, default color orange.
• critical: 10% or lower remaining, default color red.

Note, for vehicle without virtual energy, remaining fuel will be displayed instead.

Known limitation with remaining virtual energy readings

Currently, remaining virtual energy data from LMU's Rest API is updated only when driver completes a lap, which means the data from API will not change during a lap, but only at the moment a lap is done by a driver. And due to this, the data will not tell how much energy was refilled in pit until the driver finished his pit-out lap. This makes the data less useful by itself.

To workaround this API limitation, a special interpolation algorithm is implemented, which enables accurate estimates to remaining energy progressively during a lap for each driver. The average accuracy of estimation is within 1%.

Some cases where interpolation may not be applied:

• Interpolation may require at least 1 full lap (not counting pit-out lap) done before it can take effect.
• During pit stop, refilled energy reading may not be updated until driver finishes his pit-out lap (as mentioned earlier), which means old energy reading persists during pit-out lap and would result wrong estimates with interpolation. For this reason, interpolation is disabled during pit-out lap.

In either case, just wait another lap and energy readings will be synchronized.

energy_remaining_decimal_places

Set additional decimals to be displayed.

Important notes on decimal place accuracy:

Currently due to known limitation from game API (as explained in User Guide), energy remaining readings from game API does not grant decimal place accuracy. The margin of error from this option can be as high as 1.0% per lap, which may not provide more accuracy than without decimals.

show_vehicle_integrity

Show opponent vehicle integrity reading.

The integrity reading is calculated from hull damage, detachable wheels and parts, and displayed as:

• Full integrity (no damage), as - (default color grey).

• High integrity (lightly damaged hull), from 9 to 5 (default color blue).

• Low integrity (severely damaged hull, and most likely has detached wheels or parts), from 4 to 0 (default color red).

  show_speed_trap Show fastest recorded speed of each driver per lap at user-defined speed trap position on track. This option can be useful to keep track of each driver's straight line performance from most recent lap.

Note, speed trap position is defined in tracks.json preset, which can be customized via Track Info Editor. Default speed trap position is set at start/finish line.

Back to Top

This widget displays steering input info.

bar_width, bar_height

Set steering bar width and height in pixels.

bar_edge_width

Set left and right edge boundary width.

manual_steering_range

Manually set steering display range in degree. Set to 0 to read physical steering range from API. This option may be useful when steering range value is not provided by some vehicles.

show_steering_angle

Show steering angle text in degree.

show_scale_mark

This enables scale marks on steering bar.

scale_mark_degree

Set gap between each scale mark in degree. Default is 90 degree. Minimum value is limited to 10 degree.

Back to Top

This widget displays virtual steering wheel.

show_custom_steering_wheel

Show user-defined custom steering wheel image instead of default image.

custom_steering_wheel_image_file

Set custom steering wheel image file path. Double-click this option in widget's Config dialog to select an image file.

Note, image file must be in PNG format with same width and height. Maximum supported PNG file size is limited to 10MB. Default image will be used if selected image is not valid.

display_size

Set widget display size in pixels.

display_margin

Set widget display margin in pixels.

show_steering_angle

Show steering angle text in degree.

manual_steering_range

Manually set steering display range in degree. Set to 0 to read physical steering range from API. This option may be useful when steering range value is not provided by some vehicles.

show_rotation_line

Show steering rotation reference line, which can be useful to see if physical steering wheel is misaligned.

show_rotation_line_while_stationary_only

Show rotation line only while vehicle is stationary (less than 1m/s).

Back to Top

This widget displays stint history info.

Note, stint history is not recorded while in garage or during formation lap.

layout

2 layouts are available: 0 = vertical layout, 1 = reversed vertical layout.

stint_history_count

Set the number of stint history display. Default is to show 2 most recent stints.

show_empty_history

Show empty stint history. Default is false, which hides empty rows.

show_laps

Show number of completed laps in the stint.

show_time

Show total driving time in the stint.

show_fuel

Show total fuel (or virtual energy) consumption in the stint.

show_virtual_energy_if_available

Show virtual energy consumption instead of fuel consumption if available. This option is enabled by default.

show_fuel_sign

Show fuel (or virtual energy) unit sign. L for liter, G for Gallon, E for virtual energy.

show_tyre

Show tyre compound used in the stint.

show_wear

Show total average tyre wear (percent) in the stint.

show_wear_sign

Show tyre wear percentage sign.

show_delta

Show lap time delta between stint best and stint average non-best lap time. Note, pit-in and pit-out laps are excluded from calculation.

show_consistency

Show lap time consistency (percent) between stint best and stint average non-best lap time. Note, pit-in and pit-out laps are excluded from calculation.

show_consistency_sign

Show consistency percentage sign.

Back to Top

This widget displays visualized suspension force and ratio info.

show_force_ratio

Show percentage force ratio between each and total suspension force. Set false to show individual suspension force in Newtons.

Back to Top

This widget displays visualized suspension position info.

position_maximum_range

Set visualized maximum display range of suspension position (millimeter).

show_third_spring_position_mark

Show front and rear third spring position mark relative to each suspension position.

show_maximum_position_range

Show a visualized line indicating maximum suspension position range under compression, which can be useful to check suspension travel limits. While this option enabled, the suspension position line will also change its color to match maximum_position_range_color when reaching maximum position. The visualized line will not be displayed if maximum position range is negative (such as with too much packers).

Note, maximum suspension position calculation is handled by Wheels Module, and is not updated while in pit lane, and resets when exiting pit lane. A minimum of two laps are required to get sensible readings.

Back to Top

This widget displays suspension travel info.

Note, suspension travel data calculation is handled by Wheels Module, and is not updated while in pit lane, and resets when exiting pit lane.

Static suspension position is measured only while car is stationary on track or in garage stall (neutral gear and no throttle). Measurement is disabled in pit lane, as car can be lifted by pit crew which would result incorrect readings.

A minimum of two laps are required to get sensible readings.

show_total_travel

Show total travel (millimeter) between minimum and maximum recorded suspension position.

show_bump_travel

Show bump travel (millimeter) between static and maximum recorded suspension position. Note, bump travel may not be available if static suspension position was not recorded.

show_rebound_travel

Show rebound travel (millimeter) between static and minimum recorded suspension position. Note, rebound travel may not be available if static suspension position was not recorded.

show_travel_ratio

Show travel ratio (percentage) between bump travel and total travel. For example, a 70% reading indicates 70% of travel is spent in bump, and 30% of travel in rebound. A 50% reading indicates equal travel in bump and rebound travel.

show_minimum_position

Show minimum recorded suspension position (millimeter) where suspension is reaching its maximum extension.

show_maximum_position

Show maximum recorded suspension position (millimeter) where suspension is reaching its maximum compression.

show_live_position

Show current suspension position (millimeter).

show_live_position_relative_to_static_position

Show current suspension position (millimeter) relative to static position instead.

Back to Top

This widget displays system performance info.

show_system_performance

Show system's overall CPU utilization (percent) and memory usage (GB). Note, sampling interval is determined by update_interval setting.

show_tinypedal_performance

Show TinyPedal's CPU utilization (percent) and memory usage (MB).

average_samples

Set number of samples for average CPU utilization calculation. Lower value may result more fluctuated reading. Set 1 to disable averaging.

Back to Top

This widget displays lap time info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_session_best

Show current session best lap time from all vehicle classes.

show_session_best_from_same_class_only

Show current session best lap time from same vehicle class only.

show_best

Show personal all time best lap time.

show_last

Show personal last lap time.

show_current

Show personal current lap time.

show_estimated

Show personal current estimated lap time.

show_session_personal_best

Show personal current session best lap time.

show_stint_best

Show personal current stint best lap time.

show_average_pace

Show personal current average lap time pace, this reading is also used in real-time fuel calculation. Note, additional average lap time pace calculation setting can be found in Delta Module config. After ESC or session ended, lap time pace reading will be reset, and aligned to all time personal best lap time if available.

Back to Top

This widget displays track clock, time scale, sunlight phase info.

show_track_clock

Show current in-game clock time of the circuit.

enable_track_clock_synchronization

Enable auto track clock and time scale synchronization. enable_restapi_access must be enabled to synchronize track clock from Rest API.

Note, synchronization may not work in multiplayer.

track_clock_time_scale

Manually set time multiplier for time-scaled session. Default is 1, which matches Time Scale: Normal setting in-game. Note, this option will only be used if enable_track_clock_synchronization option is disabled.

track_clock_format

Set track clock format string. To show seconds, add %S, such as %H:%M:%S %p. See link for full list of format codes.

show_time_scale

Show current session track clock time scale multiplier.

show_sunlight_phase_countdown

Show sunlight phase countdown timer and indicator. The timer counts down towards each of four primary sunlight phases: sunrise, midday, sunset, midnight. An arrow indicator is displayed alongside with day/night color.

This countdown timer can be used to check how long until sunrise or sunset for planning strategy.

Note, game does not provide sunrise and sunset data. Sunrise and sunset hours must be manually defined in Track Info Editor to get correct readings.

See Wiki Appendix page for sunrise and sunset reference table for some common tracks.

enable_time_scaled_countdown

Enable time scaled countdown, which scales with session track clock time scale multiplier. This option is disabled by default.

Back to Top

This widget displays track map and standings. Note: at least one complete and valid lap is required to generate track map.

display_orientation

Set track map display orientation in degrees. For example, a 270 value will rotate map by 270 degrees clockwise. Default value is 0, which always displays track map North Up in game's coordinate system.

display_detail_level

Sets detail level for track map. Default value is 1, which auto adjusts map detail according to display size. Higher value reduces map detail and RAM usage, and may also help reduce rough edges from large map. Set to 0 for full detail.

vehicle_scale, vehicle_scale_player, vehicle_scale_safety_car

Set vehicle scale that multiplies base vehicle size. Note, base vehicle size is determined by font size and bar padding. Minimum scale is limited to 1.0.

area_size

Set area display size.

area_margin

Set area margin size.

show_background

Show widget background.

show_map_background

Show background of the inner map area. This option only works for circular type tracks.

map_width

Set track map line width.

map_outline_width

Set track map outline width.

show_start_line

Show start line mark.

show_sector_line

Show sector line mark.

show_proximity_circle

Show proximity circle around player's position, which helps to quickly spot player and nearby opponents on map.

proximity_circle_radius

Set proximity circle radius in meters. Default radius is 150 meters.

show_vehicle_standings

Show vehicle standings info on track map. Note, if enable_multi_class_styling is enabled, position in class will be displayed for each vehicle class instead.

enable_multi_class_styling

Show vehicles in multi-class color styles on map instead. Multi-class color can be customized from Vehicle Class Editor.

Note, while multi-class styling is enabled, following color styles will not be displayed: vehicle_color_player, vehicle_color_leader, vehicle_color_same_lap, vehicle_color_laps_ahead, vehicle_color_laps_behind.

show_custom_player_color_in_multi_class

Show custom player vehicle color (defined in vehicle_color_player option) while enable_multi_class_styling option is enabled.

show_position_in_class

Show position in class while enable_multi_class_styling option is also enabled, otherwise this option has no effect.

show_lap_difference_outline

Show outline color based on lap difference (ahead or behind) between player and opponents. This option is disabled by default.

show_safety_car

Show safety car position on map if available. This option currently only works in RF2.

Note, safety car position data from RF2 API is fairly limited, and has a very low update rate, in order to workaround API limitation, safety car position data is interpolated to display smoothly, but may still desync occasionally.

safety_car_text

Set custom text for safety car. Default is SC.

show_pitout_prediction

Show estimated pit-out on-track position indication for each pit stop duration. Default indication shows circle with pit stop duration displayed above.

Note, pit-out position prediction is based on delta best data which scaled with player's latest lap time pace for accurate real-time position prediction under various track conditions. Pit-out prediction requires both valid track map and delta best data to display. At least one valid lap for any car and track combo is required to display pit-out prediction.

For accurate prediction, the location of pit-out line must be found first. And since each track has different pit-out line location, it is required to pit-out at least once per session to mark the correct pit-out line location. This can be easily done by driving out of pit lane.

show_pitout_prediction_while_requested_pitstop

Show estimated pit-out on-track position indication while player has requested pit stop and not in pit lane.

number_of_prediction

Set number of pit-out prediction to display. Value range is limited in 1 to 20.

pitout_time_offset

Set amount time offset (in seconds) for catching up with vehicle speed after pit-out. Default is 3 seconds.

Note, this value is important for accurate prediction, as initial vehicle speed is much slower after pit-out, so extra time is needed for driver to catch up, and also affected by pit-out line location. For most tracks, this extra time after pit-out is roughly within 1 to 5 seconds.

pitout_duration_minimum

Set pit stop duration (in seconds) of first prediction. This option has no effect if enable_fixed_pitout_prediction is enabled.

pitout_duration_increment

Set each pit stop duration (in seconds) increment after previous prediction. Default increment is 10 seconds. This option has no effect if enable_fixed_pitout_prediction is enabled.

Note, each time when pit stop duration of the nearest prediction exceeded current pit stop timer, the prediction circle will be removed, and a new prediction circle will be appended with pit stop duration increment after the last prediction.

enable_auto_pitout_prediction

Show auto-estimated pit-out duration prediction. Default indication shows as a green circle. This option does not count towards number_of_prediction limit.

Auto estimated pit-out duration is calculated in the same way as Pit Stop Estimate Widget.

Note, this option only works for LMU, and enable_restapi_access must be enabled in LMU API setting.

auto_prediction_additional_pitstop_time

Set additional pit stop time it takes to decelerate and accelerate towards and away from pit spot. This option corresponds to additional_pitstop_time option from Pit stop estimate Widget, and both should be set to same amount. Default value is 2 seconds.

enable_fixed_pitout_prediction

Show pit-out prediction based on user-defined fixed pitstop duration instead. This option overrides pitout_duration_minimum and pitout_duration_increment options.

While this option is enabled, total pit-out duration is calculated from the sum of pit-out time offset, fixed pit stop duration and estimated pit lane pass-through duration. It's required to enter and exit pit lane at least once to get correct total pit-out duration.

fixed_pitstop_duration

Set fixed amount pit stop duration (in seconds). Note, only stopped time should be considered for this option. Set to 0 if only passing through pit lane (such as Drive Through). Set to -1 to disable this option.

show_pitstop_duration

Show pit stop duration reading on top of each prediction circle.

Back to Top

This widget displays track notes, comments, debugging info.

show_background

Show background color. Turn off to show text only.

show_pit_notes_while_in_pit

Show custom notes while in pit lane.

pit_notes_text, pit_comments_text

Set custom notes and comments to be displayed while in pit lane.

show_track_notes

Show nearest track notes info behind current vehicle position.

track_notes_uppercase

Set track notes text to uppercase.

show_comments

Show nearest track notes comments info behind current vehicle position.

enable_comments_line_break

Enable line break for displaying multi-line comments. To break a line into multiple lines, add \n to any part of the comment.

show_debugging

Show nearest track notes index number behind current vehicle position, and distance value (meters) behind current position to next index position.

track_notes_width, comments_width, debugging_width

Set maximum display width, value in chars, such as 10 = 10 chars.

enable_auto_hide_if_not_available

Auto hide this widget if track notes data is not available for current track.

maximum_display_duration

Set maximum display duration (seconds) of each note. Set to -1 to always display notes. Default is -1.

Back to Top

This widget displays traffic vehicle info.

This widget is designed to show the nearest traffic vehicles that are closing in, either the slower vehicle that you are catching up ahead, or the faster vehicle that is catching up from behind.

Note, vehicles are not counted as traffic if they cannot close the gap, or while in pit lane. For example, a driver that falls constantly 3 seconds behind you is not considered as traffic since he cannot close the gap and overtake you.

bar_width

Set each column width, value in chars, such as 10 = 10 chars. Default is 6. Minimum width is limited to 3.

show_class

Show traffic vehicle class name.

show_driver_name_instead_of_class

Show driver name instead of class name.

driver_name_shorten

Shorten driver's first name.

driver_name_uppercase

Set driver name to uppercase.

show_estimated_laps

Show estimated laps towards nearest reachable traffic vehicles. Note, it may take 1 or more laps to get accurate estimates.

For example, a 2.34L value from faster column indicates the amount laps it would take for the faster vehicle that behind you to catch up with you; while same value from slower column indicates the amount laps it would take for you to catch up with the slower vehicle ahead.

enable_traffic_highlight_from_current_lap

Highlight traffic vehicles that can potentially overtake or be overtaken from current lap, which is useful to determine fuel saving strategy.

show_time_interval

Show time interval between you and traffic vehicles.

Back to Top

This widget displays pedal, steering input and force feedback plots.

display_width

Set pedal plot display width in pixels.

display_height

Set pedal plot display height in pixels.

display_margin

Set pedal plot display margin (vertical relative to pedal) in pixels.

display_scale

Set plot display scale. Default scale is 2. Minimum scale is limited to 1.

Note, when high DPI scaling mode is enabled on high resolution (2k or 4k) screen, the widget base size will also be scaled up according to system's DPI setting, which may result larger plot even when display_scale is set to 1. If smaller plot size is preferred, manually disable high DPI scaling mode via Scale button on main window status bar.

time_scale

Set plot time scale. When time scale is 1 (default), plot will be synchronized with update_interval.

Note, value less than 1 draws plot slower; higher than 1 draws plot faster. Setting this value too high or too low may result plot stuttering.

show_inverted_pedal

Invert pedal range display.

show_inverted_trailing

Invert trailing direction.

show_tc_activation

Show TC activation plot, which overlaps throttle plot when active.

show_abs_activation

Show ABS activation plot, which overlaps brake plot when active.

show_throttle

Show filtered throttle plot. Note, some vehicles may not provide filtered pedal input value, which the value will be zero.

show_raw_throttle

Show unfiltered throttle instead.

show_absolute_ffb

Convert force feedback value to absolute value before plotting. Set to false to show force feedback plot in both positive and negative range.

show_steering

Show steering plot.

show_inverted_steering

Invert steering plot direction.

show_speed

Show speed plot relative to player's top reference speed from current stint.

Note, at least one lap is required to calibrate top reference speed. Top reference speed resets when vehicle stopped on track.

*_line_width

Set trailing line width in pixels.

*_line_style

Set trailing line style. 0 for solid line, 1 for dashed line.

show_wheel_lock

Show wheel lock (slip ratio) plot under braking when slip ratio has exceeded wheel_lock_threshold value.

wheel_lock_threshold

Set percentage threshold for triggering wheel lock warning under braking. 0.3 means 30% of tyre slip ratio.

show_wheel_slip

Show wheel slip (slip ratio) plot under acceleration when slip ratio has exceeded wheel_slip_threshold value.

wheel_slip_threshold

Set percentage threshold for triggering wheel slip warning under acceleration. 0.1 means 10% of tyre slip ratio.

show_reference_line

Show reference line.

reference_line_*_offset

Set reference line vertical offset position (percentage) relative to pedal, value range in 0.0 to 1.0.

reference_line_*_style

Set reference line style. 0 for solid line, 1 for dashed line.

reference_line_*_width

Set reference line width in pixels. Set value to 0 to hide line.

display_order_*

Set display order of plot lines.

Back to Top

This widget displays tyre carcass temperature info.

Note, if temperature drops below -100 degrees Celsius, temperature readings will be replaced by unavailable sign as -.

enable_heatmap_auto_matching

Enable automatically heatmap style matching for specific tyre compounds defined in compounds.json preset. This option applies matching heatmap style to front and rear tyre compounds separately.

Note, separate compounds info for tyres on the same axle is not available from game API, which currently it is not possible to show left and right compounds separately.

heatmap_name

Set heatmap preset name that is defined in heatmap.json preset. Note, this option has no effect while enable_heatmap_auto_matching is enabled.

show_degree_sign

Set true to show degree sign for each temperature value.

leading_zero

Set amount leading zeros for each temperature value. Default is 2. Minimum value is limited to 1.

show_rate_of_change

Show carcass temperature rate of change for a specific time interval.

rate_of_change_interval

Set time interval in seconds for rate of change calculation. Default interval is 5 seconds. Minimum interval is limited to 1 second, maximum interval is limited to 60 seconds.

rate_of_change_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

show_tyre_compound

Show tyre compound symbols (front and rear) that matches specific tyre compounds defined in compounds.json preset.

show_compound_color_by_type

Show different compound color by compound type, which can be customized in Tyre Compound Editor.

Back to Top

This widget displays visualized tyre vertical deflection info.

deflection_maximum_range

Set visualized maximum tyre deflection display range (millimeter).

lift_off_threshold

Set millimeter threshold of tyre deflection for detecting lifted wheels. Default threshold is 1 millimeter.

Back to Top

This widget displays tyre inner layer temperature info.

Note, if temperature drops below -100 degrees Celsius, temperature readings will be replaced by unavailable sign as -.

enable_heatmap_auto_matching

Enable automatically heatmap style matching for specific tyre compounds defined in compounds.json preset. This option applies matching heatmap style to front and rear tyre compounds separately.

Note, separate compounds info for tyres on the same axle is not available from game API, which currently it is not possible to show left and right compounds separately.

heatmap_name

Set heatmap preset name that is defined in heatmap.json preset. Note, this option has no effect while enable_heatmap_auto_matching is enabled.

swap_style

Swap heatmap color between font and background color.

show_inner_center_outer

Set inner, center, outer temperature display mode. Set false to show average temperature instead.

show_degree_sign

Set true to show degree sign for each temperature value.

leading_zero

Set amount leading zeros for each temperature value. Default is 2. Minimum value is limited to 1.

show_tyre_compound

Show tyre compound symbols (front and rear) that matches specific tyre compounds defined in compounds.json preset.

show_compound_color_by_type

Show different compound color by compound type, which can be customized in Tyre Compound Editor.

Back to Top

This widget displays visualized tyre load and ratio info.

show_tyre_load_ratio

Show percentage load ratio between each and total tyre load. Set false to show individual tyre load in Newtons.

low_load_threshold

Show warning indication when load (in Newtons) is below the threshold.

Back to Top

This widget displays tyre pressure info.

hot_pressure_temperature_threshold

Set minimum temperature threshold (measured from tyre carcass in Celsius) for hot pressure indication. Default is 65 degrees Celsius. Default color for cold pressure is blue, and orange for hot pressure.

show_pressure_deviation

Show average tyre pressure deviation between each tyre and the tyre with highest pressure.

average_sampling_duration

Set duration (seconds) for calculating average tyre pressure. Default is 10 seconds. Maximum duration is limited to 600 seconds.

swap_style

Swap cold and hot pressure color.

show_tyre_compound

Show tyre compound symbols (front and rear) that matches specific tyre compounds defined in compounds.json preset.

show_compound_color_by_type

Show different compound color by compound type, which can be customized in Tyre Compound Editor.

Back to Top

This widget displays tyre surface temperature info.

Note, if temperature drops below -100 degrees Celsius, temperature readings will be replaced by unavailable sign as -.

enable_heatmap_auto_matching

Enable automatically heatmap style matching for specific tyre compounds defined in compounds.json preset. This option applies matching heatmap style to front and rear tyre compounds separately.

Note, separate compounds info for tyres on the same axle is not available from game API, which currently it is not possible to show left and right compounds separately.

heatmap_name

Set heatmap preset name that is defined in heatmap.json preset. Note, this option has no effect while enable_heatmap_auto_matching is enabled.

swap_style

Swap heatmap color between font and background color.

show_inner_center_outer

Set inner, center, outer temperature display mode. Set false to show average temperature instead.

show_degree_sign

Set true to show degree sign for each temperature value.

leading_zero

Set amount leading zeros for each temperature value. Default is 2. Minimum value is limited to 1.

show_tyre_compound

Show tyre compound symbols (front and rear) that matches specific tyre compounds defined in compounds.json preset.

show_compound_color_by_type

Show different compound color by compound type, which can be customized in Tyre Compound Editor.

Back to Top

This widget displays tyre wear info.

layout

2 layouts are available: 0 = vertical layout, 1 = horizontal layout.

show_remaining

Show total remaining tyre tread in percentage that changes color according to wear.

show_wear_difference

Show estimated tyre wear difference per lap (at least one valid lap is required).

show_live_wear_difference

Show current lap tyre wear difference.

show_lifespan_laps

Show estimated tyre lifespan in laps.

show_lifespan_minutes

Show estimated tyre lifespan in minutes.

show_end_stint_remaining

Show estimated total remaining tyre tread at the end of current stint, which helps to determine whether there is enough tread for current or more stints. Negative reading indicates that there will not be enough tyre tread remaining at the end of current stint.

For example, if minimum safe tyre tread is around 10%, then for triple-stint tyre saving, aim for 70% remaining tread for first stint, 40% for second stint, and 10% for third stint.

warning_threshold_remaining

Set warning threshold for total remaining tyre in percentage. Default is 30 percent.

warning_threshold_wear

Set warning threshold for total amount tyre wear of last lap in percentage. Default is 3 percent.

warning_threshold_laps

Set warning threshold for estimated tyre lifespan in laps. Default is 5 laps.

warning_threshold_minutes

Set warning threshold for estimated tyre lifespan in minutes. Default is 5 laps.

Back to Top

This widget displays virtual energy usage info.

Note, most options are inherited from Fuel widget, with some additions noted below. For battery charge usage info, see Battery widget.

show_absolute_refilling

Show absolute refilling value instead of relative refilling when enabled. Note, + or - sign is not displayed with absolute refilling.

show_fuel_ratio_and_bias

Show fuel ratio and fuel bias column.

*fuel_ratio

Show fuel ratio between estimated fuel and energy consumption, which can help balance fuel and energy usage, as well as providing refueling reference for adjusting pit stop Fuel ratio during race.

*fuel_bias

Show fuel bias (unit in laps) that calculated from estimated laps difference between fuel and virtual energy.

Positive value indicates more laps can be run on fuel than virtual energy; in other words, virtual energy will deplete sooner than fuel. For example, a value of +1.5 indicates that there will be 1.5 laps of extra fuel remaining after virtual energy depleted.

Note, depleting virtual energy could result a Stop-Go penalty in LMU; while running out of fuel means no power for vehicle and would result retirement from race. So it is a good idea to keep fuel bias close to 0.0, and slightly towards positive side to avoid depleting fuel before virtual energy.

Back to Top

This widget displays weather info.

show_temperature

Show track and ambient temperature.

decimal_places_temperature

Set amount decimal places to keep. Default is 1 decimal place, set to 0 to hide decimals. Note, when number of digits is less than expected, extra leading zero or decimal place will be added to fill the gap.

show_rain

Show rain precipitation in percentage.

show_wetness

Show average surface wetness in percentage.

show_rubber_coverage_while_dry

Show rough estimate of rubber coverage (percent) based on total number of laps done by all drivers while road surface is dry.

Note, rubber coverage reading may not be accurate during practice session in multiplayer, as some API data will be lost or reset while people joining or leaving server. This does not affect qualifying and race session.

*Note, all data from above table are rough estimate based on testing.

rubber_median_laps

Set median laps at the point when grip becomes Heavy (High) for calculating accurate rubber coverage. Default median laps is 2000. This value may vary from different games, see above table for reference.

rubber_time_scale_*

Set time scale multiplier for calculating rubber coverage in corresponding sessions (practice, qualifying, race). This value should match Realroad Time Scale session setting from game. For static rubber, set time scale to 0.

Note, since Realroad Time Scale data is not available from game API, it is required to manually set the value.

Most online servers use default 1.0 Realroad Time Scale setting during qualifying and race session, while some servers may use static setting during practice session only.

starting_rubber_*

Set starting rubber coverage (percent) in corresponding sessions (practice, qualifying, race).

Note, since session starting rubber coverage data is not available from game API, it is required to manually set the value.

show_trend

Show weather change trend for temperature, raininess, surface wetness readings.

temperature_trend_interval, raininess_trend_interval, wetness_trend_interval

Set weather change trend interval in seconds. Default interval is 60 seconds.

If weather readings increased within the interval, ▲ uparrow sign will be shown; if readings decreased within the interval, ▼ downarrow sign will be shown; If readings has not changed during the interval, ● sign will be shown after.

Back to Top

This widget displays weather forecast info.

layout

2 layouts are available: 0 = show columns from left to right, 1 = show columns from right to left. Note, the now column always shows current weather condition.

show_estimated_time

Show estimated time reading for upcoming weather. Note, estimated time reading only works in time-based race. Other race type such as lap-based race shows n/a instead.

show_ambient_temperature

Show estimated ambient temperature reading for upcoming weather. Note, the now column always shows current ambient temperature instead.

show_rain_chance_bar

Show visualized rain chance bar reading for upcoming weather. Note, the now column always shows current raininess instead.

show_rain_chance_reading

Show rain chance reading in percentage.

number_of_forecasts

Set number of forecasts to display. Value range in 1 to 4. Default is 4 forecasts.

show_unavailable_data

Show columns with unavailable weather data. Set False to auto hide columns with unavailable data. Note, auto hide only works for time-based race.

Back to Top

This widget displays weight distribution info.

Note, to get accurate static weight distribution readings, test setup on level ground.

Weight distribution is calculated from tyre load data, which may not be available from certain vehicles in game API (such as LMGT3).

To workaround this limitation, suspension load data, while not entirely the same, will be used for calculation instead.

show_front_to_rear_distribution

Show front to rear weight distribution in percentage.

show_left_to_right_distribution

Show left to right weight distribution in percentage.

show_cross_weight

Show cross weight (known as wedge) in percentage.

smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

Back to Top

This widget displays wheel camber info.

Note, all camber readings are in degrees.

show_camber_difference

Show camber difference between left and right wheel on the same axle, useful for quickly checking misalignment while driving.

camber_smoothing_samples, camber_difference_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

Back to Top

This widget displays wheel toe info.

Note, all toe readings are in degrees. Positive reading indicates toe-in; negative indicates toe-out.

show_total_toe_angle

Show total toe angle between left and right wheel on the same axle, useful for quickly checking amount total toe angle while driving.

toe_in_smoothing_samples, total_toe_angle_smoothing_samples

Set number of samples for reducing data fluctuation. Lower value may result more fluctuated reading. Set 1 to disable smoothing.

Back to Top