zkxs / simple-crosshair-overlay

A simple and performant crosshair overlay
GNU General Public License v3.0
16 stars 3 forks source link
crosshair crosshair-overlay overlay windows

Simple Crosshair Overlay

A performant native crosshair overlay without unnecessary bloat. Free and open-source software.

screenshot of the default, simple crosshair in action

Click here to expand another screenshot demoing a custom PNG crosshair ![screenshot of a custom PNG crosshair](screenshots/custom.png)

Features

Installation

  1. Download simple-crosshair-overlay.exe from the latest release, and save it to a location of your choice
  2. Run simple-crosshair-overlay.exe
  3. 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.

macOS binaries are available, but I lack hardware to test against so I do not know if they work. If you're using simple-crosshair-overlay on macOS please let me know in the macOS support tracking issue.

Linux is presently unsupported, pending resolution of a few issues. See the Linux support tracking issue for details.

Usage

Use the tray icon to:

In Adjust Mode:

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:

  1. 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.
  2. 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

  1. Install Rust
  2. cargo install simple-crosshair-overlay

Building from Source

  1. Install Rust
  2. Clone the project
  3. 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-2024 Michael Ripley.

Simple Crosshair Overlay is provided under the GPL-3.0 license.