#ddnet #teehistorian #twgame

app tee-hee

Replay, index and detect bugs in DDNet Teehistorian files

15 releases (5 breaking)

0.5.3 Nov 26, 2024
0.5.2 Nov 17, 2024
0.4.1 Nov 6, 2024
0.3.6 Nov 6, 2024
0.0.1 Apr 2, 2024

#1068 in Command line utilities

Download history 4/week @ 2024-09-21 8/week @ 2024-09-28 617/week @ 2024-10-12 140/week @ 2024-10-19 100/week @ 2024-10-26 517/week @ 2024-11-02 120/week @ 2024-11-09 210/week @ 2024-11-16 158/week @ 2024-11-23 36/week @ 2024-11-30

593 downloads per month

AGPL-3.0-only

610KB
12K SLoC

Tee-Hee

Replay, index and detect bugs in DDNet Teehistorian files.

Tee-Hee transparently decompresses (.xz, .zst) Teehistorian files. Some commands require an index to efficiently go through all or a subset of Teehistorian files. To index Teehistorian files they need to be named in the form "{game_uuid}.teehistorian{,.xz,.zst}". After a Teehistorian file got indexed, Tee-Hee expects the file to stay at its location.

Usage: tee-hee <COMMAND>

Commands:
  replay                 Replays Teehistorian file, generates DDNet demo file
  cat                    Prints Teehistorian header and all Teehistorian chunks
  header                 Prints Teehistorian header
  run                    Indexes new files from passed directory and runs all world implementations on all indexed Teehistorian files
  index                  Indexes new files from passed directory
  select                 Selects Teehistorian files from the index based on specified criteria
  select-replay          Replays Teehistorian files selected from the index based on specified criteria
  status                 Prints current status of replayed runs via `tee-hee run`
  maps-rename-to-sha256  Helper command to create a map cache compatible with Tee-Hee
  help                   Print this message or the help of the given subcommand(s)

Install

On Debian 12:

  1. Install dependencies: sudo apt install pkg-config libssl-dev cmake rustc-web
  2. Install tee-hee either
    1. from crates.io: cargo install --locked tee-hee
    2. from master (clone of the repository required):
      • git clone https://gitlab.com/ddnet-rs/twgame.git
      • cd twgame
      • cargo install --locked --path tee-hee/
  3. Make sure ~/.cargo/bin is in your path.

Uninstall

Removing the binary and the data directory:

rm ~/.cargo/bin/tee-hee
rm -r ~/.local/share/tee-hee

Dependencies

~49–69MB
~1M SLoC