Skip to content
Training Software for the game Team Fortress 2
C++ C Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Unity crashes circleci sometimes Aug 6, 2019
.github/ISSUE_TEMPLATE Update issue templates Nov 11, 2018
class_dumping More camelCase May 8, 2018
config_data rename install_data to config_data Aug 10, 2019
external remove online Oct 26, 2019
include remove online variables Oct 26, 2019
lib fix a preload issue Aug 25, 2019
modules Add support for third-party modules Dec 16, 2018
scripts update comments for scripts Oct 27, 2019
src Fix catbots getting stuck while respawning Oct 26, 2019
.autotools warning bleeding edge (Also backtrack aimbot works properly now) Aug 13, 2018
.clang-format Clang format changes May 20, 2019
.gitignore Autobackstab.cpp: Improve rage/low latency backtrack autobackstab May 19, 2019
CMakeLists.txt remove online Oct 26, 2019 fix dynamic and dummy headers Mar 29, 2018 Rename latest to stable Oct 24, 2019
LICENSE fix dynamic and dummy headers Mar 29, 2018 Update Oct 15, 2019
TODO Add more very useful stuff like Gravity compensation on building aimb… Sep 29, 2018
Toolchain-cross-m32.cmake Ensure 32 bit libraries are used Jun 21, 2019
attach Add option to disable TUI Sep 30, 2019
attach-gdb Add option to disable TUI Sep 30, 2019 Add option to disable TUI Sep 30, 2019
build_names Engie mode Aug 20, 2018 Added introduction to contributing and updated readme Nov 16, 2018
config update developer conversion script Oct 19, 2019
install-all update scripts Oct 27, 2019
preload Fix cathook GUI stuff for the logname changes Sep 11, 2019
symbolize-crash-log NavBot improvements and overhauls Nov 16, 2018
update Update update Aug 23, 2019

Cathook Training Software

banner CircleCI

Risk of VAC detection

The software could be detected by VAC in the future. Only use it on accounts you won't regret getting VAC banned.


You can chat with other cathook users in our official telegram group and the cathook announcements channel.

Reporting Issues

If some things doesn't work as expected, please open issues on GitHub using this page.


Do you want to submit code to cathook? Please read for a short introduction.


Cathook is a training software designed for Team Fortress 2 for Linux. Cathook includes some joke features like

  • Ignore Hoovy
  • Encrypted chat
  • IRC Support (Find other Cathook users in-game automatically)
  • Chance to get manually VAC banned by Valve

and a lot of useful features, including

  • Anti Backstab with option to use "No" voice command when spy tries to backstab you
  • Extremely customizable spam (you can make spam lines that'll include name of random dead enemy pyro or sniper)
  • Follow Bots
  • Navparser Bots (Walkbots than can walk on any map without manual configuration)
  • Working crit hack (does not work right now (works right now))

FULL LIST OF FEATURES HERE (list might be outdated)


Automatic: (Ubuntu 18.04+/Fedora/Arch based only)

Run in terminal:

  • bash <(wget -qO-


Clone Cathook:

User mode:

git clone --depth 1

Developer mode:

git clone --recursive

Install dependencies:


git boost cmake make gcc gdb lib32-sdl2 lib32-glew lib32-freetype2 rsync lib32-libglvnd dialog


software-properties-common build-essential git g++ g++-multilib libboost-all-dev gdb libsdl2-dev:i386 libglew-dev:i386 libfreetype6-dev:i386 cmake dialog rsync


cmake dialog make gcc-c++ glibc-devel.i686 freetype-devel.i686 SDL2-devel.i686 glew-devel.i686 boost-devel.i686 rsync gdb git

Other distros

You will have to find matching packages yourself.

Compile Cathook:

Go into the cathook directory and run ./update

Updating Cathook

Run the update script in Cathook folder.

Cathook requires a special data folder (contains shaders, font files, walkbot paths, etc). This folder is located at /opt/cathook/data and is generated automatically when you compile Cathook.


sudo ./attach to attach Cathook into TF2. Optionally, you can provide a PID (for bots or other linux users).

sudo ./attach-gdb to attach and print backtrace in case TF2 crashes. Requires a debug Cathook build (run ./config to configure the build mode). Some users report that this causes FPS drop in-game. This is recommended if you want to grab a log of what went wrong if Cathook is crashing on you (report it!)

Followbots (outdated)

cathook-ipc-server allows you to run and control Followbots to do your evil bidding in-game. The installation for Followbots is quite complex, and will not be covered on this page. Obviously, you must have several user accounts ready to run TF2.
A guide for Followbots can be found here: How to setup and use followbots.

The installation script is as followed:

git clone --recursive && cd cathook-ipc-server && make -j4

To run the Followbot server, run ./bin/cathook-ipc-server. You can also use ./bin/cathook-ipc-server &>/dev/null & to run it in background.

You can’t perform that action at this time.