solunatus 0.4.0

High-precision astronomical calculation library and CLI for sun/moon positions, rise/set times, and lunar phases
Documentation 
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
94
95
96
97
98
99
100

# Calendar Generation Guide

Generate astronomical calendars in HTML or JSON format.

## Basic Calendar Generation

```bash
solunatus --city "New York" --calendar \
  --calendar-start 2025-12-01 \
  --calendar-end 2025-12-31 \
  --calendar-format html \
  --calendar-output december.html
```

## Output Formats

### HTML Calendar

Interactive calendar for viewing in a web browser:

```bash
solunatus --city "Paris" --calendar \
  --calendar-start 2025-01-01 \
  --calendar-end 2025-01-31 \
  --calendar-format html \
  --calendar-output january.html

open january.html
```

**Features:**
- Beautiful table layout
- All daily events
- Lunar phase information
- Mobile responsive

### JSON Calendar

Machine-readable format for data processing:

```bash
solunatus --city "Tokyo" --calendar \
  --calendar-start 2025-06-01 \
  --calendar-end 2025-06-30 \
  --calendar-format json \
  --calendar-output june.json
```

## Date Ranges

Generate calendars for any date range:

```bash
# Single month
solunatus --city "London" --calendar \
  --calendar-start 2025-12-01 --calendar-end 2025-12-31

# Multiple months
solunatus --city "Sydney" --calendar \
  --calendar-start 2025-01-01 --calendar-end 2025-03-31

# Single day
solunatus --city "Boston" --calendar \
  --calendar-start 2025-07-04 --calendar-end 2025-07-04

# Full year
solunatus --city "Berlin" --calendar \
  --calendar-start 2025-01-01 --calendar-end 2025-12-31
```

## Interactive Calendar (Watch Mode)

```bash
solunatus --city "New York"
# Press 'g' to open calendar generator
```

## Contents of Generated Calendars

Each calendar includes:

- **Sunrise and Sunset** - Daily sun times
- **Twilight Times** - Civil, nautical, astronomical
- **Moonrise and Moonset** - Daily lunar times
- **Moon Phase** - Current phase and illumination
- **Lunar Events** - Full moons, new moons, quarters

## Practical Uses

- Plan outdoor photography sessions
- Schedule nighttime astronomy events
- Track lunar cycles
- Create printable astronomical references
- Export for astrophotography planning

## See Also

- **[CLI Reference](cli-reference.md)** - All options
- **[Features](README.md)** - Available data
- **[Interactive Mode](interactive-mode.md)** - Watch mode calendar