TinyPedal

TinyPedal is an open-source overlay application for racing simulation.

Currently supports rFactor 2.

Download - Quick Start - FAQ - User Guide - Run on Linux

Requirements

TinyPedal requires The Iron Wolf’s rF2 Shared Memory Map Plugin, download it from:
https://forum.studio-397.com/index.php?threads/rf2-shared-memory-tools-for-developers.54282/
The plugin file rFactor2SharedMemoryMapPlugin64.dll should be placed in rFactor 2\Bin64\Plugins folder. This plugin also comes with some of the popular rF2 Apps, check rFactor 2\Bin64\Plugins folder first to see if it was installed already.
Set rFactor 2 display mode to Borderless or Windowed mode. Fullscreen mode is not supported.

Quick Start

Download latest TinyPedal version from Releases page, extract and run tinypedal.exe.
Alternatively, run TinyPedal from source, see Run from source section for details.
For Linux user, please follow Running on Linux section for instruction.
A tray icon will appear at system tray. If not shown, check hidden tray icon. Right Click on tray icon will bring up context menu.
Launch rFactor 2, overlay will appear once vehicle is on track, and auto-hide otherwise. Auto-hide can be toggled On and Off by clicking Auto Hide from tray menu.
Overlay can be Locked or Unlocked by clicking Lock Overlay from tray menu. While Unlocked, click on overlay to drag around.
Widgets can be Enabled or Disabled by clicking Config and open main window from tray menu.
To quit APP, Right Click on tray icon and select Quit; or, click Overlay menu from main window and select Quit.

Run from source

Dependencies:

Python 3.8 or higher
PySide2
pyRfactor2SharedMemory
psutil

Steps:

Download source code from Releases page; or click Code button at the top of repository and select Download ZIP; or use Git tool to clone this repository.
Download this forked version of pyRfactor2SharedMemory source code from:
https://github.com/s-victor/pyRfactor2SharedMemory
It includes a few required changes for TinyPedal.
Extract TinyPedal source code ZIP file. Then extract pyRfactor2SharedMemory ZIP file and put pyRfactor2SharedMemory folder in the root folder of TinyPedal.
Install additional dependencies by using command:
pip3 install PySide2 psutil
To start TinyPedal, type command from root folder:
python run.py
(TinyPedal is currently tested on Python 3.8+)

Note: if using Git tool to clone this repository, run command with --recursive to also clone submodule, such as:
git clone --recursive https://github.com/s-victor/TinyPedal.git

Build executable for Windows

Executable file can be built with py2exe.

To install py2exe, run command:
pip3 install py2exe

To build executable file, run command:
python freeze_py2exe.py

After building completed, executable file can be found in dist\TinyPedal folder.

Note: the build script only supports py2exe v0.12.0.0 or higher.

Running on Linux

The procedure described in the Run from source section is mostly valid, except some differences in the dependencies, and that no executable can be built. The differences are explained here.

Configuration and data files will be stored in the defined user-specific directories, usually at $HOME/.config/TinyPedal/ and $HOME/.local/share/TinyPedal/ respectively.

The required Python packages are PySide2, psutil and pyxdg. Most distros name the package with a prefix, like python3-pyside2, python3-psutil and python3-pyxdg.

Some distros split PySide2 in subpackages. If you don't find python3-pyside2 then you should install python3-pyside2.qtgui and python3-pyside2.qtwidgets.

Alternatively, you can install them using pip3 but this will bypass your system package manager and it isn't the recommended option. The command to install the dependencies with this method is:

pip3 install PySide2 psutil pyxdg

The Iron Wolf's rF2 Shared Memory Map Plugin has to be replaced with this fork for Wine.

To start TinyPedal type the following command:
./run.py

Installation

Once you have a working instance of TinyPedal, created using the git command or by unpacking the Linux release file, you can run the install script to install or update TinyPedal on your system.

The install script will create a desktop launcher and will make TinyPedal available as a command from the terminal.

The files will be installed at the /usr/local/ prefix. You'll need appropriate permissions to write there, for example, by using sudo.

You can run the script as (it doesn't support any arguments or options):
sudo ./install.sh

Known issues

Widgets don't appear over the game window in KDE. Workaround: enable bypassing the window manager in the menu Config -> Compatibility.
Transparency of widgets doesn't work when desktop compositing is disabled. Workaround: enable window manager compositing in your DE.

License

TinyPedal is licensed under the GNU General Public License v3.0 or later. See LICENSE.txt for full text.

TinyPedal icon, as well as image files located in images folder, are licensed under CC BY-SA 4.0.

Licenses and notices file for third-party software are located in docs\licenses folder, see THIRDPARTYNOTICES.txt file for details.

Credits

See docs\contributors.md file for full list of contributors.