Lists (CSV)
A list is for everything no system reports: a tax deadline, an invoice, rent. It is a CSV file kept by a person, in a spreadsheet or an editor. The probe reads it; nota init sets up two to start from.
Listing a file
Section titled “Listing a file”In probe.json:
"lists": [{ "name": "office", "path": "/etc/nota/office.csv" }]A list can also live at an address — a sheet published as CSV:
"lists": [{ "name": "office", "url": "https://…" }]https only, at most 2 MiB. The address is often the secret that protects the sheet, so it is never reported or logged.
The format
Section titled “The format”The first row names the columns, in any order. One row is a deadline, an outstanding amount or a recurring amount.
| Row | Columns | Becomes |
|---|---|---|
| a deadline | thing, check, due; warn_days, crit_days, summary | a state with a due date: ok, a warning from warn_days before it is due (default: on the day), critical crit_days after (default: never) |
| a recurring duty | the same, with every = month, quarter or year | the occurrence that is open |
| an invoice or a bill | a deadline with amount, currency, side (revenue: owed to you; cost: owed by you) | the same state, outstanding |
| a recurring amount | thing, amount, currency, per; side, since, until | a declared price: rent, a retainer, a depreciation that ends |
| a step of a plan | check, after, offset | a deadline whose date is worked out; see plans |
| on any row | name, kind, part_of | describes the thing, and what its money rolls up into |
A row without a thing continues the thing of the row above.
Dates are 2026-11-20 or 20.11.2026, amounts 1428.00 or 1.428,00, the separator ; or , — a spreadsheet’s export works as it is. German column names are understood as well; the German page shows them.
An example
Section titled “An example”thing;name;kind;part_of;check;due;every;done;warn_days;amount;currency;side;per;since;until;summary# Deadlines. "done" gets the date when it is done; a recurring one then moves on by itself.taxes;Taxes;area;;vat-return;10.11.2026;month;;5;;;;;;;VAT return for the previous monthtaxes;;;;income-tax;31.07.2027;year;;30;;;;;;;Income tax return# Invoices you sent (side revenue) and bills you owe. Outstanding until "done".brandt;Hofladen Brandt;client;;invoice-2026-041;20.11.2026;;;0;1.428,00;EUR;revenue;;;;Invoice 2026-041miller;Miller Ltd;client;;invoice-2026-038;22.10.2026;;;0;2400.00;USD;revenue;;;;Invoice 2026-038office;Office;area;;rent-december;03.12.2026;;;3;450,00;EUR;cost;;;;Rent for December# Recurring amounts: what something costs or brings, for as long as the row stands.brandt-retainer;Retainer Brandt;contract;brandt;;;;;;1.200,00;EUR;revenue;month;01.01.2026;;rent;Office rent;contract;office;;;;;;450,00;EUR;cost;month;01.01.2026;;laptop;Laptop, written off;asset;office;;;;;;66,64;EUR;cost;month;01.01.2025;01.01.2028;This is templates/list.csv.example from the source, shortened by one row.
Ticking off: done
Section titled “Ticking off: done”done gets a date when something is done.
- A deadline resolves.
- An outstanding amount is booked on that day, as cost or revenue.
- A recurring duty moves on to its next occurrence. The date settles the occurrence nearest to it, so two days early counts for the coming one.
- The steps after a plan’s step count from that day.
A row taken out of the file is taken back in the core.
A row that cannot be read
Section titled “A row that cannot be read”A row that makes no sense is skipped and named in Nota itself — with its line number and the reason — at the check rows of the list’s own thing, list:<name>. A typo in a date does not go unnoticed.
Try it without sending anything
Section titled “Try it without sending anything”./nota probe -check probe.jsonvalidates the configuration.
./nota probe -once probe.jsonruns everything once and prints what it would report.