https://github.com/webfriendlyhelp/keyquest
Accessible typing adventure game for Windows, built with Python and designed for screen reader support.
https://github.com/webfriendlyhelp/keyquest
accessibility assistive-technology educational-game keyboard-accessible learning-game pygame python screen-reader typing-game windows
Last synced: 23 days ago
JSON representation
Accessible typing adventure game for Windows, built with Python and designed for screen reader support.
- Host: GitHub
- URL: https://github.com/webfriendlyhelp/keyquest
- Owner: WebFriendlyHelp
- License: mit
- Created: 2026-02-19T13:36:09.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T05:04:54.000Z (26 days ago)
- Last Synced: 2026-04-02T07:58:17.776Z (26 days ago)
- Topics: accessibility, assistive-technology, educational-game, keyboard-accessible, learning-game, pygame, python, screen-reader, typing-game, windows
- Language: Python
- Homepage: https://csm120.github.io/KeyQuest/
- Size: 16.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.html
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
KeyQuest User Guide
:root {
color-scheme: light;
}
body {
font-family: Arial, sans-serif;
font-size: 18px;
line-height: 1.6;
color: #111;
background: #fff;
margin: 0;
padding: 0;
}
a {
color: #0b57d0;
}
a:hover {
text-decoration-thickness: 2px;
}
a:focus-visible,
button:focus-visible,
[tabindex]:focus-visible {
outline: 3px solid #111;
outline-offset: 2px;
}
.skip-link {
position: absolute;
left: 8px;
top: -48px;
z-index: 1000;
background: #fff;
color: #111;
border: 2px solid #111;
padding: 8px 10px;
text-decoration: none;
}
.skip-link:focus {
top: 8px;
}
header,
nav,
main,
footer {
display: block;
}
header,
nav,
footer {
padding: 0 24px;
}
main {
max-width: 900px;
margin: 0 auto;
padding: 24px;
}
.content {
max-width: 75ch;
}
.content-block {
max-width: 75ch;
margin: 0 auto;
}
.hero {
margin: 16px 0 24px;
}
.hero img {
display: block;
width: 100%;
max-width: 960px;
height: auto;
border: 1px solid #d0d7de;
border-radius: 16px;
}
h1, h2, h3 {
line-height: 1.3;
}
h1 {
margin-top: 0;
}
section {
border-top: 1px solid #ddd;
padding-top: 16px;
margin-top: 16px;
}
ul,
ol {
padding-left: 20px;
}
.note {
background: #f4f4f4;
border-left: 4px solid #666;
padding: 10px;
}
KeyQuest User Guide
Version {{APP_VERSION}}
This guide is written for all users, including screen reader and keyboard-only users.
On This Page
- Welcome
- Quick Start
- Main Menu Sections
- Using Your Own Sentences
- Downloads
- Accessibility
- New in Key Quest
- Need Help
- License
- Unsigned Build Notice
Welcome
KeyQuest is a typing practice program you can use with your keyboard only.
It gives speech and visual feedback so you can practice in the way that works best for you.
It includes guided lessons, practice modes, typing tests, games, progress tracking, and a virtual pet.
Want a quick list of recent changes? Open New in Key Quest.
Quick Start
- Open KeyQuest.
- Use the Up and Down arrow keys to move through menu items.
- Press Enter or Space to open a section.
- In active practice or gameplay modes, press Escape 3 times to return to Main Menu. The remaining press count is shown on screen and announced by speech.
Press Ctrl+Space in typing modes to hear the current prompt or remaining text. Sentence typing must match capitalization and punctuation exactly.
Main Menu Sections
Tutorial
Start here if you are new. It teaches key locations step by step.
Keyboard Explorer
Press keys and hear what they are, where they are, and how they are commonly used. Home-row keys also include short orientation help where it matters, including the F and J bumps.
Lessons
Structured typing lessons that gradually add more keys as you improve. Longer lesson text wraps on screen, and lesson intros can now be reviewed one item at a time with the arrow keys instead of being read all at once.
Free Practice
Practice learned keys without affecting lesson progression. You can now choose from your unlocked lessons first, so Free Practice matches the key range you have already reached.
Speed Test
Choose a time limit and test your typing speed and accuracy. Type each sentence exactly as shown, including capitalization and punctuation.
Sentence Practice
Type sentences for ongoing practice. Type each sentence exactly as shown, including capitalization and punctuation. If you make a mistake, KeyQuest spells the first missed word and then reads the rest of the sentence normally. Topics include General, General Spanish, Windows commands, JAWS commands, NVDA commands, science facts, history, geography, math, literature, and vocabulary. You can also edit sentence files or add your own. For Spanish typing, you can enter common accented characters from an English keyboard with shortcuts such as Ctrl+' then a vowel for acute accents, Ctrl+` then n for ñ, and Ctrl+Shift+/ for ¿.
Games
Play typing games with speech and visual feedback.
-
Letter Fall: Type one active target letter at a time before it reaches the bottom. Tab reports the current target and how many letters are waiting. Ctrl+Space repeats only the current target. -
Word Typing: Type words quickly and submit each word. Ctrl+Space repeats only the current word. -
Hangman: Guess words letter by letter with an offline dictionary of over 919,000 words and real definitions.
Quests
See active goals and completed goals.
Pets
View and care for your virtual pet. Pets react to your progress.
Pet Shop
Spend coins on pet food, toys, and pet accessories.
Badges
Review your earned badges and locked badges.
Progress Dashboard
See your overall practice history and performance trends.
Practice Log
Review recent sessions in plain language with readable dates, times, durations, activity names, results, and earned rewards. You can also copy the log to the clipboard.
Daily Challenge
Check and complete the current daily challenge.
Key Performance
See which keys are easiest or hardest for you.
Options
Customize how the app sounds and looks. Settings are saved automatically.
-
Speech: Choose automatic, screen reader, text-to-speech, or off. -
Typing Sounds: Set keystroke sound intensity to subtle, normal, or strong. -
TTS Rate: Adjust text-to-speech speaking speed. -
TTS Volume: Adjust text-to-speech volume. -
TTS Voice: Choose a different installed voice for text-to-speech. -
Automatic Updates: Turn startup update checks on or off. When enabled in the installed Windows app, KeyQuest checks GitHub releases for a newer installer. -
Visual Theme: Switch between dark, light, or high contrast. High contrast is applied automatically if Windows High Contrast mode is active. -
Focus Assist: Turn stronger visual emphasis on or off. When enabled, KeyQuest uses stronger panels and focus cues to make the active area easier to find. -
Practice Topic: Choose the sentence language for Speed Test and Sentence Practice. -
Font Size: Choose auto (matches your Windows display scale), 100%, 125%, 150%, 175%, or 200%. Useful on high-DPI or low-vision setups that need larger text.
Learn Sounds
Listen to built-in sounds and learn what each one means.
Check for Updates
Available near the bottom of the Main Menu, just above Key Quest Instructions. KeyQuest checks for a newer release, downloads the right update for your copy from the official GitHub Releases page, installs it quietly or updates the portable folder in place, and then restarts automatically. If updating fails, KeyQuest writes a local error log, tries to copy that log to the clipboard, and offers the setup download. Installed-copy updates now wait for the old app process by PID before starting the installer, which makes the close-and-reopen step more reliable.
Key Quest Instructions
Open this user guide in your default web browser from inside the program.
New in Key Quest
Open the online What's New page in your default web browser to read recent changes in plain language.
About
View application, creator, company, copyright, and license details, open the official website, or open the KeyQuest donation page.
-
Application: KeyQuest {{APP_VERSION}} -
Release Date: 2026-02-19 -
Name: Casey Mathews -
Company: Web Friendly Help LLC -
Tagline: Helping You Tame Your Access Technology -
Copyright: (c) 2026 Casey Mathews and Web Friendly Help LLC -
License: MIT (free to use, modify, and distribute) -
Website: webfriendlyhelp.com (press Enter on Website item to open) -
Official Downloads: GitHub Releases is the official source for KeyQuest downloads and updates. Other builds or download pages are not official KeyQuest releases. -
Donate: Support KeyQuest
Quit
Close the program.
Using Your Own Sentences
KeyQuest can use your own sentence files. This is useful if you want to practice class material, job vocabulary, assistive technology commands, bilingual content, or your own Spanish sentences.
Open the Sentences folder next to KeyQuest.exe. Each text file in that folder becomes a practice topic. For example, a file named My Spanish Practice.txt will appear as a topic named My Spanish Practice.
Put one sentence on each line. You can either create a new text file or edit one of the existing files already in the Sentences folder.
For example, you can open an existing file such as Spanish Sentences.txt or English Sentences.txt and add, remove, or change lines. You can also create a new file for a class, student, workplace, or skill area. This is an easy way to make practice feel more personal and more useful.
KeyQuest cleans sentence files when it loads them. It keeps real language letters such as Spanish accents, but it removes copy-and-paste junk such as odd spacing, emoji, hidden characters, duplicate lines, and common broken text encoding. The cleaned sentences are saved back to the file automatically.
Use plain text and end each sentence with normal punctuation such as a period, question mark, or exclamation point.
KeyQuest keeps user-added sentence files during updates. If a built-in sentence file is updated, KeyQuest merges the built-in and user content without keeping exact duplicate lines.
Downloads
You can download KeyQuest in two simple forms. If you are not sure which one to choose, start with the installer.
Installer
The installer sets KeyQuest up for you. It puts the program in the usual place on your computer and adds shortcuts.
This is the easiest choice for most people.
Download KeyQuest Installer.exe
Portable
The portable version is a zip file. You download it, unzip it, open the folder, and run KeyQuest.exe.
Choose this if you want to keep KeyQuest in one folder, copy it to another computer, or avoid a full installation.
Download KeyQuest Portable.zip
Official KeyQuest downloads are published on GitHub Releases. The in-app updater uses those releases. Other builds, mirrors, or repackaged copies are not official KeyQuest releases.
Both versions can check for updates from inside KeyQuest. The installer updates the installed app. The portable version updates the portable folder in place.
License
KeyQuest is licensed under the MIT License.
See the LICENSE file for full terms.
Accessibility
- Keyboard-only navigation
- Screen reader and TTS support
- Visual focus indicators and clear labels
- Long prompts and typed text wrap across multiple lines on typing and lesson screens instead of being forced onto one line
- Long menus keep the current selection in view more clearly and show when there are more items above or below
- Consistent repeat commands in typing contexts (Ctrl+Space)
- Windows High Contrast mode is detected automatically when your theme is set to Auto
- Font size scaling: auto reads your Windows display scaling; manual 100%, 125%, 150%, 175%, and 200% options are also available
- The app window can be resized and tries to maximize on startup, so larger text has more room to stay on screen
- Visual keystroke feedback: brief green flash on correct key, red flash on error (deaf or hard-of-hearing users)
- Escape press counter shown on screen while exiting active modes
- Optional Focus Assist mode for stronger active-area emphasis on typing and setup screens
- Stronger spacing and grouping on text-heavy screens so the active area is easier to spot
- Shared layout handling now keeps menus and current game screens more stable at larger font sizes and live window sizes
- Built-in larger text options up to 200% for low-vision readability
- Hands-off in-app updating for installed and portable Windows builds using GitHub Releases
- This page uses clear headings, skip navigation, and visible keyboard focus
Need Help
If something sounds wrong or a control does not behave as expected,
share the section name and exact key presses.
That helps fix issues quickly.
-
Website: Web Friendly Help website -
Donate: Support KeyQuest -
Feedback Email: help@webfriendlyhelp.com -
Bug Reports: If an in-app update or unexpected error fails, KeyQuest saves a local error log, tries to copy it to the clipboard automatically, and tells you where it was saved. -
Official Builds: Download KeyQuest from the GitHub Releases page. Other builds or download pages are not official KeyQuest releases.
Unsigned Build Notice
Current KeyQuest builds may be unsigned. On Windows, SmartScreen may show a warning.
- When the warning appears, select More info.
- Select Run anyway if you trust the release source.
For safety, download only from the official GitHub release page.
Installer
KeyQuest can be distributed as a standard Windows installer (KeyQuestSetup.exe) built from the app package.
Installer builds are currently unsigned, so SmartScreen warnings may still appear. Both installed and portable Windows builds can update themselves from the official GitHub Releases page.
During self-update, KeyQuest preserves progress.json. Sentence files are merged during updates so user-added lines and new shipped lines are both kept without exact duplicate entries.
End of KeyQuest User Guide.