Loading repository data…
Loading repository data…
Kyi101 / repository
It lets you press a hotkey, ask one question, and send your current screen into the ChatGPT desktop app. Useful when working in visual tools where text-only questions are too vague.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Windows hotkey for sending your current screen plus one question into the ChatGPT desktop app.
It is built for creative tools where visual context matters: TouchDesigner, Ableton Live, Photoshop, DaVinci Resolve, Blender, browser-based design tools, and similar apps. Press a hotkey, ask a question, and the tool pastes your question plus a screenshot into ChatGPT.
This is a small personal utility, not a full assistant platform.
data/ for recovery.No OpenAI API key is required. The tool uses your installed ChatGPT desktop app.
Run it from Windows Python. WSL/Linux Python cannot see Windows app windows for screen capture and UI automation.
Clone or download this repo into a Windows folder, then run:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Start the hotkey listener:
python scripts\chatgpt_hotkey.py
Then switch to the app you want help with and press:
Ctrl+Alt+Q
Type one question. The tool will capture your screen, focus ChatGPT, paste the question and screenshot, and try to send it.
To run with a small control window instead of a terminal:
pythonw scripts\chatgpt_hotkey.py --ui
Useful options:
python scripts\chatgpt_hotkey.py --once
python scripts\chatgpt_hotkey.py --no-submit
python scripts\chatgpt_hotkey.py --copy-only
python scripts\chatgpt_hotkey.py --list-windows
python scripts\chatgpt_hotkey.py --hotkey ctrl+alt+t
python scripts\chatgpt_hotkey.py --process-name ChatGPT.exe
python scripts\chatgpt_hotkey.py --clipboard-max-side 1920
Use --no-submit if you want to review the ChatGPT input before sending.
Use --copy-only if ChatGPT targeting fails and you want manual paste.
After installing dependencies, you can create a desktop shortcut:
powershell -ExecutionPolicy Bypass -File launcher\install_windows_shortcut.ps1
The shortcut launches pythonw scripts\chatgpt_hotkey.py --ui without opening a
terminal. Launcher logs are written under:
%USERPROFILE%\Creative Companion Launchers\
If your Python install is unusual, pass the pythonw.exe path explicitly:
powershell -ExecutionPolicy Bypass -File launcher\install_windows_shortcut.ps1 -Pythonw "C:\Path\To\pythonw.exe"
The test suite covers parser defaults and command construction. It does not exercise live Windows UI Automation.
python -m unittest discover
Screenshots can contain sensitive information. This tool saves captures locally
under data/captures/ and pastes them into your ChatGPT desktop app. Review
what is visible on screen before using the hotkey.
data/ and runs/ are ignored by git.
Early release. It works in the author's Windows workflow, but ChatGPT desktop UI changes can break targeting or auto-send behavior. See KNOWN_LIMITATIONS.md.