Harmonia Vision
Active · v1.0.0
Why Harmonia Vision?
After years of wearing glasses for myopia and astigmatism, I realized that adjusting font size alone wasn’t enough. Different vision conditions affect how we perceive text in unique ways - letter spacing, line height, font weight, and cursor visibility all play a role.
Harmonia Vision was born from the same philosophy as Harmonia Theme: making long coding sessions sustainable for your eyes. But instead of colors, it focuses on typography and spacing - personalized to your specific visual needs.
What it solves
- Personalized calibration based on your actual vision conditions.
- Intelligent recommendations that consider multiple factors simultaneously.
- Safe experimentation with instant preview and one-click revert.
- No guesswork - input your prescription for precise adjustments.
It’s not about making text bigger - it’s about making it comfortable for your eyes.
Supported Vision Conditions
Harmonia Vision understands six common conditions that affect screen readability:
- Myopia (Nearsightedness) · increases font size and cursor width for easier focus.
- Astigmatism · adjusts letter spacing and line height to reduce blur.
- Eye Strain / Fatigue · ensures adequate spacing for “breathable” code.
- Blur / Ghosting · increases font size and weight for sharper edges.
- Light Sensitivity · optimizes font weight to reduce perceived brightness.
- Visual Crowding · adds spacing to prevent text from feeling overwhelming.
Select one or multiple conditions - the engine intelligently combines their effects.
Optional Prescription Input
For more precise recommendations, you can enter your optical prescription values:
- Sphere (SPH): Corrects nearsightedness (-) or farsightedness (+).
- Cylinder (CYL): Corrects astigmatism severity.
These values are 100% local - never stored, never transmitted. Just used to calculate your ideal settings.
The Calibration Engine
Harmonia Vision uses an empirically calibrated recommendation system:
- Golden Standard: Based on real-world comfort profiles, not theoretical calculations.
- Comfort Threshold: Recommendations prioritize sustainable comfort, not minimal changes.
- Smart Floor: Your current settings act as a baseline - recommendations never decrease existing values.
- Intelligent Combination: Multiple conditions are combined thoughtfully, not just added together.
Font Size Thresholds (by Myopia Severity)
| Severity | Sphere | Minimum Font Size |
|---|---|---|
| Mild | ≥0.5D | 15px |
| Moderate | ≥1.0D | 16px |
| Significant | ≥1.5D | 18px |
| High | ≥3.0D | 20px |
| Very High | ≥5.0D | 22px |
Adjustable Settings
The extension can fine-tune these VS Code settings:
| Setting | Range | Purpose |
|---|---|---|
| Font Size | 12-32px | Primary comfort adjustment |
| Line Height | 1.4x-2.0x | Vertical spacing for line tracking |
| Letter Spacing | 0-1.5px | Horizontal character separation |
| Font Weight | 300-700 | Glyph definition and brightness |
| Cursor Width | 1-5px | Cursor visibility and tracking |
Safe Apply Workflow
Built-in snapshot and restore system for worry-free experimentation:
- Automatic Snapshot: First use captures your current settings as baseline.
- Live Preview: Test changes in real-time before committing.
- Save: Apply settings permanently and update your baseline.
- Revert: Restore original settings at any time.
Your settings and snapshots persist across VS Code restarts.
Privacy First
- No data collection or telemetry.
- No analytics or external communication.
- Prescription values used only locally.
- All settings stored in VS Code user settings.
- Open source (MIT license).
Installation
VS Code
- Open Extensions → search for “Harmonia Vision” (publisher: AgusRdz).
- Install and run command:
Harmonia Vision: Open Calibrator. - Select your vision conditions and optionally enter prescription values.
- Generate recommendations, preview, and save when satisfied.
Get Harmonia Vision
The Story Behind It
Curious about why I built this? 📝 Read the full story: From Glasses to Code - The Personal Journey Behind Harmonia Vision