Running VioletWing for the First Time

Launching VioletWing is straightforward, but understanding the startup process ensures everything works correctly. This article covers the initial run, what happens behind the scenes, and basic troubleshooting.

Written By Jesewe

Startup Steps

  1. Launch Counter-Strike 2 First: VioletWing attaches to cs2.exe, so start the game in windowed or borderless mode for best results.

  2. Run VioletWing:

    • Via Python: python main.py

    • Via Executable: Double-click VioletWing.exe

  3. What Happens on Startup:

    • Offset Fetching: VioletWing automatically pulls the latest source offsets from raw.githubusercontent.com/Jesewe/VioletWing/refs/heads/main/src/offsets.json. This ensures compatibility with CS2 updates.

    • Memory Manager Initialization: Attaches to the game process using Pymem.

    • GUI Launch: Opens the main window (1400×800) with tabs like Dashboard, Settings, etc.

    • Config Loading: Reads config.json from %LOCALAPPDATA%\Requests\ItsJesewe\. If missing, creates a default one.

    • Update Check: Queries GitHub for new versions (release and pre-releases) and notifies if available.

  4. Initial Configuration:

    • In the GUI, go to General Settings to toggle features.

    • Edit config.json manually for advanced tweaks (e.g., add custom delays).

    • Dynamic updates: Changes to config.json are detected and applied without restart.

First-Time Tips

  • Permissions: Run as administrator if attachment fails.

  • Logs: Check %LOCALAPPDATA%\VioletWing\logs\violetwing.log for startup messages.

  • Test Features: Enable one at a time (e.g., Overlay) in a private match to verify.

If you see errors like "cs2.exe not found," ensure the game is running. For more, see Troubleshooting collection.