{"id":25236752,"url":"https://github.com/jesewe/cs2-esp","last_synced_at":"2025-07-22T14:04:28.413Z","repository":{"id":280806507,"uuid":"941946977","full_name":"Jesewe/cs2-esp","owner":"Jesewe","description":"An advanced overlay for Counter-Strike 2 that highlights enemy players and teammates with customizable settings. (Works only in windowed or windowed borderless)","archived":false,"fork":false,"pushed_at":"2025-07-14T12:39:26.000Z","size":5382,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-14T16:25:51.685Z","etag":null,"topics":["cheat","cs2","cs2-cheat","cs2-esp","dearpygui","pymem","pymeow","python"],"latest_commit_sha":null,"homepage":"https://github.com/Jesewe/cs2-esp","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jesewe.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-03T10:17:08.000Z","updated_at":"2025-07-14T12:39:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"7cfc4908-f93b-45bf-ab34-d2392370fbce","html_url":"https://github.com/Jesewe/cs2-esp","commit_stats":null,"previous_names":["jesewe/cs2-esp"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Jesewe/cs2-esp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fcs2-esp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fcs2-esp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fcs2-esp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fcs2-esp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jesewe","download_url":"https://codeload.github.com/Jesewe/cs2-esp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fcs2-esp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266507366,"owners_count":23940055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cheat","cs2","cs2-cheat","cs2-esp","dearpygui","pymem","pymeow","python"],"created_at":"2025-02-11T15:31:47.743Z","updated_at":"2025-10-14T12:06:57.030Z","avatar_url":"https://github.com/Jesewe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"src/img/icon.ico\" alt=\"CS2 ESP\" width=\"200\" height=\"200\"\u003e\r\n  \u003ch1\u003eCS2 ESP\u003c/h1\u003e\r\n  \u003cp\u003eAn advanced overlay for Counter-Strike 2 that highlights enemy players and teammates with customizable settings. (Works only in windowed or fullscreen windowed)\u003c/p\u003e\r\n\r\n![Downloads](https://img.shields.io/github/downloads/jesewe/cs2-esp/total?style=for-the-badge\u0026logo=github\u0026color=D5006D)\r\n![Platforms](https://img.shields.io/badge/platform-Windows-blue?style=for-the-badge\u0026logo=windows\u0026color=D5006D)\r\n![License](https://img.shields.io/github/license/jesewe/cs2-esp?style=for-the-badge\u0026color=D5006D)\r\n\r\n\u003ca href=\"#features\"\u003e\u003cstrong\u003eFeatures\u003c/strong\u003e\u003c/a\u003e •\r\n\u003ca href=\"#installation\"\u003e\u003cstrong\u003eInstallation\u003c/strong\u003e\u003c/a\u003e •\r\n\u003ca href=\"#usage\"\u003e\u003cstrong\u003eUsage\u003c/strong\u003e\u003c/a\u003e •\r\n\u003ca href=\"#configuration\"\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/a\u003e •\r\n\u003ca href=\"#troubleshooting\"\u003e\u003cstrong\u003eTroubleshooting\u003c/strong\u003e\u003c/a\u003e •\r\n\u003ca href=\"#contributing\"\u003e\u003cstrong\u003eContributing\u003c/strong\u003e\u003c/a\u003e\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n## Features\r\n\r\n- **Dynamic ESP Overlay:**  \r\n  Displays boxes around enemy players and (optionally) teammates, with a vertical health bar that changes color based on health level (red for 0–20%, yellow for 20–50%, green for 50–100%).\r\n\r\n- **Custom Nickname Display:**  \r\n  Renders the player's nickname (with optional transliteration from Cyrillic to Latin) above the box.\r\n\r\n- **Snaplines:**  \r\n  Optionally draws lines from the screen center to enemy positions, customizable in color.\r\n\r\n- **Minimap Overlay:**  \r\n  Provides a top-left positioned minimap showing entity positions for enhanced spatial awareness, with adjustable size.\r\n\r\n- **Global Hotkeys:**  \r\n  Use **F6** to start and **F7** to stop the overlay—these hotkeys function globally, even when the application is not in focus.\r\n\r\n- **Customizable Settings:**  \r\n  Adjust overlay settings (e.g., colors, line thickness, teammate visibility, minimap size, and FPS optimization) via an intuitive **DearPyGui** interface.  \r\n  Changes are automatically saved to `%LOCALAPPDATA%\\Requests\\ItsJesewe\\esp_config.json`.\r\n\r\n- **Automatic Update Check:**  \r\n  Checks for updates from the GitHub repository on startup and notifies you if a new version is available.\r\n\r\n- **Robust Error Handling:**  \r\n  If the game process (`cs2.exe`) is not found or an error occurs, a popup displays a clear error message instead of crashing.\r\n\r\n- **Modular Code Structure:**  \r\n  Organized into modules (`utils.py`, `config.py`, `cs2esp.py`, `gui.py`, and `main.py`) for improved readability and maintainability.\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### Prerequisites\r\n\r\n- **Python 64-bit:**  \r\n  A 64-bit version of Python is required for the overlay and memory-reading libraries.\r\n\r\n- **PyMeow Module:**  \r\n  PyMeow is essential for rendering the overlay.  \r\n  Download the latest `pyMeow*.zip` from the [PyMeow GitHub Releases page](https://github.com/qb-0/pyMeow/releases) and install it:\r\n\r\n  ```bash\r\n  pip install pyMeow*.zip\r\n  ```\r\n\r\n### Option 1: Clone the Repository\r\n\r\n1. **Clone the Repository:**\r\n\r\n   ```bash\r\n   git clone https://github.com/Jesewe/cs2-esp.git\r\n   cd cs2-esp\r\n   ```\r\n\r\n2. **Install Dependencies:**\r\n\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n3. **Run the Script:**\r\n   ```bash\r\n   python main.py\r\n   ```\r\n\r\n### Option 2: Download Pre-Built Executable\r\n\r\nDownload the latest pre-built executable from the [Releases](https://github.com/jesewe/cs2-esp/releases/latest) page and run it directly.\r\n\r\n**Note:** This project requires Python version \u003e= 3.8 and \u003c 3.12.5.\r\n\r\n---\r\n\r\n## Usage\r\n\r\n- **Starting the Overlay:**  \r\n  Launch the application:\r\n\r\n  - Click the **Start Overlay** button in the GUI or press **F6**.\r\n  - If `cs2.exe` is not running, a popup will display an error message.\r\n\r\n- **Stopping the Overlay:**  \r\n  Click the **Stop Overlay** button or press **F7**.\r\n\r\n- **Customizing Settings:**  \r\n  Use the DearPyGui interface to tweak settings (e.g., box color, text color, line thickness, teammate visibility, minimap size).  \r\n  Changes are automatically saved to `%LOCALAPPDATA%\\Requests\\ItsJesewe\\esp_config.json`.\r\n\r\n---\r\n\r\n## Configuration\r\n\r\nThe configuration file is located at:  \r\n`%LOCALAPPDATA%\\Requests\\ItsJesewe\\esp_config.json`\r\n\r\n- Automatically created and updated with new settings keys on load.\r\n- Saved whenever settings are modified in the GUI.\r\n\r\n---\r\n\r\n## Troubleshooting\r\n\r\n- **Game Process Not Found:**  \r\n  If you see `pymem.exception.ProcessNotFound`, ensure **Counter-Strike 2 (cs2.exe)** is running before starting the overlay.\r\n\r\n- **Insufficient Privileges:**  \r\n  Global hotkeys and memory reading may need administrative rights. Run the application as an administrator if issues arise.\r\n\r\n- **Unexpected Crashes:**  \r\n  Verify all dependencies are correctly installed and check for interference from antivirus or security software.\r\n\r\n---\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please open an issue or submit a pull request on the [GitHub repository](https://github.com/Jesewe/cs2-esp).\r\n\r\n## Disclaimer\r\n\r\nThis script is for educational purposes only. Using cheats or hacks in online games is against the terms of service of most games and can result in bans or other penalties. Use this script at your own risk.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesewe%2Fcs2-esp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjesewe%2Fcs2-esp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesewe%2Fcs2-esp/lists"}