Skip to content

Quick start

1. Launch the TUI

rainlog

This opens the interactive TUI. On first run the database is created at ~/.local/share/rainlog/rainlog.sqlite.

2. Add your first record

Press n to open the Add Rain form. The date defaults to today. Enter the amount in millimetres and press Ctrl+S to save.

3. Navigate

Key Action
/ Scroll history back / forward
g Cycle grouping (daily → weekly → monthly → yearly)
m Toggle chart mode (rainfall ↔ soil-moisture index)
q Quit

See the full key bindings reference.

4. Use a different database directory

rainlog --db-dir ~/weather-data

The database file is always named rainlog.sqlite inside the given directory.

Next steps