Installation - rbjaxter/budhud GitHub Wiki

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): Video Explanation 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

Installation

  1. 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...`

File Explorer

  1. 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..."

  1. Move budhud-master into your custom folder.

Your file directory should now look similar to this picture: File Directory

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

Here is a breakdown of what files are required and which are not: File Directory Breakdown


⚠️ **GitHub.com Fallback** ⚠️