pyjam

pyjam is an open source, cross-platform audio player for Source and GoldSrc engine based games, written in Python

FEATURES

• Cross-platform -- Supports (in theory) Windows, GNU/Linux and OSX!
• Open source -- Licensed under the GNU General Public License, v3.
• Native GUI -- wxMSW on Windows, wxGTK on GNU/Linux, wxMAC on OSX
• Easy to use settings dialog
• Track aliases -- select tracks by name instead of index!
  • Set custom track aliases (generated from track name by default)
• Custom binds -- select tracks with a keybind
• Built-in audio converter -- uses FFmpeg
• Built-in audio downloader! -- youtube-dl (supports MANY (hundreds) websites, full list here)

USAGE

1. Download the latest version from the Releases tab
2. Launch pyjam and go to File>Settings
   1. Browse for your Steam path into the Path to Steam option.
      • The program will try to guess where Steam is beforehand and may be filled out
   2. Enter the name into the Profile/game name option.
      • It's simply used as a profile name and the name does not matter.
   3. Browse for the folder of the game into the Game path option.
      • BE SURE TO INCLUDE THE MOD FOLDER IN THERE AS WELL, e.g., /Steam/steamapps/common/Team Fortress 2/tf2/
   4. Browse for the path of the audio folder you want for this game into the Audio path option.
   5. Enter the audio rate of that game into the Audio rate option.
      • Normally, this is 11025.
      • However, CS:GO uses the CELT audio codec, so use 22050 if creating a CS:GO profile. (Higher quality!)
   6. Select a key for the Relay key option.
      • For quick selection, click on the drop down arrow and press a key on your keyboard to select a key
      • The default option usually works just fine (unless you have a bind that uses =)
   7. Select a key for the Play key option.
      • For quick selection, click on the drop down arrow and press a key on your keyboard to select a key
   8. Select whether or not you want to use aliases.
      • Aliases allow for you to select songs in console using words instead of an index number
      • Disable if you think there might be conflicts.
   9. Press Save game, and then exit the dialog.
   10. Congratulations! Your first game has been set up.
3. Put in your audio!
   1. If you already have audio converted and ready to go, drop them into the audio folder you designated for the game
   2. Otherwise, if you have audio downloaded, but not converted, use the Audio converter to convert them to the proper format
   3. If you don't have an audio at all, use the Audio downloader and download from your favorite streaming sites!
   4. Lastly, hit the Refresh tracks button in order to make sure that pyjam has detected all of your songs.
4. Ready? Press Start, and load up your game.
   • If pyjam is not immediately loaded when you start the game, type exec jam.cfg in console to fix that.
5. Have fun!

THANKS

Thanks to Dx724 for the wonderful icon.