Crosshair Y

A lightweight and powerful crosshair overlay for Windows, designed for gamers who need a precise, custom aiming point in any game.

---

Features

• Multiple Crosshair Types: Choose between a classic Cross, a simple Dot, a Rectangle, or use your own custom image.
• Dynamic Color Picker: Instantly pick any color from your screen by pressing the F6 hotkey, or choose manually from a color dialog.
• Hide on Aim (ADS): Automatically hides the crosshair when you hold down the right mouse button, preventing it from covering your weapon's sights.
• Persistent Profiles: Your settings are automatically saved to crosshair_settings.json and loaded every time you start the app.

---

Customization Options

This application is fully customizable. You can adjust:

• Crosshair Type (Cross, Dot, Rectangle, Custom Image)
• Color (Unlimited, with on-screen picker)
• Opacity (From nearly invisible to fully opaque)
• Size (For Dot and Image types)
• X and Y Offset (To perfectly center the crosshair)
• Cross Length (The length of the lines in a classic cross)
• Cross Thickness (The thickness of the lines)
• Cross Gap (The space in the center of the cross)
• Rectangle Width
• Rectangle Height
• Custom PNG Image (Load your own crosshair file)
• Image Aspect Ratio (Lock or unlock for custom stretching)

---

How to Use

No installation is needed!

1. Go to the Releases page on the right side of this GitHub repository.
2. Download the latest CrosshairY.exe file.
3. Place the .exe anywhere you like and run it.

---

Important Compatibility Notes

• Display Mode: For the overlay to work, your game must be running in Windowed or Borderless Windowed mode. It will not be visible in Exclusive Fullscreen mode.
• Rendering API: This overlay is compatible with DirectX 9, 10, 11, and 12 games. It is not compatible with games running on the Vulkan API.
• Administrator Privileges: The application will request Administrator privileges when it starts. This is required for the "Hide on Right-Click" feature to detect mouse input while you are in a game.

---

Compiling from Source (For Developers)

If you want to build the application from the source code, you'll need Python installed on your system.

1. Prerequisites

Install the required Python libraries using pip:

pip install customtkinter Pillow mss pywin32

2. Building the Executable

This project uses PyInstaller to bundle the script and its dependencies into a single .exe file.

Install PyInstaller:

pip install pyinstaller

Run the following command from the project directory to build CrosshairY.exe:
(Make sure to replace the path to customtkinter with the one on your system if it's different.)

pyinstaller --onefile --windowed --name CrosshairY --icon="y.ico" --add-data "C:/Users/YOUR_USER/AppData/Roaming/Python/Python313/site-packages/customtkinter;customtkinter" crosshair.py

The final executable will be located in the dist folder.