Build from Source

Building VioletWing from source lets you inspect the code, make modifications, or compile your own executable.

Requirements

• Python — >= 3.8 and < 3.12.10
• Git — any recent version
• OS — Windows 10 or 11 (64-bit)

Note: Python 3.12.10 and above are not supported due to a compatibility constraint with pyMeow. Python 3.11.x is recommended.

Steps

1. Clone the repository

git clone https://github.com/Jesewe/VioletWing.git
cd VioletWing

2. Install Python dependencies

pip install -r requirements.txt

3. Install pyMeow (required for ESP Overlay)

pyMeow is not on PyPI and must be installed manually:

1. Go to the pyMeow releases page
2. Download the .zip matching your Python version
3. Install it:

pip install pyMeow*.zip

4. Run the application

python main.py

Run with administrator privileges so VioletWing can attach to cs2.exe.

Building an Executable

To compile a standalone .exe:

compile.bat

This uses PyInstaller (included in requirements.txt) to bundle everything into a single executable. Output goes to the dist/ folder.

Notes

• Config: %LOCALAPPDATA%\Requests\ItsJesewe\config.json
• Cached offsets: %LOCALAPPDATA%\Requests\ItsJesewe\Offsets\
• The file watcher picks up config.json changes at runtime — no restart needed