Skip to content

Zyphrenn/CS2-Killfeed

Repository files navigation

CS2 KillFeed Sound Notifier

A small Node.js app that plays custom sounds when you get a kill or die in Counter-Strike 2, using Game State Integration (GSI).

CS2 KillFeed

Features

  • Plays a sound when you get a kill
  • Plays a different sound when you die
  • Uses ffplay to play .mp3 sound files
  • Tracks round kills and death status in real time

Requirements

  • Node.js (v18+ recommended)
  • FFmpeg installed and ffplay available in your system PATH
  • Counter-Strike 2 with Game State Integration (GSI) configured

Installation

  1. Clone the repository:

    git clone https://github.com/Zyphrenn/CS2-Killfeed.git
    cd CS2-Killfeed
    
  2. Install dependencies:

    npm install
    
  3. Add your sounds:
    Place your .mp3 files in the sounds/ folder:

    • kill_.mp3 for kills
    • death_.mp3 for deaths

Game State Integration Setup (CS2)

  • Open CS2's installation folder:
  • Navigate to CS2 in Steam
  • Right click Counter-Strike 2 - choose "Manage" - "Browse local files".
  • Navigate to game/csgo/cfg/
  • Move the gamestate_integration_killfeed.cfg file into this directory
  • Save the file and restart CS2.

Running the script

  • Simply start Counter-Strike and start the main.js script by running node main.js.

Disclaimer

This project uses CS2's official Game State Integration system and does not modify the game, inject code, or interact with VAC-protected memory in any way.

However, it may unintentionally trigger VAC-related warnings if misconfigured. I would recomend against using in competitive matches.

I am not responsible for any bans, timeouts, or account issues you may have.

About

A Node.js app that plays custom sounds when you get a kill or die in CS2

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published