Let Your Screen
Follow the Sun

Automatic theme switching for your terminal based on sunrise and sunset. Because your eyes deserve to work with nature, not against it.

suntheme
$ suntheme start
 Daemon started successfully
 Location: Toronto, Canada
 Sunrise: 6:42 AM
 Sunset: 8:15 PM
 Current theme: light

Your Screen Should Adapt
To Your Environment

"Display luminance adaptation to ambient illumination levels can reduce visual fatigue symptoms by up to 51% during extended computer use." — Shih & Lin, 2016, Journal of the Society for Information Display
01

Circadian Rhythm

Light themes by day, dark by night — supporting your natural sleep cycle.

02

Reduced Strain

Matching screen to environment stops your pupils from constant adjustment.

03

Less Cognitive Load

Your brain spends less energy on visual processing, more on actual work.

04

Natural Transitions

Syncs with real sunrise and sunset times — smooth, not jarring.

Everything You Need,
Nothing You Don't

Location-Aware

Fetches accurate sunrise and sunset times based on your coordinates.

Background Daemon

Set it and forget it. Runs quietly, switching themes at the right moments.

Ghostty + Neovim

Native integration with Ghostty terminal and Neovim editor.

Easy Setup

Interactive wizard gets you running in under a minute.

Simple by Design

1

Configure Your Location

Run suntheme init to set your location. Enter a city name or coordinates — we'll handle the rest.

$ suntheme init
2

Choose Your Themes

Select your preferred light and dark themes for both Ghostty and Neovim. Use any themes you already have installed.

Light tokyonight-day
Dark tokyonight
3

Start the Daemon

Launch the background service and suntheme takes over. It calculates sun times daily and switches your themes automatically. Add it to your shell profile to start on every terminal session.

echo "suntheme start" >> ~/.zshrc

Enjoy Automatic Harmony

At sunrise, your terminal brightens. At sunset, it dims. Your workspace flows with the natural rhythm of the day.

Install in Seconds

Recommended

Homebrew

The easiest way to install on macOS

brew install lucianlavric/tap/suntheme

Cargo

Build from source with Rust

cargo install suntheme

From Source

Clone and build manually

git clone https://github.com/lucianlavric/suntheme && cd suntheme && cargo build --release

Quick Reference

suntheme init Interactive setup wizard
suntheme start Start the daemon
suntheme stop Stop the daemon
suntheme status View current status
suntheme toggle Toggle light/dark
suntheme sun Show sun times

Ready to Work With Nature?

Join developers who've found harmony between their screens and the sun.

Install Suntheme