rainlog

A terminal-based rain logger. Record daily rainfall totals in a local SQLite database and explore history through an interactive TUI.

License: AGPL-3.0-or-later

Python: 3.11–3.14

Install

From the repository root (with uv recommended):

uv sync

Or install the package into your environment:

uv pip install .

The console entry point is rainlog.

Run the TUI:

rainlog

Key	Action
`n`	Add a rain record
`e`	Edit a record (use `s` to select a bar first in daily view)
`←` / `→`	Scroll history back / forward
`g`	Cycle grouping (daily / weekly / monthly / yearly)
`m`	Toggle chart mode (rainfall ↔ soil-moisture index)
`+` / `-`	More / fewer bars
`a`	Auto bar count
`q`	Quit

By default, data lives in rainlog.sqlite in ~/.local/share/rainlog/.
Use --db-dir to put the database in another directory (the filename stays rainlog.sqlite).
Each row stores the rain total in millimetres for a 24-hour block ending at 09:00 local time on the given calendar day.

Tests and automation are driven by Nox; list sessions with nox -l and run the ones you need (e.g. tests).

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

rainlog-1.1.0.tar.gz (15.3 kB view details)

Uploaded Jul 13, 2026 Source

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rainlog-1.1.0-py3-none-any.whl (16.5 kB view details)

Uploaded Jul 13, 2026 Python 3

Details for the file rainlog-1.1.0.tar.gz.

Download URL: rainlog-1.1.0.tar.gz
Upload date: Jul 13, 2026
Size: 15.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Details for the file rainlog-1.1.0-py3-none-any.whl.

Download URL: rainlog-1.1.0-py3-none-any.whl
Upload date: Jul 13, 2026
Size: 16.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Hashes for rainlog-1.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`2017a16d954b86c2f95bc3869a79ed5be90bfc090cfa8611730e4ba416e5cd2e`
MD5	`e665f4dc98d1b3082e2ddf3883d4f321`
BLAKE2b-256	`268c30ce5ae9afe0cbc2c0141df8e0a6bf0686b28d0d078cb33c03906ae81c19`