CS2 DemoTracer

Analyze Counter-Strike 2 demos, export selected rounds, and replay them through bots on a local server.

Download for Windows · Documentation · Development

_{Inspect a converted match, choose where playback starts, and copy the ready-to-run server command.}

From Demo to Replay

DemoTracer is a matched Windows desktop app and CS2 playback bundle. Parsing, analysis, conversion, archive management, environment checks, and updates are handled from one GUI:

1. Analyze one demo or import up to eight demos as a batch. Split match recordings are recognized and merged automatically.
2. Select the rounds and fidelity options you want. DemoTracer reports suspicious rounds and warns when the source demo lacks replay input data.
3. Organize converted matches in a searchable local library by map, team, player, date, platform, and notes.
4. Replay a single round or a sequence through bots, using commands built by the app for the matched server plugin.

Parsing and export run locally through the Rust backend linked into the desktop app. There is no separate converter CLI to install or maintain.

Desktop Workflow

_{Keep converted matches in a searchable local replay library.}

The library can import existing archives, repair metadata, reconnect moved source demos, and preserve custom notes. Opening a match exposes its score, roster, round timeline, playback presets, and generated commands.

_{Review demo-backed player identities, loadouts, stickers, charms, knives, gloves, and weapon finishes.}

Cosmetic and identity data is evidence-gated: DemoTracer preserves what the demo actually contains and avoids inventing missing values. Selected items can also be handed off to the supported Inventory Simulator workflow.

What Can Be Replayed

Depending on the source demo and selected options, a replay can preserve:

• movement, view angles, buttons, and available subtick input;
• weapons, purchases, drops, shooting history, and grenade throws;
• freeze-time pre-roll, score, names, team presentation, chat, and optional voice;
• demo-backed avatars, agents, crosshairs, viewmodels, knives, gloves, weapon finishes, stickers, charms, music kits, and scoreboard details.

Movement playback uses maintained movement and input hooks rather than teleporting bots along a drawn route. If a source demo omits essential raw input, the desktop app reports that limitation before conversion.

Playback Results

First-person route replay	Indoor route replay
Mirage multi-bot opening	Projectile-aligned Mirage smokes

Get Started

Download the two Windows x64 assets from the latest official release:

• demotracer-gui-vVERSION.exe — desktop installer.
• demotracer-css-vVERSION.zip — matched playback plugins and native runtimes.

The desktop app supports Windows 10 and Windows 11 x64 and requires Microsoft Edge WebView2. Demo analysis, conversion, and library management do not require Python, Node.js, Rust, .NET, or a running CS2 server after installation.

To play an exported replay, use a local Windows x64 CS2 server with Metamod:Source and CounterStrikeSharp. In Settings → Install & environment, select the CS2 folder, inspect the installation, and install the matched playback bundle.

Local-First and Defensive

• Demo parsing, replay generation, archives, configuration, and logs stay on the local machine.
• Optional update, Steam profile, and anonymous telemetry behavior is documented in Online behavior and Telemetry.
• Replay control is for bots on a local server and must never be assigned to human players. DemoTracer is not matchmaking or cheating software.
• Desktop releases, playback bundles, .dtr files, manifests, runtimes, and companion APIs are versioned together.

Only artifacts attached by unicbm to this repository's GitHub Releases are official builds. See the Trademark and Official Build Policy.

Documentation

• User documentation — product guides and maintained references.
• Commands — playback commands, options, and runtime defaults.
• .dtr format — binary layout, validation, and decoder limits.
• Development — architecture, source builds, validation, native tooling, and release packaging.
• Contributing — contribution workflow and repository boundaries.

Credits and License

DemoTracer builds on CS2-Bot-Controller, CS2-Bot-Hider, demoparser, minidemo-encoder, Metamod:Source, and CounterStrikeSharp. minidemo-encoder provided an early foundation for reconstructing continuous movement from discrete demo trajectories.

First-party source is licensed under AGPL-3.0-only. Vendored components and datasets retain their recorded licenses and attribution. The code license does not grant rights to misrepresent modified builds as official releases.

Selected information-layout and demo-presentation references draw from CS2 Insight Agent under direct, paid, project-specific authorization from DrEAmSs59. The original reference material remains the property of that project and is not granted to third parties under DemoTracer's AGPL-3.0-only license. See the maintained source and authorization notice.