Torn Racing Telemetry

Enhance Torn racing with a cleaner leaderboard, realistic live telemetry, API-driven stats/history analysis, and race-result export tools.

What's New in v3.5.0

• Migrated to a modular source layout with a single-file build output for userscript deployment.
• Replaced chart-based history/stats views with fast API-first cards, timeline, and sortable tables.
• Added true paginated official-race ingestion via /user/races links.
• Redesigned expanded driver dropdown cards (desktop/mobile) and improved telemetry animation behavior.
• Reduced dead code and cleaned stale legacy paths.

Table of Contents

• Overview
• Key Features
• Enhanced Driver List
• History Panel
• Stats Panel
• Export Panel
• Settings Panel
• API Usage and Privacy
• Installation
• FAQ

Overview

Torn Racing Telemetry replaces Torn's default race list with a telemetry-first interface and adds API-powered analysis panels. It is designed for practical race-day usage: fast reads, clear comparisons, and easy export.

• Author: TheProgrammer (2782979)
• Distribution: final bundled userscript (tornracingtelemetry.js)
• Compatibility: browser userscript managers and Torn PDA flow

Key Features

Enhanced UI and Telemetry

• Optional replacement of Torn's leaderboard with always-sorted custom list.
• Live speed, acceleration, and optional progress display.
• Color-coded telemetry by acceleration/deceleration.
• Expandable per-driver detail cards with lap metrics and API racing stats.

Data and Analysis

• Stats panel with summary cards, comparison windows, and sortable track/car/race tables.
• History panel with summary cards, race-event timeline, and sortable recent-races table.
• Track and car static-data caching for faster panel loads.
• Comparison metrics tuned for limited-history windows (no hard 40-race requirement).

Export and Configuration

• Export final race results as HTML, Markdown, CSV, TXT, or JSON.
• Copy exported race data to clipboard.
• Full settings panel for telemetry, animation, smoothing, API behavior, and UI toggles.
• Torn PDA API-key placeholder auto-setup support.

Enhanced Driver List

The collapsed list keeps race order and top-line telemetry easy to scan.

Expanding a driver shows status, lap/progress cards, calculated speed/accel, estimate data, and API racing stats.

Telemetry color semantics:

• Green: positive acceleration.
• Red: braking/deceleration.
• Neutral: low/near-zero acceleration.

History Panel

The History panel loads official races from the API on open and renders summary cards plus timeline/table views.

Highlights:

• Window comparison cards (Last N vs Prev N) for position trends.
• Average skill-per-race metric across loaded history.
• Race timeline for quick event review.
• Sortable recent-races table for detailed inspection.

Stats Panel

The Stats panel focuses on performance analytics and breakdowns from official race history.

Highlights:

• Performance snapshot cards (wins, podiums, rates, best lap, etc.).
• Window-based deltas for position/win/crash/lap behavior.
• Track breakdown table and car breakdown table.
• Recent official races table with sortable columns.

Export Panel

Export final race results in multiple formats or copy the output directly.

Available formats:

• HTML Table
• Markdown Table
• CSV
• Plain Text
• JSON

Settings Panel

Configure all major behavior from one place.

Main controls:

• Enable/disable History and Stats panels.
• Telemetry display options (speed, acceleration, progress).
• Speed unit, color coding, animation toggle, smoothing values.
• API key, API stats-on-click toggle, and race analysis limit.
• Hide/show Torn's original leaderboard.

API Usage and Privacy

This script stores settings and API key locally in userscript storage and only sends API requests to Torn's official API.

Item	Behavior
Data storage	Local only
Data sharing	None
API destination	api.torn.com only
Typical key level	Limited Access (custom selections)
Required selections	user (personalstats, races), racing (tracks, cars, records)

Installation

1. Install a userscript manager (Tampermonkey or Violentmonkey).
2. Install the script from GreasyFork: https://greasyfork.org/en/scripts/522245-torn-racing-telemetry
3. Open Torn racing page and configure settings.
4. Add API key for full Stats/History/driver API features.
5. Torn PDA users can use the managed placeholder flow (###PDA-APIKEY###).

FAQ

Does this break Torn rules?

No. It is a UI enhancement script using Torn's public API endpoints.

Is my API key safe?

The key is stored locally in userscript storage and used only for Torn API requests.

Why do I need an API key?

Core on-page telemetry works without it, but Stats panel, History panel, and per-driver API stats require it.

Why can Avg Pos Delta be red when it is positive?

Because lower finishing position is better. A positive delta means average finishing position number increased (worse performance).

What if the script looks stale after update?

Hard refresh the page first. If needed, use Settings -> Clear Script Data.