{"id":13459064,"url":"https://github.com/lacymorrow/crossover","last_synced_at":"2025-05-16T16:09:26.818Z","repository":{"id":35769181,"uuid":"212880382","full_name":"lacymorrow/crossover","owner":"lacymorrow","description":"🎯 A Crosshair Overlay for any screen. ","archived":false,"fork":false,"pushed_at":"2025-04-19T03:36:22.000Z","size":27560,"stargazers_count":1021,"open_issues_count":91,"forks_count":112,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-05-08T17:49:24.973Z","etag":null,"topics":["center","crosshair","crosshair-overlay","crossover","dot","electron","fortnite","game-overlay","games","linux","macos","marks","opacity","overlay","sight","windows"],"latest_commit_sha":null,"homepage":"https://lacymorrow.github.io/crossover","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lacymorrow.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"lacymorrow","patreon":"lacymorrow","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["buymeacoffee.com/lm","lacymorrow.com/donate"]}},"created_at":"2019-10-04T18:37:29.000Z","updated_at":"2025-05-07T23:47:40.000Z","dependencies_parsed_at":"2023-12-23T17:18:18.809Z","dependency_job_id":"f8455764-ffd8-4ef5-9160-d20073594c37","html_url":"https://github.com/lacymorrow/crossover","commit_stats":{"total_commits":934,"total_committers":12,"mean_commits":77.83333333333333,"dds":0.08244111349036398,"last_synced_commit":"89588efb805bdb325d647653a98c2335ff006ccd"},"previous_names":[],"tags_count":121,"template":false,"template_full_name":"sindresorhus/electron-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Fcrossover","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Fcrossover/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Fcrossover/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Fcrossover/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lacymorrow","download_url":"https://codeload.github.com/lacymorrow/crossover/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254046184,"owners_count":22005550,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["center","crosshair","crosshair-overlay","crossover","dot","electron","fortnite","game-overlay","games","linux","macos","marks","opacity","overlay","sight","windows"],"created_at":"2024-07-31T09:01:02.355Z","updated_at":"2025-05-16T16:09:26.795Z","avatar_url":"https://github.com/lacymorrow.png","language":"JavaScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg style=\"width:200px; height:200px;\" width=\"200\" height=\"200\" src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/icons/icon.png\"\u003e\n\u003c/p\u003e\n\n# CrossOver [\u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/patreon-button.webp\" height=\"40\"  style=\"height:40px;\" align=\"right\" /\u003e](https://www.patreon.com/bePatron?u=55065733) [\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" height=\"40\"  style=\"height:40px;\" align=\"right\" /\u003e](https://www.buymeacoffee.com/lm)\n\n\u003e 🎯 Adjustable Crosshair Overlay for any screen\n\n![Latest releases](https://img.shields.io/github/downloads/lacymorrow/crossover/latest/total?label=CrossOver%40latest) [![Snapcraft](https://snapcraft.io/crossover/badge.svg)](https://snapcraft.io/crossover) [![Trending](https://snapcraft.io/crossover/trending.svg?name=0)](https://snapcraft.io/crossover) [![Maintainability](https://api.codeclimate.com/v1/badges/2f447345bdeff3565392/maintainability)](https://codeclimate.com/github/lacymorrow/crossover/maintainability) [![CircleCI](https://circleci.com/gh/lacymorrow/crossover/tree/release.svg?style=shield)](https://circleci.com/gh/lacymorrow/crossover/) [![Appveyor](https://ci.appveyor.com/api/projects/status/qtxvaliwymvhxiwx/branch/release?svg=true)](https://ci.appveyor.com/project/lacymorrow/crossover/)\n\n\u003cdiv\u003e\n\u003ca href=\"https://gitHub.com/lacymorrow/crossover/stargazers/\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/lacymorrow/crossover.svg?style=social\u0026amp;label=Star\u0026amp;maxAge=2592000\" alt=\"GitHub stars\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"https://gitHub.com/lacymorrow/crossover/network/\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/lacymorrow/crossover.svg?style=social\u0026amp;label=Forks\u0026amp;maxAge=2592000\" alt=\"GitHub forks\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"https://gitHub.com/lacymorrow/crossover/watchers/\"\u003e\u003cimg src=\"https://img.shields.io/github/watchers/lacymorrow/crossover.svg?style=social\u0026amp;label=Watching\u0026amp;maxAge=2592000\" alt=\"GitHub watchers\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n#### Get it on the Windows App Store and Linux Snap Store\n\n\u003cdiv\u003e\n\u003ca href=\"ms-windows-store://pdp/?ProductId=9MTD5ZLN7NL1\u0026mode=mini\" style=\"\"\u003e\n   \u003cimg src=\"https://get.microsoft.com/images/en-us%20dark.svg\" alt=\"Download CrossOver for Windows\" style=\"height:60px;\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://snapcraft.io/crossover\"\u003e\n   \u003cimg src=\"https://snapcraft.io/static/images/badges/en/snap-store-black.svg\" alt=\"Download CrossOver for Windows\" /\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n### [Download CrossOver for Windows](https://github.com/lacymorrow/crossover/releases/latest/download/CrossOver.exe)\n\n\n##### [All Downloads (Mac, Linux, Windows)](https://github.com/lacymorrow/crossover/releases/latest/)\n\n##### To Use CrossOver: \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eX\u003c/kbd\u003e\n###### Mac: \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eOption\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eX\u003c/kbd\u003e\n\nCrossOver allows you to place a customizable crosshair overlay above any application window.\nImprove your aim and gain a competitive advantage with a permanent colored crosshair to mark center screen.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-main.png\"/\u003e\n\u003c/p\u003e\n\n\n# Documentation\n\n- [Download](#download)\n- [Quick Start](#quick-start)\n- [Features](#features)\n- [Install](#install)\n- [Usage](#usage)\n  - [Settings](#settings)\n  - [What works/doesn't work (compatability)](#what-worksdoesnt-work-compatability)\n- [Development](#development)\n  - [Bugs](#bugs)\n  - [Debugging](#debugging)\n- [Credits](#credits)\n- [Support this project](#support-this-project)\n\n# Download\n\n### [View All Downloads (for any OS)](https://github.com/lacymorrow/crossover/releases/latest)\n\n### Windows\n\nDownload `CrossOver.exe` to install CrossOver to your system and receive automatic updates.\n\nIf you just want to try out CrossOver, or don't like installing things, we offer a portable `exe` as well.\n\n### Mac\n\nDownload the `dmg` or `zip` file for your architecture:\n\n- Intel (`x64`)\n- M1 (`arm64`)\n\n### Linux\n\nWe offer the following formats:\n- `AppImage`\n- `apk`\n- `deb`\n- `freebsd`\n- `rpm`\n- `snap`\n\nOr download from the Snap Store\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/crossover)\n\n\n# Quick Start\n\n- Choose a crosshair from over 50 included or drop a custom image\n- Click and drag the crosshair to move Crossover around\n- Double-click the bullseye ◎ to center\n- Use \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e and arrow keys for fine-tuning\n- \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eX\u003c/kbd\u003e to lock in place\n- \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eR\u003c/kbd\u003e to reset app settings\n\n[See usage…](#usage)\n\n\u003cp align=\"center\"\u003e\n\t\u003cbr /\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg 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\"\u003e\n\u003c/p\u003e\n\n# Features\n\n- Not bannable \u003csup\u003e* [[79]](https://github.com/lacymorrow/crossover/issues/79)\u003c/sup\u003e\n- Fast and lightweight\n- Choose from tons of true-to-life sights\n- Cross-platform: Windows, MacOS, and Linux support\n- Support for multiple monitors\n- Choose between center **Dot** or **Crosshair**\n- Create duplicate crosshairs to mark more than one spot\n- Customize crosshair size, color, and opacity\n- Customize SVG properties\n- Light/Dark mode and custom app colors\n- Persistent settings remember your choices automatically\n- Automatically updates in the background to keep your features fresh _(Mac and Windows only)_\n\n\u003csup\u003e* \u003c/sup\u003e Escape from Tarkov will not work with CrossOver ([#47](https://github.com/lacymorrow/crossover/issues/47#issuecomment-987762466))\n\n\n### [Download CrossOver for Windows](https://github.com/lacymorrow/crossover/releases/latest/download/CrossOver.exe)\n\n##### [View all dowloads for any OS](https://github.com/lacymorrow/crossover/releases/latest)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-duplicate.png\"/\u003e\n\u003c/p\u003e\n\nOther 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.\n\n###### _Thanks to Reddit user /u/IrisFlame for the premade library of crosshairs!_\n\n---\n\n# Install\n\n_macOS 10.10+, Linux, and Windows 7+ are supported._\n\n#### Download the latest version of CrossOver from the [releases page](https://github.com/lacymorrow/crossover/releases/latest)\n\n##### _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 -\u003e `Keep` to finish downloading. Windows Defender and Mac Gatekeeper will prevent you from running the app the first time._\n\n\n##### Windows\n\n[**Download**](https://github.com/lacymorrow/crossover/releases/latest/download/CrossOver.exe) the `.exe` file. _**(CrossOver-Setup-x.x.x.exe)**_\n\n\u003e Windows protected your PC.\n\n- Click `More Info`\n- Click `Run Anyway`\n\n\n##### Mac\n\n[**Download**](https://github.com/lacymorrow/crossover/releases/latest) the `.dmg` file. _**(CrossOver-x.x.x.dmg)**_\n\n\u003e \"CrossOver\" cannot be opened because the developer cannot be verified.\n\n- Locate the `CrossOver` app\n- Hold Control while you click the app icon, then choose Open from the shortcut menu\n\n\u003e \"CrossOver is damaged and can't be opened...\"\n\nM1 Mac security fix: (_thanks [Yoyopizzacat, #207](https://github.com/lacymorrow/crossover/issues/207#issuecomment-1212708790)_)\n\n- Make sure CrossOver is in your `/Applications` folder\n- Open your terminal and type `sudo xattr -r -d com.apple.quarantine /Applications/CrossOver.app`\n- Type in your password and now you can use CrossOver!\n\n\n##### Linux\n\n[**Download**](https://github.com/lacymorrow/crossover/releases/latest) the file appropriate to your system. (`.AppImage`, `.apk`, `.deb`, `.freebsd`, `.pacman`, `.rpm`, `.snap`)\n\n_The AppImage needs to be [made executable](http://discourse.appimage.org/t/how-to-make-an-appimage-executable/80) after download._\n\n_Certain lightweight desktop environments may require a compositor to allow CrossOver to work correctly ([#230](https://github.com/lacymorrow/crossover/issues/230))._\n\n###### _Further instructions for [Windows](https://www.techjunkie.com/windows-protected-your-pc-disable-smartscreen/) and [Mac](https://support.apple.com/en-us/HT202491)_\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-chooser.png\"/\u003e\n\u003c/p\u003e\n\n\n---\n\n# Usage\n\n\u003e ❌ marks the spot…\n\n**Position:** Click and drag the crosshair to anywhere on any screen. Double-click the bullseye to center the app.\n\n**Choose Crosshair:** Click the bullseye ◎ to select from tons of preloaded crosshairs. Drag an image to the window to use your own custom crosshair.\n\n**Customize** settings using the \"gear\" icon. _See [Settings](#settings) below._\n\n**Unlock the app to quit** using \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eX\u003c/kbd\u003e, then click the close icon in the top-left corner. In Windows you can right-click on the crosshair window \u003e `Close`.\n\n#### Default Keyboard Shortcuts\n\n| Description                                                | Keys                                                                 |\n| ---------------------------------------------------------- | -------------------------------------------------------------------- |\n| Toggle the settings window and lock the crosshair in place | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eX\u003c/kbd\u003e      |\n| Move the crosshair a single pixel                          | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eArrows\u003c/kbd\u003e |\n| Quickly hide/show the application                          | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eH\u003c/kbd\u003e      |\n| Center the crosshair window                                | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eC\u003c/kbd\u003e      |\n| Move the crosshair to the next connected display           | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eM\u003c/kbd\u003e      |\n| Duplicate your crosshair in a shadow window                | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eD\u003c/kbd\u003e      |\n| Display the \"About\" window details                         | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eA\u003c/kbd\u003e      |\n| Reset all settings and center the window                   | \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eR\u003c/kbd\u003e      |\n\n###### Mac: the \u003ckbd\u003eOption\u003c/kbd\u003e key is used instead of \u003ckbd\u003eAlt\u003c/kbd\u003e.\n\n###### Linux: Some distributions do not center on double-click.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/demo-settings.png\"/\u003e\n\u003c/p\u003e\n\n\n---\n\n## Settings\n\n##### Crosshair\n\nChoose 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.\n\n##### Reticle\n\nThe 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.\n\n##### Hide on ADS\n\nChoose a mouse button to use as your ADS button. The crosshair will be hidden while this button is held down.\n\n##### Harware acceleration\n\nA handful of users have reported FPS issues with certain games ([#70](https://github.com/lacymorrow/crossover/issues/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`](#hide-on-ads)\n\n##### Start on boot\n\nYou can automatically set CrossOver to start when your system starts on your gaming PC, so you're always ready to pop heads.\n\n##### Automatic Updates\n\nBy default CrossOver will automatically keep itself updated with bug fixes and improvements. You can disable this in the settings to prevent all network requests.\nCrossOver 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.\n\n#### Keybinds\n\n\u003e See [default keyboard shortcuts](#default-keyboard-shortcuts).\n\u003e 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 \u003ckbd\u003eBackspace\u003c/kbd\u003e or \u003ckbd\u003eDelete\u003c/kbd\u003e to disable a bind.\n\nKeep 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.\n\n##### Duplicate crosshairs\n\nDuplicate 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.\n\n##### Reset\n\nTo reset all settings and binds to default, press \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eAlt\u003c/kbd\u003e-\u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eR\u003c/kbd\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003cbr /\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg width=\"120\" height=\"120\" style=\"width:120px; height:120px;\" src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/The%20Diatoku/Purple.png\"\u003e\n\t\u003cimg width=\"120\" height=\"120\" style=\"width:120px; height:120px;\" src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Kenney/crosshair035.png\"\u003e\n\t\u003cimg width=\"120\" height=\"120\" style=\"width:120px; height:120px;\" src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Special%20Requests/Monkeybolo.png\"\u003e\n\t\u003cimg 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\"\u003e\n\t\u003cimg width=\"120\" height=\"120\" style=\"width:120px; height:120px;\" src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/crosshairs/Actual/leupold-dot.png\"\u003e\n\u003c/p\u003e\n\n---\n\n## [What works/doesn't work (compatability)](https://github.com/lacymorrow/crossover/issues/47)\n\n###### ❌ Most games don't work in Fullscreen mode on Windows or Linux\n\n| Works | Game                              | Notes                                                                              |\n| ----- | --------------------------------- | ---------------------------------------------------------------------------------- |\n| ✅    | Among Us                          | |\n| ✅    | Apex Legends                      | Runs in `Windowed` mode                                                            |\n| ✅    | Call of Duty Black Ops Cold War   | Runs in `Windowed`, `Windowed Fullscreen`, `Multi-Monitor` modes                   |\n| ✅    | Call of Duty: Warzone             | Runs in `Windowed` mode                                                            |\n| ✅    | Counter-Strike (1.6)              | Runs in `Windowed` mode                                                            |\n| ✅    | CS:GO / Counter-Strike: Global Offensive | Runs in `Windowed` mode; May work in `Windowed Fullscreen` and `Fullscreen` modes with AHK script |\n| ✅    | CS 2 / Counter-Strike: 2          | Runs in `Windowed` mode; Doesn't work in `Fullscreen` modes with/without AHK script |\n| ❌    | Cyberpunk 2077                    | Does not work. (Vulkan)                                                             |\n| ✅    | Dead by Daylight                  | Runs in `Windowed` and `Fullscreen` modes                                          |\n| ✅    | Deceit                            | Runs in `Windowed` mode                                                            |\n| ✅    | Destiny 2                         | Runs in `Windowed Fullscreen` mode; _Some reports of running in `Fullscreen` mode_ |\n| ✅    | Empyrion: Galactic Survival       | Runs in `Windowed` mode                                                            |\n| ❌    | Escape from Tarkov                | Users report the game will no longer start with CrossOver running ([#47](https://github.com/lacymorrow/crossover/issues/47#issuecomment-987762466))                                                      |\n| ✅    | FiveM                             | Runs in `Fullscreen` mode                                                          |\n| ✅    | Fortnite                          | Runs in `Windowed Fullscreen` mode                                                 |\n| ✅    | GTFO                              | Works in `Fullscreen window`, `Maximized window`, `Windowed mode` (Doesn't work in `Exclusive Fullscreen` window) |\n| ❌    | Hunt: Showdown                    | Works in `Windowed mode` |\n| ✅    | Killing Floor                     | Runs in `Windowed` mode                                                            |\n| ✅    | League of Legends                 | Runs in `Borderless` and `Windowed` modes                                          |\n| ✅    | Left 4 Dead 2                     | Runs in `Borderless` and `Windowed` modes                                          |\n| ✅    | Halo: The Master Chief Collection | Runs in `Borderless` and `Windowed` modes                                          |\n| ❌    | Metro Exodus Gold Edition         | Doesn't work under any circumstances                                               |\n| ✅    | Overwatch                         | Runs in `Windowed Fullscreen` mode                                                 |\n| ✅    | Phasmophobia                      | Runs in `Windowed` and `Fullscreen` modes                                          |\n| ✅    | Planetside 2                      | Runs in `Windowed` and `Windowed Fullscreen` modes                                 |\n| ❌    | Rainbow 6: Seige                  | Vulkan-based                                                                       |\n| ❌    | RedM                              | Does not work.                                                                     |\n| ✅    | Roblox                            | Runs in `Fullscreen` mode _(Windows)_ and `Windowed Fullscreen` mode _(MacOS)_     |\n| ✅    | Rocket League                     | Runs in `Windowed` mode                                                            |\n| ✅    | Rust                              | Runs in `Windowed Fullscreen` mode                                                 |\n| ❌    | Sea of Theives                    | **BANNABLE**                                                                       |\n| ✅    | Star Wars Battlefront 2           | Runs in `Borderless` mode                                                          |\n| ✅    | The Finals                        | Runs in `Borderless` and `Windowed` modes                                          |\n| ✅    | Tom Clancy's The Division 2       | Runs in `Windowed Fullscreen` mode                                                 |\n| ✅    | Tony Hawks Pro Skater 1+2         | Such a fun game!                                                                   |\n| ❌    | Vulkan-based games                | |\n| ✅    | Valorant                          | Runs in `Borderless` and `Windowed` modes                                          |\n\n\u003e Reported from our users, [add your resuts](https://github.com/lacymorrow/crossover/issues/47)\n\n#### Operating Systems\n\n| Works | OS                      | Notes                                                                                                     |\n| ----- | -------------------     | --------------------------------------------------------------------------------------------------------- |\n| ✅    | MacOS arm64 _(M1, M2)_  | You may need to run a command to un-quarantine the download, see below |\n| ✅    | MacOS x64 _(Intel)_     | Tested on Catalina 10.15.1                                                                                |\n| ✅    | Windows 11              |\n| ✅    | Windows 10 ia32         |\n| ✅    | Windows 10 x64          | Custom cursors do not show in draggable taskbar area                                                      |\n| ✅    | Windows 8               |                                                       |\n| ❓    | Windows 7               | Does not work in Windows 7 Home; Works in Windows 7 Pro [#63](https://github.com/lacymorrow/crossover/issues/63)|\n| ❓    | Arch                    | Tested in v2021.01.01                                                                                     |\n| ✅    | Elementary OS           | Tested in v5.1                                                                                            |\n| ✅    | Fedora                  | Tested in v33 (Shortcut conflicts with desktop switching)                                                 |\n| ✅    | Mint                    | Tested in v20.1                                                                                           |\n| ✅    | Ubuntu                  | Tested in v20.04.1                                                                                        |\n\n###### Newer MacOS' may quarantine the `CrossOver.app` package. To un-quarantine:\n\n- Move `CrossOver.app` to your `Applications` folder\n- Open terminal and type: sudo xattr -r -d com.apple.quarantine /Applications/CrossOver.app\n\n\u003e via [@Yoyopizzacat](https://github.com/lacymorrow/crossover/issues/207#issuecomment-1212708790)\n\n---\n\n# Development\n\nBuilt with [Electron](https://electronjs.org). Simple HTML and Javascript, no framework.\n\nStart 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`]()\n\n### Run\n\n##### _You will need [node.js](https://nodejs.org/) v14.x.x installed. If you have `nvm` installed, run `nvm install \u0026\u0026 nvm use` to switch to the correct node version._\n\n```\n$ yarn \u0026\u0026 yarn start\n```\n\n### Build\n\n\u003e Build steps optimized for Mac, see [electron.builder](http://electron.builder) for help customizing builds.\n\n_wine_ and _mono_ must be installed for Windows builds _(macOS)_\n[_multipass_](https://multipass.run/) must be installed for Snap builds _(macOS)_\n\n```\n$ yarn build\n```\n\n\u003e Or `yarn build:all`\n\n#### Build issues\n\n**Test CI builds on Mac and PC before releasing**\n\n```\n'CrossOver' is damaged and can't be opened.\n```\n\nCI builds do not seem to work correctly for Mac. Try using a real Mac to build.\n\n\n**Test closing via the traffic lights on Mac**\n\nCalling `process.exit()` before the app is done \"quitting\" will cause the app to crash on Mac.\n\n\n```\ni386 architecture deprecated in MacOS\n```\n\nNewer versions of OSX cannot build for 32-bit apps, use CircleCI to build those.\n\n\n```\ngyp: name 'openssl_fips' is not defined while evaluating condition 'openssl_fips != \"\"' in binding.gyp while trying to load binding.gyp\n```\n\nSee https://stackoverflow.com/questions/69882740/how-to-rebuild-epoll-package-in-electron.\n\nUsing Node@16 worked.\n\n```\n/Users/lacymorrow/repo/crossover/node_modules/app-builder-bin/mac/app-builder_arm64 process failed ERR_ELECTRON_BUILDER_CANNOT_EXECUTE\nExit code:\n1 failedTask=build stackTrace=Error: /Users/lacymorrow/repo/crossover/node_modules/app-builder-bin/mac/app-builder_arm64 process failed ERR_ELECTRON_BUILDER_CANNOT_EXECUTE\n```\n\nTo build rpm, executable rpmbuild is required, please install: `brew install rpm`\n\n\n#### Continuous Integration (CI)\n\nWe use [GitHub Actions](https://github.com/lacymorrow/crossover/actions), [CircleCI](https://circleci.com/gh/lacymorrow/crossover) and [Appveyor](https://ci.appveyor.com/project/lacymorrow/crossover) to build and test CrossOver on every commit. Circle and GitHub build for all targets, Appveyor builds for Windows.\n\nCircleCI builds are published to the [Snap Store](https://snapcraft.io/crossover) and GitHub Releases while Appveyor builds are published to the [Windows App Store](https://apps.microsoft.com/detail/9MTD5ZLN7NL1).\n\nCircleCI needs the following environment variables:\n\n- `GH_TOKEN` aka a Personal Access Token\n\n**[As of v7](https://snapcraft.io/docs/snapcraft-authentication), use the `SNAPCRAFT_STORE_CREDENTIALS` environment variable instead of the following**\n\n- ~~`SNAP_TOKEN` aka a Snapcraft API token, generated with **snapcraft v6 (NOT v7+)** using `snapcraft login` and `snapcraft export-login token.txt`~~\n\n\nTo install `snapcraft` on a Mac:\n\n- You'll need Multipass: `brew install multipass --cask`\n\n- Then install snapcraft: `brew install snapcraft`\n\n\n### Publish\n\n```\n$ yarn release\n```\n\nThen edit the automatically created GitHub Releases draft and publish.\n\n## Bugs\n\n### [Hidden by fullscreen apps](https://github.com/lacymorrow/crossover/issues/1)\n\n**Currently CrossOver only works with windowed applications**, use `Windowed Fullscreen` mode if your game or application supports it. (_Windows_)\n\nFullscreen for MacOS may have better results.\n\n##### Workaround using AutoHotKey (Windows)\n\n\u003e via [@girkovarpa](https://github.com/lacymorrow/crossover/issues/47#issuecomment-805017469)\n\nIf you absolutely need to use `Fullscreen` mode, or your game is not supported by crossover, there is a workaround using [AutoHotKey](https://www.autohotkey.com/).\n\n_Doesn't work with some games [#47](https://github.com/lacymorrow/crossover/issues/47#issuecomment-895995990), and causes FPS issues in other cases_\n\nInstall AutoHotKey and run this script with it (save it as `script.ahk` and double-click it):\n\n```autohotkey\nHome::Winset, Alwaysontop, , CrossOver\n```\n\nOnce in-game, pressing space should put the crosshair over the screen, even in fullscreen mode.\n\n### Performance Issues\n\nThere are reports of stuttering when using V-SYNC, G-SYNC, or similar Adaptive Sync ([#330](https://github.com/lacymorrow/crossover/issues/330)). Disabling these may improve performance.  s\n\n### Graphical issues on Linux\n\nCheck your desktop environment. CrossOver may not work on KDE, try GNOME if you experience issues.\n\nCrossOver behaves weirdly if your desktop is missing a compositor ([#230](https://github.com/lacymorrow/crossover/issues/230)). Try installing one to see if that resolves the issue.\n\n### Hidden by fullscreen apps on Linux\n\nSome 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.\n\nGNOME's Mutter is one of those compositors that can do this.\n\nIn Lutris, for example, this can be automated with shell scripts that will run when the game is launched and quit.\n\nLutris-\u003eRight click on game's banner-\u003eConfigure-\u003eSystem options:\n\n`Pre-launch script`: /path/to/x.sh\n\n```shell\n#!/bin/bash\nmutter --replace # or: gnome-shell --replace\n```\n\n`Post-launch script`: /path/to/x.sh\n\n```shell\n#!/bin/bash\nkwin_x11 --replace\nplasmashell --replace\n```\n\n## Debugging\n\nYou 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:\n\n\u003e (Mac, Linux)\n```sh\n╭─  lacymorrow in /Applications/CrossOver.app/Contents/MacOS using\n╰─○ $ ./CrossOver --debug\n09:45:16.023 › CrossOver 2.7.4 Development\n09:45:16.030 › Setting: Enable GPU\n09:45:16.487 › App ready\n```\n\n### Command-line lags\n\n#### `--debug`\n\n_alias_ `-d`\n\nStart CrossOver in debug mode, with Chrome DevTools open.\n\n#### `--reset`\n\n_alias_ `-r`\n\nReset all app preferences to default, in case you get into a broken state.\n\n#### `--version`\n\n_alias_ `-v`\n\nPrint the app version to `stdout` (Good for CI).\n\n\n# Credits\n\nAn extra big thanks to the crosshair providers, as this wouldn't be possible without them:\n\n- Reddit user [/u/IrisFlame](https://www.reddit.com/user/irisflame/)\n\n- [Kenney.nl Crosshair Pack](https://kenney.nl/assets/crosshair-pack) (_donate to him, not me_)\n\n\u003e Gaming, Crosshair, Crossover App\n\nSee CrossOver in the [Electron Apps library](https://www.electronjs.org/apps/crossover)\n\nCreated by [Lacy Morrow](http://lacymorrow.com)\n\n\n# Support this project\n\n\u003e **TL,DR: If you enjoy this project, and are financially able, why not donate $3?**\n\n### 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.\n\nProblem is, downloads don't pay the bills.\nIf you would like to see specific features or improvements added to CrossOver, consider donating on [OpenCollective](https://opencollective.com/crossover)\n\n## If you like this software and want to see it improved more often, consider supporting me on [Patreon](https://patreon.com/lacymorrow) or through another channel:\n\n### Tip Crypto\n\n- **BTC:** `3Bdu2sTAmXyZzqeRQxCt6P22zHtTLg4mQE`\n- **ETH:** `0x5be1074a5148F8D723dE1F2Dd326e1B15c82553D`\n\n\u003ca href=\"https://www.patreon.com/bePatron?u=55065733\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/lacymorrow/crossover/raw/master/src/static/meta/patreon-button.webp\" style=\"height:50px;\" height=\"50\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"https://opencollective.com/crossover/donate\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/crossover/donate/button@2x.png?color=blue\" style=\"height:50px;\" height=\"50\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"https://www.buymeacoffee.com/lm\" target=\"_blank\"\u003e\u003cimg style=\"height:50px;\" height=\"50\" src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" \u003e\u003c/a\u003e\n\n","funding_links":["https://github.com/sponsors/lacymorrow","https://patreon.com/lacymorrow","buymeacoffee.com/lm","lacymorrow.com/donate","https://www.patreon.com/bePatron?u=55065733","https://www.buymeacoffee.com/lm","https://opencollective.com/crossover","https://opencollective.com/crossover/donate"],"categories":["JavaScript","好玩项目"],"sub_categories":["沙雕项目"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacymorrow%2Fcrossover","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flacymorrow%2Fcrossover","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacymorrow%2Fcrossover/lists"}