
Umbra OLED

A true-black theme for Visual Studio Code, built for OLED screens and long sessions.
The pixels around your code stay off, and the code itself is in soft, warm colors
that don't glare.

Screenshots
These screenshots show this repository open in Umbra OLED.
Source Control and diff view. The changes for this release, before they were committed:

Theme picker. Preferences: Color Theme opened over the CI workflow:

Design rules
Each rule below is a hard limit, and CI fails the build if the theme breaks one.
- OLED: pure black surfaces. The editor, sidebars, activity bar, panels, tabs,
terminal, title bar and status bar are all
#000000, so those pixels are off.
Panels are separated by thin near-black borders instead of gray fills.
- No glare. No opaque color in the theme is brighter than 15:1 against black.
Pure white is 21:1. Body text is a warm off-white,
#c7c0b3, at about 11:1. That
is above WCAG AAA (7:1), without the halo white text gets on a black screen.
- Readable syntax. Every syntax color is at least 4.5:1 (WCAG AA). The palette
is muted, warm pastels with little blue light.
- Gentle on burn-in. Static chrome (status bar, activity bar, title bar, the
remote/WSL badge) uses dim foregrounds and no colored background strips.
Palette
| Role |
Color |
Contrast on black |
| Background |
#000000 |
n/a |
| Text |
#c7c0b3 |
11.3:1 |
| Comments |
#7d776d |
4.7:1 |
| Keywords |
#b69cc6 |
8.6:1 |
| Functions |
#8fa7c6 |
8.5:1 |
| Types / classes |
#d4bc82 |
11.3:1 |
| Strings |
#a5ba88 |
10.0:1 |
| Numbers / constants |
#d9a06e |
9.2:1 |
| Properties / builtins |
#88b5aa |
9.2:1 |
| Parameters |
#cdb99a |
11.0:1 |
Tags / this / errors |
#d68a80 |
7.8:1 |
| Accent |
#8a6c43 |
n/a |
Install
In VS Code, open the Extensions view (Ctrl+Shift+X), search for Umbra OLED, and
click Install. Or from a terminal:
code --install-extension IDCTpl.umbra-oled-theme
The listing is on the
Visual Studio Marketplace.
Each release also has the
.vsix attached, for installing a specific version or without the Marketplace:
code --install-extension umbra-oled-theme-<version>.vsix
Or build it from source:
git clone https://github.com/ideaconnect/vscode-umbra-oled.git
cd vscode-umbra-oled
npm run package # creates umbra-oled-theme-<version>.vsix
code --install-extension umbra-oled-theme-*.vsix
Every CI run also uploads the packaged .vsix as a build artifact.
Then pick the theme with Preferences: Color Theme (Ctrl+K Ctrl+T), or set it
in settings.json:
{
"workbench.colorTheme": "Umbra OLED",
// keeps the theme if "window.autoDetectColorScheme" is turned on
"workbench.preferredDarkColorTheme": "Umbra OLED"
}
Remote windows (WSL, SSH, Dev Containers)
A color theme is a UI extension, so it runs on your local machine. Install it
locally once, and it applies to remote windows as well. You don't need to install
it on the remote host.
Profiles
Extensions and settings are per profile. To use the theme in another profile,
install it there too:
code --install-extension IDCTpl.umbra-oled-theme --profile "My Profile"
Tips
- Smearing when scrolling? On some OLED panels, pixels that are fully off take
a moment to turn on, which leaves a faint trail behind moving text. If you notice
it, set
editor.background to #050505 through workbench.colorCustomizations.
You keep nearly all the power and burn-in benefit.
Validation
scripts/validate.mjs is a dependency-free Node script (Node 18+) that checks:
- Manifest: required fields, semver, theme contributions. On a tag build it
also checks that the tag matches the version (
0.1 matches 0.1.0).
- Theme structure: strict JSON with no duplicate keys, well-formed colors,
valid token rules (scopes, settings, font styles, and no scope styled twice),
and valid semantic token selectors.
- Color IDs: every key in
colors is a real VS Code color. This step needs a
VS Code install.
- Design rules: the OLED, glare and readability limits above.
npm run validate
# add color ID checks against a local VS Code install:
node scripts/validate.mjs --vscode-app "/path/to/VS Code/resources/app"
CI runs on every push, pull request and tag. It:
- downloads the latest stable VS Code and verifies its SHA-256, so the color IDs
are checked against the current release
- runs the validator
- packages the
.vsix with vsce
- scans the full git history for leaked secrets with
gitleaks
- on a version tag, publishes that exact
.vsix to the Marketplace once a
maintainer approves the marketplace environment
Publishing uses the Marketplace's
Trusted Publishing:
GitHub gives the job a short-lived identity token, so no Marketplace token is
stored in the repository or in GitHub secrets.
All third-party actions are pinned to commit SHAs.
Made in the EU
Umbra OLED is built in the European Union. The badge at the top comes from
ideaconnect/made-in-the-eu, a
shared badge that makes a project's European origin visible at a glance.
License
Copyright © 2026 IDCT (idct.tech).
Licensed under the European Union Public Licence v. 1.2 (EUPL-1.2), or
any later version approved by the European Commission. You may not use this work
except in compliance with the Licence. The official text in all EU languages is at
https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12.
Free software runs on coffee ☕
Umbra OLED is free and open source. If it makes your screen easier on the eyes,
you can help keep it going.
☕ One-off. Buy a coffee whenever the theme saves your eyes.
|
💖 Monthly. Support ongoing work through GitHub Sponsors.
|