From 49b32076aae5382ab395a6c47b33e6b6f7b8b9a1 Mon Sep 17 00:00:00 2001 From: Matthew Turk Date: Sat, 21 Feb 2026 14:40:48 -0600 Subject: [PATCH] Add comments about keyboard lock --- docs/Platforms-and-Players/EmulatorJS-Player.md | 11 +++++++++++ docs/Platforms-and-Players/MS-DOS.md | 2 ++ 2 files changed, 13 insertions(+) diff --git a/docs/Platforms-and-Players/EmulatorJS-Player.md b/docs/Platforms-and-Players/EmulatorJS-Player.md index 6bd81560..fe17d50c 100644 --- a/docs/Platforms-and-Players/EmulatorJS-Player.md +++ b/docs/Platforms-and-Players/EmulatorJS-Player.md @@ -15,6 +15,17 @@ Our integration with EmulatorJS automates the process of loading and save files and save states. Before starting the game, select a save and/or state file to load (if one is available). Anytime you manually save the game (or create a save state) by clicking the save or "save and quit" buttons, the save and state files stored with RomM will be updated, so there's no need to manually download or upload them. +### Keyboard Lock + +Some emulation platforms use the Escape key, which is reserved (by default) in browsers for exiting fullscreen mode. Some browsers support an additional keyboard lock, where the Escape key can instead be forwarded to the application, and exiting fullscreen mode requires holding the Escape key for a few seconds. To enable this keyboard lock, set the `emulatorjs.keyboard_lock` option in your `config.yml`: + +```yaml +emulatorjs: + keyboard_lock: true +``` + +This is not supported by all browsers but is known to work with Chrome. + ### Netplay Netplay lets you play with friends remotely, in realtime with the build-in web player. As it emulates playing on the same console with two controllers while streaming the video to players 2+, it's best for 2-player, co-op, turn based and party games. diff --git a/docs/Platforms-and-Players/MS-DOS.md b/docs/Platforms-and-Players/MS-DOS.md index 17c60e46..3f372341 100644 --- a/docs/Platforms-and-Players/MS-DOS.md +++ b/docs/Platforms-and-Players/MS-DOS.md @@ -30,6 +30,8 @@ The official method to run the games from the EmulatorJS dev is the following (O - `dir` - to find the .EXE file - `filename.exe` - This will run the .exe and run the game, you might need some additional configuration but that is purely on the dosbox side and you might need to run the setup.exe file or a file name similiar. +If you are having issues with keyboard lock, try setting the `config.yml` option `emulatorjs.keyboard_lock` to `true`. + #### Advanced Running Games