A Masterpiece of Ergonomic Engineering by Ahmad Hassan (B-Ted)
🌐 Official Website • 📂 Key Features • 🚀 Quick Start
KodeArrow is a production-grade productivity suite designed to revolutionize keyboard ergonomics. It bridges the gap between hardware input and fluid navigation, enabling a seamless "Home Row" experience for power users.
"Navigation should be an extension of thought, not a physical strain." — Ahmad Hassan (B-Ted)
Navigation inefficiency is often ignored until it causes physical fatigue. KodeArrow was engineered to solve the "Hand Travel" problem. By transforming the home row into a dynamic navigation engine, it allows developers and researchers to maintain absolute focus without breaking their physical workflow. This project represents a shift from human-adapting-to-tools to tools-adapting-to-human-ergonomics.
KodeArrow provides a complete document control system without leaving the home row.
| Key | Mapping | Action |
|---|---|---|
| Alt + I/J/K/L | ⬆️ ⬅️ ⬇️ ➡️ | Core Directional Navigation |
| Alt + U / O | Home / End | Line Boundaries |
| Alt + P / ; | Del / Backspace | Instant Text Deletion |
| Alt + [ / ' | PgUp / PgDn | Document Paging |
| Home Row | Mapping | Icon |
|---|---|---|
| Alt + I | Arrow Up |  |
| Alt + J | Arrow Left |  |
| Alt + K | Arrow Down |  |
| Alt + L | Arrow Right |  |
Choose the edition that fits your professional workflow.
| Feature | Standard Edition | Research Edition |
|---|---|---|
| Full Ergonomic Suite | ✅ Active | ✅ Active |
| Cloud Sync | ✅ Active | ✅ Active |
| Telemetry Tracking | ❌ None | ✅ Real-time |
| Multi-Device Support | Up to 4 | 1 Dedicated |
| Research Participation | ❌ No | ✅ Yes |
Tip
To support developers, students, and ergonomic enthusiasts worldwide, we have created an open Universal Activation Email that unlocks the complete premium suite of KodeArrow forever!
| 📧 Community Key | freeforever@kodearrow.dev |
|---|---|
| Status | 🟢 Active & Lifetime |
| Allowed Devices | ♾️ Unlimited Connections |
| Ergonomic Research Contribution | 📊 Active (Anonymous Telemetry Tracking) |
- Zero Limits: Bypasses the standard 4-device hardware restriction entirely. Use it across all of your personal and work machines.
- Contribute to Science: By using this license, your app automatically registers device stats and anonymous telemetry to our database. You are directly contributing data to our ergonomic research and helping shape the future of human-computer interaction!
- Lifetime Freedom: Never expires. Managed centrally and kept active permanently through the cloud control console.
To Unlock: Simply enter
freeforever@kodearrow.devwhen prompted during the initial startup activation, and enjoy the ultimate home-row experience.
KodeArrow is a scientifically validated ergonomic pattern. Our research lab uses real-time metrics to optimize the navigation workflow.
Figure 1: 3D Visualization of user accuracy across the Alt+IJKL navigation field.
KodeArrow uses a standardized entry point system for both execution and distribution.
Launch specific editions using the --version flag:
- Standard Edition:
python main.py --version standard - Research Edition:
python main.py --version r_edition
The production build pipeline is fully automated. To generate a standalone .exe:
python infrastructure/build/build.pyGenerated binaries will be located in the dist/ directory.
Verify architectural and logical integrity before deployment:
python -m pytestNew people are welcomed to participate in development.
- Python 3.12 or higher
- Windows 10/11 (Preferred for Win32-hook stability)
- Clone & Enter:
git clone https://github.com/AhmadHassan-BTed/KodeArrow.git
- Environment Setup:
pip install -r config/requirements.txt
- Configuration:
- Duplicate
config/.env.exampleand rename it toconfig/.env. - Open
config/.envand fill in your Firebase credentials and License keys.
- Duplicate
- Execution:
python main.py --version standard
The project utilizes a high-performance local build engine to ensure consistent, secure binaries for end-users.
%%{init: {'flowchart': {'curve': 'stepBefore'}}}%%
graph LR
S[Source Code] --> B[infrastructure/build/build.py]
B --> A[Asset Bundling]
A --> P[PyInstaller Engine]
P --> EXE[dist/KodeArrow.exe]
style EXE fill:#f9f,stroke:#333,stroke-width:4px
Deployment: The official web presence is managed and deployed independently at ahmadhassan-bted.github.io/KodeArrow.
The system follows a Tiered Mono-Repo structure, ensuring zero coupling between the product core and research utilities.
%%{init: {'flowchart': {'curve': 'stepBefore'}}}%%
graph TD
Root[Project Root] --> Core[core/ - Product Engine]
Root --> Packages[packages/tools/ - Utilities]
Root --> Infra[infrastructure/ - Build & CI]
Root --> Assets[assets/ - Global Identity]
subgraph "Core Package Architecture"
Common[common/ - Shared Logic] --> Services[services/ - Firebase & Sub]
Common --> GUI[gui/ - CTk Windows]
Common --> Utils[utils/ - Encryption & Helpers]
Versions[versions/ - Editions] --> Standard[standard/ - App]
Versions --> REdition[r_edition/ - Telemetry]
end
How a single hotkey press travels through the layers of KodeArrow.
sequenceDiagram
participant U as User
participant H as Keyboard Hook (Low-Level)
participant V as Validation Layer
participant E as Execution Engine (PyAutoGUI)
participant C as Cloud Telemetry
U->>H: Press Alt + Hotkey Suite
H->>V: Capture Event & Suppress
V->>V: Check Hardware ID & License
alt Authorized
V->>E: Dispatch Virtual Key Signal
E->>U: OS-Level Action (Nav/Edit)
V->>C: Batch Research Data (R-Edition)
else Unauthorized
V->>U: Trigger CTk Padlock Window
end
Engineered by Ahmad Hassan (B-Ted) Redefining Human-Computer Interaction