todotxt2remind

todotxt2remind is a command-line tool that converts tasks from the todo.txt format into Remind calendar entries. It helps you integrate your plain-text task list with Remind for calendar-based reminders.

Features

Reads tasks from a todo.txt file or standard input
Outputs Remind-compatible entries to a file or standard output
Supports projects, contexts, priorities, due dates, and custom metadata
Optional debug output in JSON format

Installation

You need Go installed (version 1.18 or newer recommended).

Clone the repository and build:

git clone https://git.donadeo.net/pdonadeo/todotxt2remind.git
cd todotxt2remind
go build -o todotxt2remind

Usage

Basic usage:

./todotxt2remind -i todo.txt -o remind.txt

Read from stdin and write to stdout:

cat todo.txt | ./todotxt2remind

Show debug output (parsed tasks as JSON):

./todotxt2remind -i todo.txt --debug

Show version:

./todotxt2remind --version

Example

Given a todo.txt file:

(A) 2025-11-25 Call Mom +Family @phone due:2025-11-26
x 2025-11-24 2025-11-20 Submit report +Work due:2025-11-25

The output will be Remind entries for each task with a due date.

Contributing

Contributions are welcome! Please open issues or submit pull requests.

Fork the repository
Create your feature branch (git checkout -b feature/my-feature)
Commit your changes (git commit -am 'Add new feature')
Push to the branch (git push origin feature/my-feature)
Open a pull request

For questions or suggestions, feel free to open an issue.

License

See LICENSE file for details.

1.7 KiB Raw Blame History