routinen-converter (1.0.0)

Published 2026-02-06 17:25:59 +01:00 by yunoadmin in public/project-routinen-core

Installation

pip install --index-url  routinen-converter

About this package

Convert org-tables to org-mode routine/habit/checklist files

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

Requirements

Requires Python: >=3.10
Details
PyPI
2026-02-06 17:25:59 +01:00
5
32 KiB
Assets (2)
Versions (1) View all
1.0.0 2026-02-06