Installation

Installation of the hud remains the same regardless of what you intend on using (stream/players hud, etc).

Video Guide

Here's a video explaining how to install the HUD (Updated November 11th, 2023): And here is the old video explanation (January 1st, 2021)

Download

Click this link to find the latest release.

Other places you can download it:

Installation (TL;DR)

Download the hud and then extract budhud-master into your ../tf/custom folder
- Create the custom folder if it does not exist
- Make sure the budhud-master folder isn't nested within another budhud-master folder
- See the picture below on how to find your custom folder quickly

Important

The path to the HUD should be ../tf/custom/budhud-master, NOT ../tf/custom/budhud-master/budhud-master.

This is the most common mistake people make when installing a hud.

Note

This guide refers to the zipped file/folder as being called budhud-master, but please just be aware it could be called budhud or something else depending on where you download it from.

Ensure that you have a custom folder in your TF2 directory. The default Team Fortress 2 directory is located in C:/Program Files (x86)/Steam/steamapps/common/Team Fortress 2/tf/. If you do not have a custom folder in this directory, create one.
- For linux, this path is located at: ~/.steam/steam/steamapps/common/Team Fortress 2/tf/custom/

The easiest way to find your Team Fortress 2 directory is through Steam.

1. Open up Steam
2. Click on `LIBRARY`
3. Right click `Team Fortress 2` and click on `Properties...`
4. Navigate to the `Installed Files` tab on the left
5. Next to "Size of installation:", click `Browse...`

Extract the hud with your preferred extraction program (I personally use 7zip). Once extracted, you should have a folder called budhud-master.

Tip

If you're on Windows and don't have an extraction program already, you can also right click on the compressed zip folder -> select "Extract all..."

Move budhud-master into your custom folder.

Your file directory should now look similar to this picture:

Important

The installation path for any TF2 HUD is ..\tf\custom\<HUD_NAME>\<HUD_FILES>, where <HUD_FILES> are the typical folders/files you would see in a hud:

cfg*
materials*
resource
scripts
sound*
info.vdf REQUIRED

*HUDs may not always have all of these folders

Having these files/folders anywhere else (such as within a nested folder like ..\tf\custom\budhud-master\budhud-master) will result in the hud not working.

For budhud:

Incorrect: ..\tf\custom\budhud-master\budhud-master
Incorrect: ..\tf\custom\_budhud
Correct: ..\tf\custom\budhud-master

Troubleshooting

Check out HUD Troubleshooting.

Required Files

99% of people do not need to worry about this, but here is a breakdown of what files are required and which are not if you really want to remove unneeded files/folders: