Home

Awesome

<p align="center"> <img style="width:200px; height:200px;" width="200" height="200" src="https://github.com/lacymorrow/crossover/raw/master/src/static/icons/icon.png"> </p>

CrossOver <img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/patreon-button.webp" height="40" style="height:40px;" align="right" /> <img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" height="40" style="height:40px;" align="right" />

🎯 Adjustable Crosshair Overlay for any screen

Latest releases Snapcraft Trending Maintainability CircleCI Appveyor

<div> <a href="https://gitHub.com/lacymorrow/crossover/stargazers/"><img src="https://img.shields.io/github/stars/lacymorrow/crossover.svg?style=social&amp;label=Star&amp;maxAge=2592000" alt="GitHub stars" style="max-width: 100%;"></a>&nbsp;&nbsp;&nbsp;<a href="https://gitHub.com/lacymorrow/crossover/network/"><img src="https://img.shields.io/github/forks/lacymorrow/crossover.svg?style=social&amp;label=Forks&amp;maxAge=2592000" alt="GitHub forks" style="max-width: 100%;"></a>&nbsp;&nbsp;&nbsp;<a href="https://gitHub.com/lacymorrow/crossover/watchers/"><img src="https://img.shields.io/github/watchers/lacymorrow/crossover.svg?style=social&amp;label=Watching&amp;maxAge=2592000" alt="GitHub watchers" style="max-width: 100%;"></a> </div>

Get it on the Windows App Store and Linux Snap Store

<div> <a href="ms-windows-store://pdp/?ProductId=9MTD5ZLN7NL1&mode=mini" style=""> <img src="https://get.microsoft.com/images/en-us%20dark.svg" alt="Download CrossOver for Windows" style="height:60px;" /> </a> <a href="https://snapcraft.io/crossover"> <img src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" alt="Download CrossOver for Windows" /> </a> </div>

Download CrossOver for Windows

All Downloads (Mac, Linux, Windows)
To Use CrossOver: <kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>X</kbd>
Mac: <kbd>Control</kbd>-<kbd>Option</kbd>-<kbd>Shift</kbd>-<kbd>X</kbd>

CrossOver allows you to place a customizable crosshair overlay above any application window. Improve your aim and gain a competitive advantage with a permanent colored crosshair to mark center screen.

<p align="center"> <img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-main.png"/> </p>

Documentation

Download

View All Downloads (for any OS)

Windows

Download CrossOver.exe to install CrossOver to your system and receive automatic updates.

If you just want to try out CrossOver, or don't like installing things, we offer a portable exe as well.

Mac

Download the dmg or zip file for your architecture:

Linux

We offer the following formats:

Or download from the Snap Store

Get it from the Snap Store

Quick Start

See usage…

<p align="center"> <br /> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Actual/ballistic-firedot.png"> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/The%20Diatoku/Green.png"> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Chevron/Amethyst.png"> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Actual/moa-delta.png"> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Kenney/crosshair052.png"> <img width="120" height="120" style="display:inline-block; width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/MLG%20Dot%20Outlined/Blue.png"> </p>

Features

