Skip to content

Commit 2990d01

Browse files
committed
Add FAQ page for RacePulse, covering setup, supported games, widgets, and troubleshooting
1 parent b6bc400 commit 2990d01

1 file changed

Lines changed: 231 additions & 0 deletions

File tree

site/content/faq.md

Lines changed: 231 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,231 @@
1+
---
2+
title: "FAQ"
3+
subtitle: "Frequently asked questions about RacePulse — setup, supported games, widgets, troubleshooting, and more."
4+
description: "Answers to common questions about RacePulse: free sim racing telemetry overlay for iRacing, ACC, Assetto Corsa, Le Mans Ultimate, F1 25, and F1 24."
5+
ogImage: "assets/application-preview.gif"
6+
---
7+
8+
<script type="application/ld+json">
9+
{
10+
"@context": "https://schema.org",
11+
"@type": "FAQPage",
12+
"mainEntity": [
13+
{
14+
"@type": "Question",
15+
"name": "Is RacePulse free?",
16+
"acceptedAnswer": {
17+
"@type": "Answer",
18+
"text": "Yes. RacePulse is completely free with no subscription, no trial period, and no locked features. Every widget and every supported game is available at no cost."
19+
}
20+
},
21+
{
22+
"@type": "Question",
23+
"name": "What sim racing games does RacePulse support?",
24+
"acceptedAnswer": {
25+
"@type": "Answer",
26+
"text": "RacePulse supports six games: iRacing, Assetto Corsa Competizione (ACC), Assetto Corsa, Le Mans Ultimate (LMU), F1 25, and F1 24. iRacing, ACC, AC, and LMU use Windows shared memory (no setup needed). F1 25 and F1 24 use UDP telemetry (one-time toggle in game settings)."
27+
}
28+
},
29+
{
30+
"@type": "Question",
31+
"name": "Do I need to install plugins or configure anything?",
32+
"acceptedAnswer": {
33+
"@type": "Answer",
34+
"text": "For iRacing, ACC, and Assetto Corsa — no. RacePulse detects these games automatically via shared memory. For Le Mans Ultimate, you need to enable the Plugins option in Settings > Gameplay (one-time). For F1 25 and F1 24, you need to enable UDP Telemetry in the game's settings (one-time)."
35+
}
36+
},
37+
{
38+
"@type": "Question",
39+
"name": "Does RacePulse work in VR?",
40+
"acceptedAnswer": {
41+
"@type": "Answer",
42+
"text": "RacePulse overlays are standard Windows windows, so they appear on your desktop monitor rather than inside a VR headset. If your sim supports a desktop mirror or spectator view, the overlays will be visible there. For in-headset overlays, you would need a VR overlay tool like OVR Toolkit to bring the RacePulse widgets into your VR environment."
43+
}
44+
},
45+
{
46+
"@type": "Question",
47+
"name": "How many widgets does RacePulse have?",
48+
"acceptedAnswer": {
49+
"@type": "Answer",
50+
"text": "RacePulse has 12 overlay widgets: Speed, Gear, RPM, Lap Time, Delta, Inputs, Fuel, G-Force, Telemetry Core (all-in-one display), Inputs Telemetry (scrolling input graph), Flat Track Map (car positions on track), and Relative (nearby drivers with gap times — iRacing only)."
51+
}
52+
},
53+
{
54+
"@type": "Question",
55+
"name": "Does RacePulse require an installer?",
56+
"acceptedAnswer": {
57+
"@type": "Answer",
58+
"text": "No. RacePulse is a single portable executable (about 21MB). Download RacePulse.exe, run it, and you're ready. No installation, no dependencies, no runtime to install."
59+
}
60+
},
61+
{
62+
"@type": "Question",
63+
"name": "What operating system does RacePulse run on?",
64+
"acceptedAnswer": {
65+
"@type": "Answer",
66+
"text": "RacePulse runs on Windows 10 and Windows 11 (64-bit). iRacing, ACC, Assetto Corsa, and Le Mans Ultimate support is Windows-only because those games use Windows shared memory. F1 25 and F1 24 use UDP which is cross-platform in principle, but the overlay windows currently require Windows."
67+
}
68+
},
69+
{
70+
"@type": "Question",
71+
"name": "Will RacePulse affect my game performance?",
72+
"acceptedAnswer": {
73+
"@type": "Answer",
74+
"text": "RacePulse is designed to be lightweight. It reads telemetry from shared memory or UDP — both are passive, read-only operations that add no load to the game itself. Each widget runs as a small transparent window. Most users see no measurable FPS impact."
75+
}
76+
},
77+
{
78+
"@type": "Question",
79+
"name": "Can I use RacePulse while streaming?",
80+
"acceptedAnswer": {
81+
"@type": "Answer",
82+
"text": "Yes. RacePulse widgets are standard windows that appear in OBS window and game captures. If you use Game Capture in OBS, you may need to add each widget as a separate Window Capture source, or switch to Display Capture to pick them up automatically."
83+
}
84+
},
85+
{
86+
"@type": "Question",
87+
"name": "How do I update RacePulse?",
88+
"acceptedAnswer": {
89+
"@type": "Answer",
90+
"text": "Download the latest RacePulse.exe from the releases page and replace your existing file. Widget positions, sizes, and settings are stored separately and will be preserved across updates."
91+
}
92+
}
93+
]
94+
}
95+
</script>
96+
97+
## General
98+
99+
### Is RacePulse free?
100+
101+
Yes. RacePulse is completely free — no subscription, no trial period, no premium tier, and no locked features. Every widget and every supported game is available at no cost.
102+
103+
### Does RacePulse require an installer?
104+
105+
No. RacePulse is a single portable executable, about 21MB. Download `RacePulse.exe`, run it, and you're ready. No installation wizard, no runtime dependencies, no `.NET` or `Java` to install.
106+
107+
### What operating system does RacePulse run on?
108+
109+
Windows 10 and Windows 11 (64-bit). iRacing, ACC, Assetto Corsa, and Le Mans Ultimate support is Windows-only because those games use Windows shared memory for telemetry. F1 25 and F1 24 use UDP which is cross-platform in principle, but the overlay windows currently require Windows.
110+
111+
### How do I update RacePulse?
112+
113+
Download the latest `RacePulse.exe` from the [Releases page](https://github.com/gAlexander77/racepulse-release/releases) and replace your existing file. Widget positions, sizes, and all customized settings are stored separately in `~/.racepulse/` and will be preserved across updates.
114+
115+
---
116+
117+
## Supported Games
118+
119+
### What sim racing games does RacePulse support?
120+
121+
RacePulse supports six games:
122+
123+
- [**iRacing**](/iracing-overlay/) — Windows shared memory, no setup needed
124+
- [**Assetto Corsa Competizione**](/acc-overlay/) — Windows shared memory, no setup needed
125+
- [**Assetto Corsa**](/assetto-corsa-overlay/) — Windows shared memory, no setup needed
126+
- [**Le Mans Ultimate**](/lmu-overlay/) — rFactor 2 shared memory plugin, enable Plugins in LMU settings once
127+
- [**F1 25**](/f1-25-overlay/) — UDP telemetry on port 22025, enable in game settings once
128+
- [**F1 24**](/f1-24-overlay/) — UDP telemetry on port 22024, enable in game settings once
129+
130+
### Do I need to install plugins or configure anything?
131+
132+
For **iRacing, ACC, and Assetto Corsa** — no. RacePulse detects these games automatically via shared memory with zero configuration.
133+
134+
For **Le Mans Ultimate** — one-time step: go to **Settings > Gameplay** and enable **Plugins**. This activates the rFactor 2 shared memory plugin that RacePulse reads from.
135+
136+
For **F1 25 and F1 24** — one-time step: go to **Settings > Telemetry Settings** and set **UDP Telemetry** to **On**. The default UDP port (22025 for F1 25, 22024 for F1 24) works automatically.
137+
138+
### Can I switch between games without reconfiguring?
139+
140+
Yes. RacePulse auto-detects which supported game is currently running. Close one sim, launch another, and RacePulse connects to the new game automatically. Your widget layout and settings carry over between games.
141+
142+
### Does RacePulse work with iRacing in VR?
143+
144+
RacePulse overlays are standard Windows windows that appear on your desktop monitor, not inside the VR headset. If you use a desktop mirror or spectator view, overlays will be visible there. To bring RacePulse widgets into your VR environment, you can use a VR overlay tool like **OVR Toolkit** or **Desktop+** to project the windows into headset space.
145+
146+
---
147+
148+
## Widgets
149+
150+
### How many widgets does RacePulse have?
151+
152+
RacePulse has **12 overlay widgets**:
153+
154+
- **Core (8):** Speed, Gear, RPM, Lap Time, Delta, Inputs, Fuel, G-Force
155+
- **Advanced (4):** Telemetry Core (all-in-one display), Inputs Telemetry (scrolling input graph), Flat Track Map (car positions), Relative (nearby drivers with gaps)
156+
157+
See the full [features page](/features/) for details on each widget.
158+
159+
### Do all widgets work with every game?
160+
161+
Most widgets work across all six supported games. Two exceptions:
162+
163+
- **Relative** — iRacing only (requires iRating, safety rating, and license class data)
164+
- **Flat Track Map** — iRacing, Le Mans Ultimate, and F1 only (requires per-car position data)
165+
166+
All other widgets work identically across iRacing, ACC, Assetto Corsa, LMU, F1 25, and F1 24.
167+
168+
### Can I customize widget appearance and behavior?
169+
170+
Yes. Every widget has per-instance settings:
171+
172+
- **Units** — km/h or mph for speed, Celsius or Fahrenheit for temperatures
173+
- **Visibility toggles** — show or hide individual display elements
174+
- **Frame rate** — 60, 30, or 15 FPS per widget
175+
- **Position and size** — drag to reposition in Edit Mode, resize as needed
176+
177+
All settings persist across sessions automatically. You can reset any widget to defaults through the customization panel.
178+
179+
### How do I reposition widgets on screen?
180+
181+
Click **Edit Mode** in the RacePulse dashboard. Widgets become draggable — move them anywhere on your screen. Click Edit Mode again to lock them in place with click-through enabled so they don't interfere with your game.
182+
183+
---
184+
185+
## Performance & Streaming
186+
187+
### Will RacePulse affect my game performance?
188+
189+
RacePulse is designed to be lightweight. It reads telemetry passively — shared memory reads and UDP packet reception add no processing load to the game itself. Each widget runs as a small transparent window. Most users see no measurable FPS impact.
190+
191+
### Can I use RacePulse while streaming or recording?
192+
193+
Yes. RacePulse widgets are standard windows that appear in OBS and other capture tools.
194+
195+
- **Display Capture** in OBS picks up widgets automatically
196+
- **Game Capture** may not show widgets — add each widget as a separate **Window Capture** source, or switch to Display Capture
197+
- Widgets have transparent backgrounds, so they overlay cleanly in both the game and the stream
198+
199+
### Does RacePulse send data to the internet?
200+
201+
RacePulse reads telemetry locally from your machine (shared memory or localhost UDP). It does not send your telemetry data, lap times, or any racing data to external servers. The only network activity is checking for updates and anonymous usage analytics (page views), both of which can be blocked by a firewall if preferred.
202+
203+
---
204+
205+
## Troubleshooting
206+
207+
### RacePulse doesn't detect my game
208+
209+
- Make sure you are **in a session** (on track or in replay), not in the main menu — shared memory is only populated while on track
210+
- For **Le Mans Ultimate**: verify that **Settings > Gameplay > Enable Plugins** is turned on
211+
- For **F1 25/F1 24**: verify that **UDP Telemetry** is enabled in the game's Telemetry Settings
212+
- Check that the RacePulse dashboard shows "Searching" — if it shows "Disconnected," click Connect
213+
214+
### Overlays don't appear on screen
215+
216+
- Make sure at least one widget is **enabled** (toggled on) in the dashboard
217+
- Try toggling **Edit Mode** on and off
218+
- Run your game in **Borderless Windowed** mode for best overlay compatibility
219+
- If using multiple monitors, check that widgets aren't positioned on a different display
220+
221+
### Windows SmartScreen blocks RacePulse
222+
223+
On first launch, Windows may show a SmartScreen warning because the app is not code-signed. Click **"More info"** then **"Run anyway"**. This only happens once.
224+
225+
### Widgets show stale data after closing a game
226+
227+
RacePulse automatically disconnects after approximately 10 seconds of no telemetry data. You can also click **Disconnect** manually in the dashboard to clear stale data immediately.
228+
229+
---
230+
231+
Still have questions? Open an issue on [GitHub](https://github.com/gAlexander77/racepulse-release/issues) or check the [installation guide](/install/) for step-by-step setup instructions.

0 commit comments

Comments
 (0)