https://github.com/teemsploit/crosshair
A simple crosshair application for Windows written in Python. Allows users to draw a crosshair at the center of the screen with customizable color and visibility settings. Features include color cycling, visibility toggling, and configurable key bindings. Released under the Unlicense.
https://github.com/teemsploit/crosshair
crosshair crosshair-overlay overlay python windows
Last synced: 5 months ago
JSON representation
A simple crosshair application for Windows written in Python. Allows users to draw a crosshair at the center of the screen with customizable color and visibility settings. Features include color cycling, visibility toggling, and configurable key bindings. Released under the Unlicense.
- Host: GitHub
- URL: https://github.com/teemsploit/crosshair
- Owner: Teemsploit
- License: unlicense
- Created: 2024-08-03T22:56:45.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-05T08:12:59.000Z (almost 2 years ago)
- Last Synced: 2025-02-07T16:24:25.563Z (over 1 year ago)
- Topics: crosshair, crosshair-overlay, overlay, python, windows
- Language: Python
- Homepage: https://github.com/Teemsploit
- Size: 17.6 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Crosshair Application
This is a Python application that displays a crosshair on your screen. It allows you to cycle the crosshair color, toggle its visibility, open/close a console, and more. The application is designed for Windows, administrator privileges recommended.
## Features
- **Crosshair Display**: Draws a crosshair in the center of the screen.
- **Color Cycling**: Change the crosshair color between Red, Green, and Blue.
- **Visibility Toggle**: Show or hide the crosshair.
- **Console Management**: Open and close a console window for debugging or configuration.
- **Key Bindings**: Customize behavior using specific key presses.
## Requirements
- Python 3.x
- `psutil` library (install via `pip install psutil`)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/Teemsploit/Crosshair
```
2. Navigate into the project directory:
```bash
cd Crosshair
```
3. Install the required Python packages:
```bash
pip install psutil
```
4. Run the application:
```bash
python crosshair.py
```
## Key Bindings
- **Insert**: Cycle through crosshair colors (Red, Green, Blue).
- **Delete**: Toggle the visibility of the crosshair.
- **End**: Open or close the console window.
- **Home**: Show a message with key bindings.
- **Right Arrow**: Close the crosshair.
## Configuration
The application reads and writes its configuration from `crosshair_config.json` located in the `APPDATA` directory. Configuration options include the crosshair color and visibility status.
## Logging
Logs are written to `crosshair.log` in the `APPDATA` directory. This file includes error messages and other runtime information.
## Troubleshooting
- Ensure you are running the application with administrator privileges.
- If you encounter any issues, check the log file for detailed error messages.
## Contact
For any questions or issues, please open an issue on the [GitHub repository](https://github.com/Teemsploit/Crosshair/issues).
---