/csgo-voice-extractor

CLI to export players' voices from CSGO/CS2 demos into WAV files.

Primary LanguageGoMIT LicenseMIT

Counter-Strike voice extractor

CLI to export players' voices from CSGO/CS2 demos into WAV files.

Warning

Valve Matchmaking demos do not contain voice audio data, hence there is nothing to extract from MM demos.

Installation

Download the last release for your OS from GitHub.

Usage

Windows

csgove.exe demoPaths... [-output]

By default .dll files are expected to be in the same directory as the executable. You can change it by setting the LD_LIBRARY_PATH environment variable. Example:

LD_LIBRARY_PATH="C:\Users\username\Desktop" csgove.exe

macOS

Caution

The environment variable DYLD_LIBRARY_PATH must be set before invoking the program and point to the location of the .dylib files!

DYLD_LIBRARY_PATH=. csgove demoPaths... [-output]

Linux

Caution

The environment variable LD_LIBRARY_PATH must be set before invoking the program and point to the location of the .so files!

LD_LIBRARY_PATH=. csgove demoPaths... [-output]

Options

-output <string>

Folder location where audio files will be written. Current working directory by default.

-exit-on-first-error

Stop the program at the first error encountered. By default, the program will continue to the next demo to process if an error occurs.

Examples

Extract voices from the demo myDemo.dem in the current directory:

csgove myDemo.dem

Extract voices from multiple demos using absolute or relative paths:

csgove myDemo1.dem ../myDemo2.dem "C:\Users\username\Desktop\myDemo3.dem"

Change the output location:

csgove -output "C:\Users\username\Desktop\output" myDemo.dem

Developing

Requirements

Debugging is easier on macOS/Linux 64-bit, see warnings below.

Windows

Because the CSGO audio library is a 32-bit DLL, you need a 32-bit GCC and set the Go env variable GOARCH=386 to build the program.

Important

Use a unix like shell such as Git Bash, it will not work with cmd.exe!

Warning

The $GCC_PATH variable in the following steps is the path where gcc.exe is located.
By default, it's C:\TDM-GCC-64\bin when using TDM-GCC (highly recommended).

  1. Install GCC for Windows, TDM-GCC is recommended because it handles both 32-bit and 64-bit when running go build. If you use MSYS2, it's important to install the 32-bit version (pacman -S mingw-w64-i686-gcc).
  2. Install pkg-config using chocolatey by running choco install pkgconfiglite.
    It's highly recommended to use choco otherwise you would have to build pkg-config and copy/paste the pkg-config.exe binary in your $GCC_PATH.
  3. Download the source code of Opus
  4. Extract the archive, rename the folder to opus and place it in the project's root folder
  5. Open the opus/win32/VS2015/opus.sln file with Visual Studio (upgrade the project if asked)
  6. Build the Release configuration for Win32 (not x64 - it's important to build the 32-bit version!)
  7. Copy/paste the opus.dll file in $GCC_PATH and dist/bin/win32-x64
  8. Copy/paste the C header files located inside the include folder file in $GCC_PATH\include\opus (create the folders if needed)
  9. Copy/paste the opus.pc.example to opus.pc file and edit the prefix variable to match your GCC installation path if necessary.
  10. PKG_CONFIG_PATH=$(realpath .) LD_LIBRARY_PATH=dist/bin/win32-x64 CGO_ENABLED=1 GOARCH=386 go run -tags nolibopusfile .

Warning

Because the Go debugger doesn't support Windows 32-bit and the CSGO lib is a 32-bit DLL, you will not be able to run the Go debugger.
If you want to be able to run the debugger for the Go part only, you could comment on lines that involve C/CGO calls.

macOS

Important

On macOS ARM64, the x64 version of Homebrew must be installed!
You can install it by adding arch -x86_64 before the official command to install Homebrew (arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)")

  1. Install Homebrew x64 version
  2. arch -x86_64 brew install opus
  3. arch -x86_64 brew install pkg-config
  4. cp /usr/local/Cellar/opus/1.4/lib/libopus.0.dylib dist/bin/darwin-x64 (arch -x86_64 brew info opus to get the path)
  5. DYLD_LIBRARY_PATH=dist/bin/darwin-x64 CGO_ENABLED=1 GOARCH=amd64 go run -tags nolibopusfile .

Warning

On macOS ARM64, the Go debugger breakpoints will not work because the executable must target amd64 but your OS is ARM64.

Linux

  1. sudo apt install pkg-config libopus-dev
  2. cp /usr/lib/x86_64-linux-gnu/libopus.so.0 dist/bin/linux-x64 (you may need to change the path depending on your distro)
  3. LD_LIBRARY_PATH=dist/bin/linux-x64 CGO_ENABLED=1 GOARCH=amd64 go run -tags nolibopusfile .

Building

Windows

make build-windows

macOS

make build-darwin

Linux

make build-linux

Credits

Thanks to @saul and @ericek111 for their CSGO investigation.
Thanks to @DandrewsDev for his work on CS2 voice data extraction.

License

MIT