stateford/display-lock

Locks cursor to specified window and/or converts windows to borderless fullscreen, and prevents the cursor from spilling into another monitor

Display Lock

Lightweight program that locks cursor in selected window, designed with performance in mind.

USES

---

• Keeps cursor in a windowed game to prevent clicking outside
• Will stay active while the window is focused
• Keeps cursor in a fullscreen game while using a multi-monitor setup
• Converts any window into a borderless and/or fullscreen window (when set in settings)

Contributing

---

Contributions are always welcome, but please check Contributing guidelines before making a pull request.

EXAMPLE

---

display-lock's Issues

Minimize to System Tray on Close Setting

Minimize to System Tray on Close should be a setting instead of doing it by default.

Disable Hotkey On Settings Menu

Currently the hotkey button is enabled on the settings menu and should be temporarily disabled until the tab is switched. The key should be unregistered, and re-registered after the switch.
The current hotkey should appear in the Hotkey control box

Appveyor Deployment

Add Appveyor deployment strategies for releases.

• Automatic signing of application with private keys
• Automatic deployment to github releases

Refactor Write/Read file to include path as an argument

readSettings() and writeSettings() should take an additional argument of path.

path should be generated from a new function, which checks to see if path exists. If it doesn't exist, it will be created.

• pass in version instead of determining in the function
• Separate function to create path

System Tray Context Menu - Users can select a window while running

Current Results: Users are able to select a window from the system context menu while the lock is running. This causes undefined behavior, as the previous thread would not be disabled.

Expect Results: Windows should be locked while the application is running.

Save config to appdata to make more portable

Create application whitelist

Create a whitelist of applications that should be polled for automatically and start locking when displayed.

This feature should have a enable/disable. The polling should stop after the first application is found or disable is clicked. When an application is found all start / stop controls should be disabled.

Logging for debug build

Debug builds should enable logging that will open a file in the users %APPDATA% folder and write to it throughout the duration of the applications lifetime.

This should be simple to implement without external libraries.

Logging code should be placed in it's own project as a static library.

Prevent resizing of selected windows

You can resize windows while locked.

Script to auto increment version.h

Create an auto increment build number for the application. Should appear like this:
2.0.0.{build}

• Create Version.rc
• Create Version.h
• Create script in increment Version.h build number from appveyor

Factor out message loop

The current message loop is too long and too complex. It should be factored out into smaller functions / loops.

Minimize to System Tray

Add functionality that will allow Display Lock to minimize to the system tray

If Display Lock is closed before hitting stop

If Display Lock is closed before hitting stop the window will not revert any full screen / borderless window changes.

Create installer

Display lock should use an installer / uninstaller to clean up any files generated.

This should include the config file.

Check when a window is closed

Check if a window is closed, if it is the following must happen:

• Stop clipping thread
• Unlock Menu Options
• Clear the Combobox

Check for Updates

Create functions to contact server to allow checking for updates

To minimize external dependencies, this should either use native windows bindings for SSL such as or

Create new dialog for creating hotkeys

A new dialog should appear when changing hotkeys.

New hotkeys should be enabled, such as toggling borderless windowed and full screen modes

• Dialog Box

The code for all of this is within the project

Appveyor Script to get release info

Need a script to get release info from the changelog and post it when appveyor creates a release

Check if window is already fullscreen or borderless

There's currently a bug where if the window is already fullscreen or borderless when the user hit's start, the application with add a border to the window. This behavior should be avoided.

README images are broken

README images are broken. They should point to images hosted on gh-pages.

Remove duplicated/unnecessary variables and functions

This will cut down on ram usage. It's currently at 1.2 MB, however we can cut the size down. The point of the program is to squeeze every last ounce of performance as possible, even though it probably doesn't matter on modern systems.

Version header file is broken

Version.h and build script needs to be edited to take the following parameters:

major, minor, revision, build

currently versionRC.rc is only set for 2,0,0,VERSION_BUILD and must be modified

Hotkey Support

Allow the use of hotkeys. There should be an area in the settings to allow the user to set hotkeys for various actions. Config will need to be updated to store hotkeys.

struct SETTINGS {
   int version++;
    ....
   int hotKeyNum;
   HOTKEY hotkeys[hotKeyNum];
}

Possible actions include:

• Start / Stop
• Pause / Resume

https://docs.microsoft.com/en-us/windows/desktop/menurc/using-keyboard-accelerators#creating-a-run-time-accelerator-table

https://docs.microsoft.com/en-us/windows/desktop/api/winuser/nf-winuser-registerhotkey

Tasks:

