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),