5 releases (2 stable)
1.1.1 | Nov 16, 2023 |
---|---|
1.0.0 | Aug 11, 2023 |
0.1.5 | Aug 10, 2023 |
0.1.4 | Aug 9, 2023 |
0.1.3 | Aug 9, 2023 |
#155 in GUI
66 downloads per month
8.5MB
2.5K
SLoC
Simple Crosshair Overlay
A simple native crosshair overlay without unnecessary bloat. Free and open-source software.
Click here to expand another screenshot demoing a custom PNG crosshair
Features
- Works on any application that's not fullscreen exclusive. You must use windowed or borderless-windowed mode on your game. This was an intentional design choice, as rendering into a fullscreen-exclusive game is not anticheat-compatible.
- Performant: the overlay is only redrawn when you change the crosshair. CPU and memory usage are minimal, and the GPU isn't used at all.
- Minimal UI: managed via a tray icon and hotkeys.
- Comes with a simple default crosshair that can be scaled and recolored to your preference.
- Can use custom PNG images as crosshairs.
- No installer. The application is completely portable. The only file this program creates is small configuration saved in
%appdata%\simple-crosshair-overlay
.
Installation
- Download simple-crosshair-overlay.exe from the latest release, and save it to a location of your choice
- Run simple-crosshair-overlay.exe
- Optionally, if you want a start menu shortcut you can make one yourself! Simply right-click simple-crosshair-overlay.exe and select "Pin to Start". This will automatically create a shortcut in
%appdata%\Microsoft\Windows\Start Menu\Programs
.
Binaries are also provided for MacOS, although they are untested. If you're interested in helping test see issue #3.
Linux is presently unsupported. See issue #6.
Usage
Use the tray icon to:
- Toggle crosshair visibility (you can also use Ctrl+H)
- Toggle Adjust Mode (you can also use Ctrl+J)
- Pick a color for the default crosshair (you can also use Ctrl+K if you are in Adjust Mode).
- Load a PNG image as your crosshair
- Reset crosshair to default settings
- Safely exit the application and save your settings
In Adjust Mode:
- Arrow keys to move the crosshair
- PageUp/PageDown to increase/decrease the crosshair scale
- Ctrl+M to cycle through your monitors
- Ctrl+K to pick a color for the default crosshair
Custom PNG Crosshairs
Your PNG file must use RGBA pixel format. Most PNGs are already saved this way, but you may need to specifically save it with an alpha channel if Simple Crosshair Overlay is giving you an error.
Also note that changing the color of the built-in crosshair has no effect on custom PNG crosshairs. If you want your custom crosshair in a different color you'll have to make that change in an image editor.
Changing Hotkeys
Hotkeys cannot currently be changed in-application. To edit your hotkeys, do the following:
- Open the config file
%appdata%\simple-crosshair-overlay\config\config.toml
. If this file does not exist, starting and exiting the program once will create it. - Change hotkeys in the
key_bindings
section by referencing the Keycode values defined in keycode.rs
Notes
Simple Crosshair Overlay supports 0.5 pixel alignment with the default crosshair by scaling it to an even or odd size. If this sounds nonsensical, I've written a quick explanation of this concept. If you're using a custom PNG crosshair, then providing the correct even/odd size is up to you.
Installing from Source
- Install Rust
cargo install simple-crosshair-overlay
Building from Source
- Install Rust
- Clone the project
cargo build --release
Feedback
If you have bugs to report please let me know by opening an issue.
For suggestions, questions, or even just to say hey, feel free to start a discussion.
License
Copyright 2023 Michael Ripley.
Simple Crosshair Overlay is provided under the GPL-3.0 license.
Dependencies
~5–47MB
~752K SLoC