• Write Tests
• Create Hotkey Listener
• Update Settings UI
• Update Config

Add Window Selection to System Tray Context Menu

We should allow users to select a window from the system tray context menu. This should be fairly simple to implement as the code is already there.

Every time the user right clicks the system tray the submenu item should be cleared and repopulated

Add UI Functions

Move the handling of UI stuff to a function to clean up the main message loops

• Function for extracting version
• Function for initializing windows
• Function for shutting down

Allow locking to specific monitors

Allow locking to specific monitors instead of just windows.

The logic to lock to a RECT object is already in the program, just need to get store an array of monitor objects.

Detect when a window style has changed

Detect when a windows style has changed. For instance starting a lock with borderless fullscreen and changing and option in the menu will cause the window to revert to it's original state.

System Tray Context Menu - Stop button should be greyed out when not running

The stop button in the system tray context menu should not be enabled when the program is currently not locking to a specified window.

Appveyor Artifacts

Create artifacts from appveyor

Window will not get focus when clicking in main area

The Main Window will not get focus by clicking into the main window area.

Clicking anywhere should cause the window to take focus.

Prevent background windows from showing in combo-box

Common windows applications that have no presented window and run in the background show within display locks combo box.

Examples: Microsoft Store and Calculator.

Settings Menu

Settings

---

• Minimize when locking
• Borderless
• Fullscreen
• Bring selected window to foreground
• Hotkey

What is the hotkey??

What is the hotkey to start/stop the software if there is any ?

Last task menu entry opens "about" popup

Selecting the last entry in the right click context menu on the task bar it opens the about pop up window.

develop/2.1.0.33 is the version this bug is in.

Add support for 32-bit

This is fairly easy, I believe the issue is with LoadString() and LoadStringW() on x86/x64

Something like this

#ifdef _X86
#define LOADSTRING LoadString
#else
#define LOADSTRING LoadStringW
#endif

There might be a few other functions, but this should be the cause of the issues.

Allow users to select which monitor to fullscreen

Allow user to select default monitor

Allow a user to select a default monitor and choose which monitor to display a full screen application on.

Also need an auto detect option which will select the monitor the app is currently on. This will be done by checking against monitors. A struct will need to be made to store monitor information.

typedef struct MONITOR {
    RECT rect;
} MONITOR

MONITOR *monitors = malloc(sizeof(MONITOR) * 3);

Create Tests

Create tests for the following:

• Setting default settings
• Reading various settings from files
• Check File Header
• Checking file version
• Rejecting bad files
• Writing various settings

Move from appveyor to github actions

As soon as github actions are available, This project will be migrated from appveyor to github actions.

• Build Executable
• Run Tests
• Set Version Numbers
• Deploy Artifacts
• Deploy Artifacts to release (on git tags)

Boarderless Full-Screen

Improve documentation

Documentation should be improved. Things from the README to how the config system works, and test files.

• Config System
• Messages
• UI Elements
• Better Comments
• Tests
• README.md

Bring selected window to front when using task bar context menu.

It would be convenient if selecting a window within the right click task bar menu also brings that window to the front and makes it the active window.

Thanks!

Fix alt+tab bug

The issue is caused by the alt-tab view being it's own window, and the list being constantly updated on another thread. This should be fine, but in our case we should only update the list when it is clicked by using the CBN_DROPDOWN event.

Add a setting to check for an update on startup

Fairly straight forward. Should be able to reuse functions from #105

Start Button does not lock combobox

Combobox is supposed to be locked while the application is running the clipping operations.

Assert Testing for Debug Builds

Debug builds should contain assert testing that are only enabled when the pre-processor flag NDEBUG is defined.

This should be fairly easy. The code should be in it's own C Static Lib and compiled in the main program or in dispLib if the flag is set.

About Window is Missing

The About window is missing.

This should load a string from the resource file and display the current version, as well as a link to either the gh-pages site or the master branch.

Add Settings to System Tray Context Menu

Users should be able to check and uncheck options from the system tray context menu. The code to set things are already in the code base, so this should be a relatively quick thing to implement.

UI will not revert when application is closed

Describe the bug
Closing the game / application will not cause Display Lock to revert the UI to the not running state. The locking threaded loop will stop however.

To Reproduce
Steps to reproduce the behavior:

1. Start locking an application
2. Close the application
3. Notice the UI is still broken

Expected behavior
UI will revert to stopped state when an application is no longer running

Minimize to System Tray should be a setting

System Tray should be enabled by default, but should be a setting.

Should be careful that the settings screen doesn't become too busy as space is limited.