Display Hot Keys
Effortlessly control display settings!
Report Bug
·
Request Feature
·
Releases
### Common Use Cases
* Switch refresh rates to quickly enable the Black Frame Insertion or Backlight Strobing capabilities of the display.
* Easily rotate the display orientation with hot keys.
* Quickly switch between resolutions with different aspect ratios.
* Immediately apply a resolution without entering the in-game menus for video game benchmarking purposes.
* Enlarge or shrink the elements on screen by instantly changing the DPI scale percentage.
* Instantly set a display mode while in a video game if it does not support changing the resolution or refresh rate while in-game.
* Retain your intended display arrangement while changing display resolutions.
* Change settings for multiple displays at the same time with one hot key press.
## Getting Started
This application was made only for the Windows platform. Display Hot Keys also uses elevated privileges to set display modes while in video games. Therefore, if you have UAC enabled, you will get a UAC prompt upon launching the application. If you no longer wish to see this prompt, you can [disable UAC]. The sections that follow will help you get the application up and running on your PC!
### Prerequisites
* Native Windows 10 x64 or Windows 11 x64 operating system installation. Running the app through virtualization software is not fully supported.
### Installation
This application will be distributed as a portable package and as an installer. Only one of either the portable package or installer is needed.
#### Portable
1. Download the zip archive.
2. Unzip the archive.
3. Double-click the DisplayHotKeys executable file or create a shortcut to run the application.
#### Installer
1. Download the installer.
2. Run the installer.
3. Follow the installer prompts.
4. Double-click the created shortcut or the DisplayHotKeys executable file in the install directory to run the application.
## Usage
### Setting Hot Keys
1. Click the "Change Hot Key" button.
2. Press the key combination for the hot key. (Up to three keys can be used!)
3. Release at least one of the keys to set the hot key.
**Note:** A hot key cannot be a subset of another hot key. For example, you cannot have a hot key of "Ctrl + F1" and another hot key of "Ctrl + Shift + F1". However, a hot key can be the same as another hot key if they are for different displays. This will allow you to apply display settings for multiple displays with one hot key!
### Changing the Selected Display
1. Click the "Selected Display" drop-down box.
2. Select the display number you want to change hot keys for.
**Note:** The application will automatically detect newly disconnected and connected displays, and the application will refresh to reflect the display configuration change.
### Changing the Number of Active Hot Key Slots for a Display
1. Click the "Active Slots" drop-down box.
2. Select one of the values.
**Note:** There can be up to 12 active hot key slots for each connected display.
### Selecting Display Settings
1. Select a display mode value in the "Display Mode" drop-down box for the hot key slot.
2. Select a scaling mode value in the "Scaling Mode" drop-down box for the hot key slot.
* Select "Preserved" to preserve the aspect ratio of the image.
* Select "Stretched" to stretch the image to the edges of the panel.
* Select "Centered" to center the image in the middle of the panel without scaling.
**Note:** You may need to use GPU Scaling in your display driver settings to prevent the monitor from overriding the scaling mode.
3. Select a DPI scale percentage value in the "DPI Scale" drop-down box for the hot key slot.
4. Select a display orientation in the "Orientation" drop-down box for the hot key slot.
* Select "Landscape" for a landscape orientation of no rotation.
* Select "Portrait" for a portrait orientation of 90 degrees rotation.
* Select "iLandscape" for an inverted landscape orientation of 180 degrees rotation.
* Select "iPortrait" for an inverted portrait orientation of 270 degrees rotation.
**Note:** Make sure you can rotate your display before changing the orientation; otherwise, it may be difficult to operate your computer.
### Button Interaction
#### Apply Display Mode
The display settings can be immediately applied by clicking on the "Apply Display Mode" button for a hot key slot.
#### Clear Hot Key
Individual hot keys can be cleared by clicking on the "Clear Hot Key" button for a hot key slot when a hot key is set.
#### About App
Opens a window to display the current version, PayPal donate button, license button, and releases button.
#### Change Theme
The theme can be changed between "Light Mode" and "Dark Mode" by clicking on the "Change Theme" button. The icon will change to indicate the current theme.
#### Run On Startup
The application can start automatically when the user logs into Windows by clicking on the "Run On Startup" button. The arrow will turn green to indicate that this option is enabled. The application will start minimized to the system tray.
#### Minimize To Tray
The application will be minimized to the system tray when the "Minimize To Tray" button is toggled on. To restore the application, click the system tray icon and select "Restore".
#### Refresh App
If you have created a custom display mode while the application is running, there is a "Refresh App" button that will refresh the application to reflect the new display mode.
#### Clear All Slots
All hot key slots for the selected display can be reset by clicking on the "Clear All Slots" button.
#### Minimize App
The application will be minimized to the task bar or system tray depending on the state of the "Minimize To Tray" button.
#### Exit App
To exit the application, click on the "Exit App" button. You can also exit the application from the system tray by clicking on the system tray icon and selecting "Exit".
#### PayPal Donate
If you find the application useful and wish to donate, the "PayPal Donate" button will open a PayPal donation web page.
#### Releases
Opens a web page in the default browser to display the releases for Display Hot Keys in descending order.
## Roadmap
- [x] Release the initial build.
- [x] Add scaling mode selection.
- [x] Add multi-monitor support.
- [x] Add display orientation selection.
- [x] Add button to immediately apply display modes.
- [x] Add a minimize to tray toggle.
- [x] Add ability to change display orientation with hot keys.
- [x] Add an "About" view to display current app information.
- [x] Add support for virtual displays and display duplication.
- [x] Add event-driven display configuration detection.
- [ ] Add event-driven new display mode detection.
- [ ] Add clearing of individual slots.
See [open issues] for a full list of proposed features (and known issues).
## License
Distributed under the [MIT License]. See LICENSE.txt for more information.
## Contact
Jonathan R. Miller - jonRock1992@gmail.com
## Dependencies
* [Java (low-level) System Hook] · [MIT License]
* [FlatLaf - Flat Look and Feel] · [Apache License 2.0]
* [Material Design Icons] · [Apache License 2.0]
* [PayPal Donate Button] · [AGPL License 3.0]
* [SystemTray] · [Apache License 2.0]
* [Ini4j] · [Apache License 2.0]
* [Apache Maven Assembly Plugin] · [Apache License 2.0]
* [Maven Compiler Plugin] · [Apache License 2.0]
Distribution made possible with the following tools:
* [launch4j]
* [Inno Setup]
**Disclaimer:** Development of Display Hot Keys is not contingent on donations. PayPal is a registered trademark of PayPal, Inc. The PayPal logo is a trademark of PayPal, Inc.
