Skip to content

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.

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 first row names the columns, in any order. One row is a deadline, an outstanding amount or a recurring amount.

RowColumnsBecomes
a deadlinething, check, due; warn_days, crit_days, summarya 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 dutythe same, with every = month, quarter or yearthe occurrence that is open
an invoice or a billa deadline with amount, currency, side (revenue: owed to you; cost: owed by you)the same state, outstanding
a recurring amountthing, amount, currency, per; side, since, untila declared price: rent, a retainer, a depreciation that ends
a step of a plancheck, after, offseta deadline whose date is worked out; see plans
on any rowname, kind, part_ofdescribes 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.

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 month
taxes;;;;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-041
miller;Miller Ltd;client;;invoice-2026-038;22.10.2026;;;0;2400.00;USD;revenue;;;;Invoice 2026-038
office;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.

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 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.

Terminal window
./nota probe -check probe.json

validates the configuration.

Terminal window
./nota probe -once probe.json

runs everything once and prints what it would report.