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.

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

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

License

See LICENSE file for details.