How to install a TF2 HUD (Windows, Linux, Steam Deck, Mac)

A custom HUD is just a folder that changes how TF2 shows your health, ammo, menus and scoreboard. To install it you put that folder in the right place. Takes about two minutes, and it's the same for every HUD.

Install a HUD in five steps

  1. Download the HUD and unzip it. Every HUD on tf2hud has a Download button that gets you a .zip.
  2. Open your custom folder. In your Steam library, right-click Team Fortress 2, choose Manage, then Browse local files. Open tf, then custom. If there's no custom folder in tf, make one.
  3. Remove any HUD that's already there. TF2 only uses one HUD at a time. Two HUD folders in custom mix their files and break each other.
  4. Copy the HUD folder into custom. You want the folder that has resource and scripts directly inside it. Usually that's the top folder of the zip, sometimes it's one level deeper.
  5. Restart TF2. If the game is already running, open the console and run hud_reloadscheme. New fonts only load after a restart.

When you're done, the path should look like tf/custom/rayshud/resource. If it's tf/custom/rayshud-master/rayshud/resource, the HUD is one folder too deep and TF2 won't find it.

Where the custom folder is

Browse local files always gets you there. Default locations:

If TF2 is on another drive or Steam library, the path starts in that library instead.

Linux, Steam Deck and Mac: install the fonts

On Windows, TF2 loads a HUD's fonts straight from the HUD folder. On Linux and macOS it usually doesn't, so you get a fallback font and text in the wrong size or spot. To fix it, open the HUD's resource/fonts folder and install the font files on your system. On Linux, copy them to ~/.local/share/fonts. On a Mac, open them with Font Book. Then restart TF2. The TF2 fonts guide lists the game's own fonts and shows how a HUD adds one.

Linux file names are also case-sensitive, so a HUD made only for Windows can have missing parts. The HUDs for Linux list has the ones whose authors support it.

If the HUD doesn't work

Remove a HUD and get the default HUD back

To uninstall a HUD, delete its folder from tf/custom and restart TF2. The default HUD comes back. No game files were changed, so there's nothing else to undo. If it still looks off, the default HUD guide has two things to check.

How to install other TF2 mods

Other mods that replace game files, like a crosshair pack or a hit sound, install the same way: each one gets its own folder in tf/custom. The game reads every folder there, so you can stack mods as long as no two replace the same file. That's why two HUDs clash but a HUD plus a crosshair pack doesn't.

To remove a mod, delete its folder and restart TF2. Configs are different: autoexec.cfg goes in a cfg folder, and the config maker's readme says where. For typing commands in game, see the TF2 console commands guide.

Pick a HUD

Try minimal HUDs for a clean screen, competitive HUDs for big, readable numbers, or customizable HUDs if you like to tweak stuff. The full list is all HUDs A-Z. To make your own, use the HUD builder. It gives you a zip that installs the same way. For your crosshair, read the TF2 crosshair guide or make one in the crosshair maker. For game settings and key binds, the TF2 config maker writes an autoexec.cfg for you.