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.
- 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
- Eye Break Reminders - Follow the 20-20-20 rule with customizable break reminders and status bar countdown
- Break Statistics - Track your eye health habits with local-only statistics (streaks, compliance rate, rest time)
- Theme Agnostic - Works with any VS Code theme
- Bilingual Support - Available in English and Spanish (auto-detected)
- 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- 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
Harmonia Vision can adjust the following VS Code editor 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 |
The 20-20-20 rule is a simple practice to reduce eye strain: every 20 minutes, look at something 20 feet (6 meters) away for 20 seconds.
Harmonia Vision includes built-in break reminders to help you follow this rule:
- Customizable Intervals - Set work intervals from 15-60 minutes
- Break Duration - Configure breaks from 10-60 seconds
- Status Bar Countdown - See time remaining until your next break
- Random Tips - Each reminder includes a helpful eye health tip
- Idle Detection - Timer pauses automatically when you're not actively coding
- Snooze Option - Delay a reminder by 5 minutes when needed
| Command | Description |
|---|---|
Harmonia Vision: Toggle Eye Break Reminders |
Enable or disable break reminders |
Harmonia Vision: Take Eye Break Now |
Trigger an immediate break |
Harmonia Vision: Snooze Eye Break |
Snooze current reminder for 5 minutes |
Configure in VS Code Settings or through the Calibrator panel:
| Setting | Description | Default |
|---|---|---|
harmoniaVision.pause.enabled |
Enable eye break reminders | false |
harmoniaVision.pause.workIntervalMinutes |
Minutes between breaks (15-60) | 20 |
harmoniaVision.pause.breakDurationSeconds |
Break duration in seconds (10-60) | 20 |
harmoniaVision.pause.showStatusBar |
Show countdown in status bar | true |
harmoniaVision.pause.pauseWhenIdle |
Pause timer when inactive | true |
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)
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.
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.
Each condition in the Visual Profile adjusts specific settings to address common visual challenges:
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.
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.
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.
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.
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.
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).
- 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
- VS Code 1.85.0 or higher
Contributions are welcome! Please feel free to submit issues or pull requests on GitHub.
MIT License - see LICENSE.txt for details.
Created by AgusRdz
Enjoy coding comfortably!