<sup>* </sup> Escape from Tarkov will not work with CrossOver (#47)

Download CrossOver for Windows

View all dowloads for any OS
<p align="center"> <img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-duplicate.png"/> </p>

Other crosshair programs offer a single style or color option, and often don't allow you to reposition them. CrossOver is a small, unintrusive crosshair overlay which has plenty of configuration options to assist with aiming and vision of your crosshair. CrossOver offers a huge improvement to many games' default crosshairs for those with colorblindness or contrast issues.

Thanks to Reddit user /u/IrisFlame for the premade library of crosshairs!

Install

macOS 10.10+, Linux, and Windows 7+ are supported.

Download the latest version of CrossOver from the releases page

Because this app is Free and Open-Source, we cannot afford to sign our code. This means Chrome may warn about an untrusted download, this is normal. Click the arrow icon -> Keep to finish downloading. Windows Defender and Mac Gatekeeper will prevent you from running the app the first time.
Windows

Download the .exe file. (CrossOver-Setup-x.x.x.exe)

Windows protected your PC.

Mac

Download the .dmg file. (CrossOver-x.x.x.dmg)

"CrossOver" cannot be opened because the developer cannot be verified.

"CrossOver is damaged and can't be opened..."

M1 Mac security fix: (thanks Yoyopizzacat, #207)

Linux

Download the file appropriate to your system. (.AppImage, .apk, .deb, .freebsd, .pacman, .rpm, .snap)

The AppImage needs to be made executable after download.

Certain lightweight desktop environments may require a compositor to allow CrossOver to work correctly (#230).

Further instructions for Windows and Mac
<p align="center"> <img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-chooser.png"/> </p>

Usage

❌ marks the spot…

Position: Click and drag the crosshair to anywhere on any screen. Double-click the bullseye to center the app.

Choose Crosshair: Click the bullseye ◎ to select from tons of preloaded crosshairs. Drag an image to the window to use your own custom crosshair.

Customize settings using the "gear" icon. See Settings below.

Unlock the app to quit using <kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>X</kbd>, then click the close icon in the top-left corner. In Windows you can right-click on the crosshair window > Close.

Default Keyboard Shortcuts

DescriptionKeys
Toggle the settings window and lock the crosshair in place<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>X</kbd>
Move the crosshair a single pixel<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>Arrows</kbd>
Quickly hide/show the application<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>H</kbd>
Center the crosshair window<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>C</kbd>
Move the crosshair to the next connected display<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>M</kbd>
Duplicate your crosshair in a shadow window<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>D</kbd>
Display the "About" window details<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>A</kbd>
Reset all settings and center the window<kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>R</kbd>
Mac: the <kbd>Option</kbd> key is used instead of <kbd>Alt</kbd>.
Linux: Some distributions do not center on double-click.
<p align="center"> <img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-settings.png"/> </p>

Settings

Crosshair

Choose from over 100 real and fictional crosshairs, or use your own by dragging an image to the window. You can change the size and opacity.

Reticle

The reticle is the small dot or cross at the center of the sight. You can select the shape and the color, or this can be turned off.

Hide on ADS

Choose a mouse button to use as your ADS button. The crosshair will be hidden while this button is held down.

Harware acceleration

A handful of users have reported FPS issues with certain games (#70), CrossOver should not add any FPS or latency so if you experience it, toggle this setting on or off and disable Hide on ADS

Start on boot

You can automatically set CrossOver to start when your system starts on your gaming PC, so you're always ready to pop heads.

Automatic Updates

By default CrossOver will automatically keep itself updated with bug fixes and improvements. You can disable this in the settings to prevent all network requests. CrossOver will only connect to GitHub to download published releases and does not send or store any personal data. I'm a solo developer and you aren't important to me 🙂 I just want to game.

Keybinds

See default keyboard shortcuts. All of the keybinds can be changed or disabled except for the bind to reset all settings. Click into the input and press your bind, or press <kbd>Backspace</kbd> or <kbd>Delete</kbd> to disable a bind.

Keep in mind that keybinds may conflict with other programs so be careful about what you choose. There's no real mechanism for preventing you from setting two conflicting keyinds within the app, so don't do that.

Duplicate crosshairs

Duplicate crosshair windows use the same settings as the main window and do not support all of the features of the main window. Settings for duplicate crosshairs will not be saved and all duplicate windows will be closed if the main window is closed. Duplicate crosshairs cannot follow the mouse.

Reset

To reset all settings and binds to default, press <kbd>Control</kbd>-<kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>R</kbd>

<p align="center"> <br /> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Actual/boone-crockett-illuminated.png"> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/The%20Diatoku/Purple.png"> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Kenney/crosshair035.png"> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Special%20Requests/Monkeybolo.png"> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/MLG%20Dot%20Outlined/Orange.png"> <img width="120" height="120" style="width:120px; height:120px;" src="https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Actual/leupold-dot.png"> </p>

What works/doesn't work (compatability)

❌ Most games don't work in Fullscreen mode on Windows or Linux
WorksGameNotes
Among Us
Apex LegendsRuns in Windowed mode
Call of Duty Black Ops Cold WarRuns in Windowed, Windowed Fullscreen, Multi-Monitor modes
Call of Duty: WarzoneRuns in Windowed mode
Counter-Strike (1.6)Runs in Windowed mode
CS:GO / Counter-Strike: Global OffensiveRuns in Windowed mode; May work in Windowed Fullscreen and Fullscreen modes with AHK script
CS 2 / Counter-Strike: 2Runs in Windowed mode; Doesn't work in Fullscreen modes with/without AHK script
Cyberpunk 2077Does not work. (Vulkan)
Dead by DaylightRuns in Windowed and Fullscreen modes
DeceitRuns in Windowed mode
Destiny 2Runs in Windowed Fullscreen mode; Some reports of running in Fullscreen mode
Empyrion: Galactic SurvivalRuns in Windowed mode
Escape from TarkovUsers report the game will no longer start with CrossOver running (#47)
FiveMRuns in Fullscreen mode
FortniteRuns in Windowed Fullscreen mode
GTFOWorks in Fullscreen window, Maximized window, Windowed mode (Doesn't work in Exclusive Fullscreen window)
Hunt: ShowdownWorks in Windowed mode
Killing FloorRuns in Windowed mode
League of LegendsRuns in Borderless and Windowed modes
Left 4 Dead 2Runs in Borderless and Windowed modes
Halo: The Master Chief CollectionRuns in Borderless and Windowed modes
Metro Exodus Gold EditionDoesn't work under any circumstances
OverwatchRuns in Windowed Fullscreen mode
PhasmophobiaRuns in Windowed and Fullscreen modes
Planetside 2Runs in Windowed and Windowed Fullscreen modes
Rainbow 6: SeigeVulkan-based
RedMDoes not work.
RobloxRuns in Fullscreen mode (Windows) and Windowed Fullscreen mode (MacOS)
Rocket LeagueRuns in Windowed mode
RustRuns in Windowed Fullscreen mode
Sea of TheivesBANNABLE
Star Wars Battlefront 2Runs in Borderless mode
The FinalsRuns in Borderless and Windowed modes
Tom Clancy's The Division 2Runs in Windowed Fullscreen mode
Tony Hawks Pro Skater 1+2Such a fun game!
Vulkan-based games
ValorantRuns in Borderless and Windowed modes

Reported from our users, add your resuts

Operating Systems

WorksOSNotes
MacOS arm64 (M1, M2)You may need to run a command to un-quarantine the download, see below
MacOS x64 (Intel)Tested on Catalina 10.15.1
Windows 11
Windows 10 ia32
Windows 10 x64Custom cursors do not show in draggable taskbar area
Windows 8
Windows 7Does not work in Windows 7 Home; Works in Windows 7 Pro #63
ArchTested in v2021.01.01
Elementary OSTested in v5.1
FedoraTested in v33 (Shortcut conflicts with desktop switching)
MintTested in v20.1
UbuntuTested in v20.04.1
Newer MacOS' may quarantine the CrossOver.app package. To un-quarantine:

via @Yoyopizzacat


Development

Built with Electron. Simple HTML and Javascript, no framework.

Start developing in src/main.js and src/renderer.js. index.html contains the layout and index.scss contains the styles for the main app BrowserWindow

Run

You will need node.js v14.x.x installed. If you have nvm installed, run nvm install && nvm use to switch to the correct node version.
$ yarn && yarn start

Build

Build steps optimized for Mac, see electron.builder for help customizing builds.

wine and mono must be installed for Windows builds (macOS) multipass must be installed for Snap builds (macOS)

$ yarn build

Or yarn build:all

Build issues

Test CI builds on Mac and PC before releasing

'CrossOver' is damaged and can't be opened.

CI builds do not seem to work correctly for Mac. Try using a real Mac to build.

Test closing via the traffic lights on Mac

Calling process.exit() before the app is done "quitting" will cause the app to crash on Mac.

i386 architecture deprecated in MacOS

Newer versions of OSX cannot build for 32-bit apps, use CircleCI to build those.

gyp: name 'openssl_fips' is not defined while evaluating condition 'openssl_fips != ""' in binding.gyp while trying to load binding.gyp

See https://stackoverflow.com/questions/69882740/how-to-rebuild-epoll-package-in-electron.

Using Node@16 worked.

/Users/lacymorrow/repo/crossover/node_modules/app-builder-bin/mac/app-builder_arm64 process failed ERR_ELECTRON_BUILDER_CANNOT_EXECUTE
Exit code:
1 failedTask=build stackTrace=Error: /Users/lacymorrow/repo/crossover/node_modules/app-builder-bin/mac/app-builder_arm64 process failed ERR_ELECTRON_BUILDER_CANNOT_EXECUTE

To build rpm, executable rpmbuild is required, please install: brew install rpm

Continuous Integration (CI)

We use GitHub Actions, CircleCI and Appveyor to build and test CrossOver on every commit. Circle and GitHub build for all targets, Appveyor builds for Windows.

CircleCI builds are published to the Snap Store and GitHub Releases while Appveyor builds are published to the Windows App Store.

CircleCI needs the following environment variables:

As of v7, use the SNAPCRAFT_STORE_CREDENTIALS environment variable instead of the following

To install snapcraft on a Mac:

Publish

$ yarn release

Then edit the automatically created GitHub Releases draft and publish.

Bugs

Hidden by fullscreen apps

Currently CrossOver only works with windowed applications, use Windowed Fullscreen mode if your game or application supports it. (Windows)

Fullscreen for MacOS may have better results.

Workaround using AutoHotKey (Windows)

via @girkovarpa

If you absolutely need to use Fullscreen mode, or your game is not supported by crossover, there is a workaround using AutoHotKey.

Doesn't work with some games #47, and causes FPS issues in other cases

Install AutoHotKey and run this script with it (save it as script.ahk and double-click it):

Home::Winset, Alwaysontop, , CrossOver

Once in-game, pressing space should put the crosshair over the screen, even in fullscreen mode.

Performance Issues

There are reports of stuttering when using V-SYNC, G-SYNC, or similar Adaptive Sync (#330). Disabling these may improve performance. s

Graphical issues on Linux

Check your desktop environment. CrossOver may not work on KDE, try GNOME if you experience issues.

CrossOver behaves weirdly if your desktop is missing a compositor (#230). Try installing one to see if that resolves the issue.

Hidden by fullscreen apps on Linux

Some compositors, such as KDE Plasma's KWin, can't keep a window (CrossOver) over a full-screen window, so in such cases another compositor needs to be run that has this option.

GNOME's Mutter is one of those compositors that can do this.

In Lutris, for example, this can be automated with shell scripts that will run when the game is launched and quit.

Lutris->Right click on game's banner->Configure->System options:

Pre-launch script: /path/to/x.sh

#!/bin/bash
mutter --replace # or: gnome-shell --replace

Post-launch script: /path/to/x.sh

#!/bin/bash
kwin_x11 --replace
plasmashell --replace

Debugging

You can run CrossOver from the command line to see debug output. Open a terminal and navigate to the CrossOver app, run ./CrossOver to see output:

(Mac, Linux)

╭─  lacymorrow in /Applications/CrossOver.app/Contents/MacOS using
╰─○ $ ./CrossOver --debug
09:45:16.023 › CrossOver 2.7.4 Development
09:45:16.030 › Setting: Enable GPU
09:45:16.487 › App ready

Command-line lags

--debug

alias -d

Start CrossOver in debug mode, with Chrome DevTools open.

--reset

alias -r

Reset all app preferences to default, in case you get into a broken state.

--version

alias -v

Print the app version to stdout (Good for CI).

Credits

An extra big thanks to the crosshair providers, as this wouldn't be possible without them:

Gaming, Crosshair, Crossover App

See CrossOver in the Electron Apps library

Created by Lacy Morrow

Support this project

TL,DR: If you enjoy this project, and are financially able, why not donate $3?

This project is entirely developed, built, and maintained by one person. I've put hundreds of hours into this and I love being able to give it away for free.

Problem is, downloads don't pay the bills. If you would like to see specific features or improvements added to CrossOver, consider donating on OpenCollective

If you like this software and want to see it improved more often, consider supporting me on Patreon or through another channel:

Tip Crypto

<a href="https://www.patreon.com/bePatron?u=55065733" target="_blank"><img src="https://github.com/lacymorrow/crossover/raw/master/src/static/meta/patreon-button.webp" style="height:50px;" height="50" /></a>     <a href="https://opencollective.com/crossover/donate" target="_blank"><img src="https://opencollective.com/crossover/donate/button@2x.png?color=blue" style="height:50px;" height="50" /></a>     <a href="https://www.buymeacoffee.com/lm" target="_blank"><img style="height:50px;" height="50" src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" ></a>