Harmonia Vision

Leer en Español

Personalized editor settings for visual comfort

Harmonia Vision is a VS Code extension that helps you calibrate editor readability and reduce visual fatigue through ergonomic configuration recommendations. Whether you have myopia, astigmatism, or simply experience eye strain after long coding sessions, this tool provides personalized settings to improve your coding comfort.

Features

Visual Profile Assessment - Select conditions that affect your vision (myopia, astigmatism, eye strain, light sensitivity, etc.)
Optional Prescription Input - Enter your glasses prescription (Sphere/Cylinder) for more accurate recommendations
Smart Recommendations - Get personalized editor settings based on your visual profile
Live Preview - Compare original vs. recommended settings side-by-side before applying
Safe Apply Model - Preview changes temporarily, save when satisfied, or revert instantly
Theme Agnostic - Works with any VS Code theme
Bilingual Support - Available in English and Spanish (auto-detected)

Installation

Open VS Code
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Harmonia Vision"
Click Install

Or install from the command line:

code --install-extension AgusRdz.harmonia-vision

Usage

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
Type "Harmonia Vision: Open Calibrator"
Select your visual conditions
Optionally enter your prescription values
Click "Generate Recommendations"
Use the sliders to fine-tune settings
Preview changes in the side-by-side comparison
Click "Preview" to test in your editor
Click "Save" to apply permanently, or "Revert" to go back

Settings Adjusted

Harmonia Vision can adjust the following VS Code settings:

Setting	Description	Range
`editor.fontSize`	Font size in pixels	12-32px
`editor.lineHeight`	Line height ratio	Auto to 2.2x
`editor.letterSpacing`	Space between letters	0-1.5px
`editor.fontWeight`	Font weight	300-700
`editor.cursorWidth`	Cursor width in pixels	1-5px
`editor.renderLineHighlight`	Current line highlight	None, Gutter, Line, All

Understanding Prescription Values

Sphere (SPH)

The spherical power corrects nearsightedness (myopia) or farsightedness (hyperopia):

Negative values (-): Correct myopia (e.g., -2.00)
Positive values (+): Correct hyperopia (e.g., +1.50)

Cylinder (CYL)

The cylindrical power corrects astigmatism:

Only present if you have astigmatism
Can be negative or positive depending on notation used
Found on your glasses prescription

Note: These values are optional and only used to provide more accurate recommendations. They are never stored or transmitted.

Important Notice

This tool is designed to improve visual comfort while coding. It is NOT a substitute for professional eye care. If you experience persistent eye strain, headaches, or vision problems, please consult an optometrist or ophthalmologist.

Regular eye exams are essential for maintaining good eye health, especially for those who spend long hours in front of screens.

Visual Profile Options Explained

Each condition in the Visual Profile adjusts specific settings to address common visual challenges:

Myopia (Nearsightedness)

What it does:

Increases font size based on severity (16-22px range)
Widens cursor for easier tracking (3px)

Why: Larger text reduces the need to lean toward the screen and decreases ciliary muscle strain. If you provide your Sphere prescription value, the recommendation is calibrated more precisely.

Astigmatism

What it does:

Increases letter spacing (0.2-0.6px) to separate characters
Increases line height for better line tracking

Why: Astigmatism causes characters to blur together, especially similar shapes like c/e, r/n, 0/O. Added spacing reduces overlap and improves readability.

Eye Strain / Fatigue

What it does:

Adds +1px to font size
Ensures line height is at least 1.6x for "breathable" code

Why: Adequate spacing between lines reduces scanning effort during long coding sessions and helps your eyes rest between lines.

Blur / Ghosting

What it does:

Adds +1px to font size
May increase font weight to 500 (medium) for severe cases
Widens cursor (3px)

Why: Larger, slightly heavier text improves edge definition when you perceive double images or ghosting effects.

Light Sensitivity (Photophobia)

What it does:

Keeps font weight at 400 (normal), overriding heavier recommendations

Why: Heavier font weights appear brighter and can cause discomfort. Normal weight reduces perceived glare. For best results, pair with a dark theme.

Visual Crowding

What it does:

Increases letter spacing to at least 0.5px
Increases line height for better separation

Why: When dense code feels overwhelming or characters seem to "bunch up," added spacing creates visual breathing room.

Tip: You can select multiple conditions. The engine combines their effects intelligently (e.g., Photophobia will override heavier font weights even if Blur/Ghosting is also selected).

Preview

Privacy

No data is collected, transmitted, or logged
Prescription values are optional and only used locally
All settings are stored in your VS Code user settings
No telemetry or analytics

Requirements

VS Code 1.85.0 or higher

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests on GitHub.

License

MIT License - see LICENSE.txt for details.

Author

Created by AgusRdz

Enjoy coding comfortably!