JHHM

dedit

a tool for Teeworlds demo file shenanigens
git clone https://jhhm.no/repos/dedit.git

dedit/dedit.1

get raw file: dedit.1

1.\" This file is part of dedit - a tool for editing Teeworlds/DDNet demo files
2.\" Copyright (C) 2026 JHHM
3.\"
4.\" Dedit is free software: you can redistribute it and/or modify
5.\" it under the terms of the GNU General Public License as published by
6.\" the Free Software Foundation, either version 3 of the License, or
7.\" (at your option) any later version.
8.\"
9.\" Dedit is distributed in the hope that it will be useful,
10.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12.\" GNU General Public License for more details.
13.\"
14.\" You should have received a copy of the GNU General Public License
15.\" along with dedit.  If not, see <https://www.gnu.org/licenses/>.
16.TH DEDIT 1 "October 7. 2026" "dedit" "User Commands"
17.SH NAME
18dedit \- edit Teeworlds/DDNet demo files
19.SH SYNOPSIS
20.B dedit
21.I demo
22.RI [ OPTIONS ]
23.SH DESCRIPTION
24.B dedit
25is a tool for editing Teeworlds and DDNet demo files.
26
27The input demo file is specified by the
28.I demo
29argument.
30
31For options taking an
32.I ID/NAME
33argument, if the value is numeric,
34.B dedit
35first attempts to interpret it as a player ID. If no matching player ID
36is found, it falls back to treating the value as a player name.
37.SH ARGUMENTS
38.TP
39.I demo
40Input demo file.
41.SH OPTIONS
42.TP
43.BR \-r ", " \-\-rename " " \fIID/NAME\fR " " \fINAME\fR
44Rename the player identified by
45.I ID/NAME
46to
47.IR NAME .
48.TP
49.BR \-s ", " \-\-skin " " \fIID/NAME\fR " " \fISKIN\fR
50Set the skin of the player identified by
51.I ID/NAME
52to
53.IR SKIN .
54.TP
55.BR \-m ", " \-\-map " " \fIMAP\fR
56Change the map of the demo to the map file
57.IR MAP .
58This will only produce sensible results if the replacement map has the
59same game layer(s) as the original map.
60.TP
61.BR \-M ", " \-\-merge " " \fIDEMO\fR
62Merge the game data of
63.I DEMO
64into the input demo. Ment for merging demos from the same round to create
65a demo with data from both demos. The point of view is the input demo where it 
66has data, and 
67.I DEMO
68elsewhere. Can be given multiple times to merge several demos.
69.TP
70.BR \-o ", " \-\-output " " \fIFILE\fR
71Write the modified demo to
72.IR FILE .
73.TP
74.BR \-e ", " \-\-extract-map " " \fIFILE\fR
75Extract the embedded map from the demo and save it to
76.IR FILE .
77.TP
78.BR \-c ", " \-\-chat
79Print the demo chat log. Tries to in reproduce the same output
80as the DDNet tool
81.BR demo_extract_chat .
82.TP
83.BR \-i ", " \-\-info
84Print the demo header and chunk totals.
85.TP
86.BR \-I ", " \-\-extended-info
87Print the demo header and every information for every chunk in the demo.
88.TP
89.BR \-h ", " \-\-help
90Display help information and exit.
91.SH EXAMPLES
92Rename player with name \fINew Hero\fR to \fIholymadtee\fR.
93Save the result to \fIout.demo\fR.
94.RS
95.B $ dedit demo.demo --rename \(dqNew Hero\(dq holymadtee --output out.demo
96.RE
97
98Change the demo map to \fIfng_AB_1.map\fR, and change the skin of player
99with ID \fI3\fR to \fIbrownbear\fR. Save the result to \fInew.demo\fR.
100.RS
101.B $ dedit demo.demo -m fng_AB_1.map -s 3 brownbear -o new.demo
102.RE
103
104Merge the demo \fIother.demo\fR, recorded by another player on the same
105server, into \fIdemo.demo\fR. Save the result to \fImerged.demo\fR.
106.RS
107.B $ dedit demo.demo --merge other.demo --output merged.demo
108.RE
109
110Extract the embedded map into file \fImesa.map\fR.
111.RS
112.B $ dedit demo.demo --extract-map mesa.map
113.RE
114.SH EXIT STATUS
115.TP
116.B 0
117Success.
118.TP
119.B >0
120An error occurred.
121.SH COPYING
122Copyright (C) 2026 JHHM.
123
124License GPLv3+: GNU GPL version 3 or later
125<https://gnu.org/licenses/gpl.html>.
126
127This is free software: you are free to change and redistribute it.
128There is NO WARRANTY, to the extent permitted by law.
129.SH AUTHORS
130Written by JHHM.
131
132More information about
133.B dedit
134can be found at: <https://jhhm.no/repos/dedit/>
135.SH SEE ALSO
136.BR DDNet (6),