Harmonia Zen
Active · v1.1.0
Why Harmonia Zen?
VS Code includes a built-in Zen Mode that hides UI elements for distraction-free coding. Harmonia Zen builds on this concept by giving you granular control over exactly what stays and what goes, paired with productivity tools to help structure your focus sessions.
What Harmonia Zen adds:
- Selective UI control - Choose exactly which 17 UI elements to show or hide, rather than an all-or-nothing approach
- Settings preservation - Your original settings are automatically saved and restored when toggling Zen Mode
- Preset profiles - Switch between different configurations instantly (Minimal, Writer, Focus, or your own custom presets)
- Integrated Pomodoro timer - Structure your work with timed focus sessions and breaks
- Focus statistics - Track your productivity with daily, weekly, and all-time metrics
- Visual feedback - See your progress with charts and streak tracking
Zen Mode Panel
A sleek control panel where you configure your distraction-free environment. Toggle individual UI elements on or off to create your perfect workspace.
Controllable elements:
- Editor: Line Numbers, Gutter, Minimap, Breadcrumbs, Indent Guides, Bracket Pairs, Rulers
- Scrollbars: Vertical and Horizontal
- Workbench: Activity Bar, Status Bar, Side Bar, Panel, Tabs
- Behavior: Cursor Blinking, Render Whitespace, Line Highlight
Preset Profiles
Quickly switch between different configurations:
| Preset | Description |
|---|---|
| Minimal | Hide everything for maximum focus |
| Writer | Clean view with cursor and scrollbar |
| Focus | Keep code aids, hide distractions |
| Custom | Save your own configurations |
Pomodoro Timer
Structure your work with the Pomodoro Technique:
- Work sessions (default 25 minutes)
- Short breaks (default 5 minutes)
- Long breaks (default 15 minutes, after 4 sessions)
- Customizable durations
- Auto-start option for continuous flow
- Session counter to track completed pomodoros
- Status bar integration for quick access
Focus Statistics
Track your productivity journey with detailed statistics:
- Today’s progress - Sessions and focus time
- Streak tracking - Current and longest streaks
- Weekly overview - Visual bar charts of your last 7 days
- All-time totals - Cumulative statistics
- Data stored locally (no cloud, no telemetry)
Keyboard Shortcuts
| Action | Mac | Windows/Linux |
|---|---|---|
| Toggle Zen Mode | Cmd+Alt+Z | Ctrl+Alt+Z |
| Open Panel | Cmd+Alt+Shift+Z | Ctrl+Alt+Shift+Z |
| Toggle Timer | Cmd+Alt+P | Ctrl+Alt+P |
| Stop Timer | Cmd+Alt+S | Ctrl+Alt+S |
| Skip Session | Cmd+Alt+N | Ctrl+Alt+N |
Privacy First
- No data collection or telemetry
- No analytics or external communication
- All settings and statistics stored locally
- Open source (MIT license)
Languages
Harmonia Zen supports:
- English (default)
- Spanish
The language is automatically detected from your VS Code settings.
Installation
- Open Extensions in VS Code (
Cmd+Shift+X/Ctrl+Shift+X) - Search for “Harmonia Zen”
- Click Install
- Open the Zen Mode Panel:
Cmd+Alt+Shift+Z(Mac) orCtrl+Alt+Shift+Z(Windows/Linux)
Get Harmonia Zen
Demo
The Story Behind It
Curious about why I built this? Read the full story: Coding in Peace - The Story Behind Harmonia Zen