suntheme 0.1.4

Switch Ghostty and Neovim themes based on sunrise/sunset times
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# suntheme
<img width="642" height="230" alt="image" src="https://github.com/user-attachments/assets/9cc57ce1-3795-4ec5-a463-0f9640c09b10" />

Automatically switch Ghostty and Neovim themes based on sunrise/sunset times.

## Installation

### Homebrew (macOS)
```bash
brew install lucianlavric/tap/suntheme
```

### Cargo (cross-platform)
```bash
cargo install suntheme
```

> **Linux users**: Ensure `~/.cargo/bin` is in your PATH. Add this to your `~/.bashrc` or `~/.zshrc`:
> ```bash
> export PATH="$HOME/.cargo/bin:$PATH"
> ```

### Pre-built binaries
Download from [GitHub Releases](https://github.com/lucianlavric/suntheme/releases).

## Quick Start

```bash
# Initial setup - configures location and themes
suntheme init

# Start automatic theme switching daemon
suntheme start
```

## Commands

| Command | Description |
|---------|-------------|
| `suntheme init` | Interactive setup for location and themes |
| `suntheme start` | Start daemon for automatic switching |
| `suntheme stop` | Stop the daemon |
| `suntheme status` | Show daemon status and current theme |
| `suntheme toggle` | Toggle between light/dark |
| `suntheme set <light\|dark>` | Set specific mode |
| `suntheme sun` | Display today's sunrise/sunset times |
| `suntheme themes` | Change theme configuration |

## How it works

1. **Location-based sun times**: Fetches sunrise/sunset times from [sunrise-sunset.org](https://sunrise-sunset.org) API based on your location
2. **Daily caching**: Sun times are cached daily to minimize API calls
3. **Ghostty**: Modifies your Ghostty config file and triggers a reload
4. **Neovim**: Writes to a state file that Neovim watches for changes

## Requirements

- **macOS**: Accessibility permissions required for Ghostty auto-reload (prompted during setup)
- **Neovim 0.9+**: For file watching support
- **Ghostty**: Any recent version

## Configuration

Config is stored at:
- macOS: `~/Library/Application Support/suntheme/config.toml`
- Linux: `~/.config/suntheme/config.toml`

```toml
[location]
latitude = 43.6532
longitude = -79.3832

[themes.ghostty]
light = "tokyonight-day"
dark = "tokyonight"

[themes.neovim]
light = "tokyonight-day"
dark = "tokyonight"
```

## Roadmap

- Windows support
- Linux support
- iTerm2 support
- VS Code support
- System theme support
- Gradient transition between light and dark themes to mimic sunrise/sunset

## License

MIT