routinen-converter

Python tool to convert org-tables with routines, habits, and checklists into org-mode files.

Installation

# From Forgejo package registry
uv add routinen-converter --index-url https://forgejo.mayer.rocks/api/packages/public/pypi/simple

# Or from git
uv add git+https://forgejo.mayer.rocks/public/project-routinen-core.git

Usage

# Run in a directory with input/ folder containing .org files
routinen-convert

# Specify directories
routinen-convert --input path/to/input --output path/to/output

# Run from different working directory
routinen-convert --directory /path/to/project

Input Format

Place .org files in the input/ directory with tables like:

| Thema              | Kadenz | wo     | kontext | type      | checklist |
|--------------------+--------+--------+---------+-----------+-----------|
| Water plants       | W01    | home   | morning | routine   |           |
| Exercise           | T01    |        | morning | habit     |           |
| Pack sunscreen     |        | travel |         | checklist | vacation  |

Columns

• Thema: Task description
• Kadenz: Recurrence pattern (see below)
• wo: Location tag
• kontext: Context tag
• type: routine (default), habit, or checklist
• checklist: Checklist name (required when type=checklist)

Kadenz Patterns

Pattern	Meaning	Example
JAN, FEB, ...	Yearly on 1st of month	APR = April 1st, +1y
M01, M02, ...	Monthly on 1st	M01 = every month, M02 = every 2 months
W01, W02, ...	Weekly on Monday	W01 = every week, W02 = every 2 weeks
T01, T02, ...	Daily (for habits)	T01 = daily, T02 = every 2 days

Output

• output/routinen.org - Recurring TODO entries for routines
• output/habits.org - Org-mode habits with :STYLE: habit property
• output/checklist-{name}.org - One-time checklists

License

MIT