https://github.com/i-no-one/keybinds-shortcut
Friendly keyboard shortcut manager ⌨️
https://github.com/i-no-one/keybinds-shortcut
keybinds shortcuts shortcuts-app
Last synced: 9 months ago
JSON representation
Friendly keyboard shortcut manager ⌨️
- Host: GitHub
- URL: https://github.com/i-no-one/keybinds-shortcut
- Owner: I-No-oNe
- License: mit
- Created: 2025-09-09T21:20:23.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-25T18:34:07.000Z (9 months ago)
- Last Synced: 2025-09-25T18:40:38.673Z (9 months ago)
- Topics: keybinds, shortcuts, shortcuts-app
- Language: Java
- Homepage: https://i-no-one.github.io/
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KeybindsShortcut ⌨
**KeybindsShortcut** is a lightweight, cross-platform Java app that lets you define **global keyboard shortcuts** to launch programs on **Windows, macOS, and Linux**.
---
## Quick Start 🚀
1. Download the latest `.jar` file
2. Create a `keybinds.json` config file
3. Run:
```sh
java -jar KeybindsShortcut.jar KeybindsShortcut
````
Optionally, specify a custom config path:
```sh
java -jar KeybindsShortcut.jar KeybindsShortcut PUT_YOUR_PATH_HERE.json
```
---
## Configuration ⚙️
Example `keybinds.json`:
```json
{
"keybinds": [
{
"keys": ["CTRL", "ALT", "F"],
"app": "firefox"
}
]
}
```
* Supports **letters A-Z**, **numbers 0-9**, **F1-F12**, and modifiers: `CTRL`, `ALT`, `SHIFT`, `WIN`, `ESC`.
* Apps can be **common names**, **full paths**, or **shell commands**.
* On Windows, it attempts to find the closest installed app match automatically.
---
## Troubleshooting 🛠️
* **Failed to register native hook:** Run as admin/root; verify Java; macOS needs Accessibility permission.
* **Failed to open app:** Check app name/path, installation, and permissions.
* **Failed to load keybinds:** Check JSON file exists, syntax, and permissions.
---
# Thanks for using and don't forget to star the repo 🙏