blob: c7f0b4589d0ba775c71d7abd8cac74f641af2d3c (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
# cs2pov
Record a specific player's POV from Counter-Strike 2 demo files.
## Installation
```bash
# Install Python dependencies
pip install -e .
# System dependencies (Gentoo)
emerge -av media-video/ffmpeg
# System dependencies (Debian/Ubuntu)
apt install ffmpeg
```
## Quick Start
```bash
# List players in a demo
cs2pov list /path/to/demo.dem
# Record a player's POV
cs2pov -d /path/to/demo.dem -p "PlayerName" -o recording.mp4
```
## Usage
```
cs2pov [-h] --demo DEMO --player PLAYER --output OUTPUT [options]
```
### Required Arguments
| Argument | Short | Description |
|----------|-------|-------------|
| `--demo` | `-d` | Path to demo file (.dem) |
| `--player` | `-p` | Player to record (name or SteamID) |
| `--output` | `-o` | Output video file path |
### Optional Arguments
| Argument | Short | Default | Description |
|----------|-------|---------|-------------|
| `--resolution` | `-r` | 1920x1080 | Recording resolution |
| `--framerate` | `-f` | 60 | Recording framerate |
| `--no-hud` | | off | Hide HUD elements (except killfeed) |
| `--display` | | 0 | X display number (0 = real display) |
| `--cs2-path` | | auto | Path to CS2 installation |
| `--verbose` | `-v` | off | Verbose output |
| `--version` | | | Show version |
### Player Identification
The `--player` argument accepts multiple formats:
- **Player name**: `"PlayerName"` (case-insensitive, partial match supported)
- **SteamID64**: `76561198012345678`
- **SteamID**: `STEAM_0:1:12345678`
- **SteamID3**: `[U:1:12345678]`
### Subcommands
#### `list` - List players in a demo
```bash
cs2pov list /path/to/demo.dem
```
Shows all players with their names, teams, and SteamIDs.
## Examples
```bash
# Basic recording
cs2pov -d match.dem -p "s1mple" -o s1mple_pov.mp4
# Record by SteamID
cs2pov -d match.dem -p 76561198012345678 -o recording.mp4
# Higher resolution, lower framerate
cs2pov -d match.dem -p "Player" -o out.mp4 -r 2560x1440 -f 30
# Hide HUD, verbose output
cs2pov -d match.dem -p "Player" -o out.mp4 --no-hud -v
# Custom CS2 installation path
cs2pov -d match.dem -p "Player" -o out.mp4 --cs2-path /mnt/games/SteamLibrary/steamapps/common/Counter-Strike\ Global\ Offensive
# Use virtual display (experimental, may not work with Vulkan)
cs2pov -d match.dem -p "Player" -o out.mp4 --display 99
```
## Environment Variables
| Variable | Description |
|----------|-------------|
| `CS2_PATH` | Path to CS2 installation (alternative to `--cs2-path`) |
```bash
export CS2_PATH="/mnt/games/SteamLibrary/steamapps/common/Counter-Strike Global Offensive"
cs2pov -d match.dem -p "Player" -o out.mp4
```
## Known Issues
### Recording Uses Your Real Display
CS2 requires Vulkan, and virtual framebuffers (Xvfb) don't support Vulkan. The tool defaults to `--display 0` (your real display), which means:
- CS2 will take over your screen during recording
- You can't use your computer while recording
- No need to restart your window manager or display server
If you try `--display 99` (virtual display), you'll see: "The selected graphics queue does not support presenting a swapchain image"
### Close CS2 Before Recording
Steam prevents running multiple CS2 instances. Close any running CS2 before using cs2pov.
### Camera May Drift During Rounds
CS2 doesn't support tick-accurate command injection (VDM files). The camera is locked to the target player at demo start but may drift during round transitions.
## How It Works
1. **Parse demo** - Extract player list and metadata using demoparser2
2. **Generate config** - Create CS2 CFG file with spectator settings
3. **Copy demo** - Place demo in CS2's replays directory
4. **Start capture** - Launch FFmpeg to record the display
5. **Launch CS2** - Start CS2 with the generated config
6. **Wait** - CS2 plays the demo and exits automatically
7. **Finalize** - Stop capture and save video
## Requirements
- **Python 3.10+**
- **CS2** installed via Steam
- **FFmpeg** for video capture
- **GPU** with Vulkan support (NVIDIA or AMD)
## License
MIT
|
