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.
Usage
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 |
Data storage
- By default, data lives in
rainlog.sqlitein~/.local/share/rainlog/. - Use
--db-dirto put the database in another directory (the filename staysrainlog.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.
Development
Tests and automation are driven by Nox; list sessions with nox -l and run the ones you need (e.g. tests).
Links
- Documentation: rainlog.marvin8.zone
- Source: forge.marvin8.zone/marvin8/rainlog
- Issues: forge.marvin8.zone/marvin8/rainlog/issues
- Changelog: CHANGELOG.md
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rainlog-1.1.3.tar.gz.
File metadata
- Download URL: rainlog-1.1.3.tar.gz
- Upload date:
- Size: 15.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
034fd94b4fc8aa5afe729b8d62a4bff14569ace272fac6150b597086a45efffd
|
|
| MD5 |
e263a2178d8e53514cf97740ea7dc2d9
|
|
| BLAKE2b-256 |
7a6155f38a4365328599745ca5439645d5b2d94190425410660fe16e462a054a
|
File details
Details for the file rainlog-1.1.3-py3-none-any.whl.
File metadata
- Download URL: rainlog-1.1.3-py3-none-any.whl
- Upload date:
- Size: 16.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1904c132a92b26d8474a4edfcb6f73b5adab4995459ee9ff6fc644f458ebb39f
|
|
| MD5 |
54a7af0dc653e1be77a6b4e56a5dff5a
|
|
| BLAKE2b-256 |
c998c4b7752705d85cc26393a91a749cc0a27e37f4cca200e8cb5d04bbd1c8c8
|
