Txt2Task – Import a ASCII list of tasks into Apple Reminders

By Manny Fernandez

October 1, 2026

Txt2Task – Import a ASCII list of tasks into Apple Reminders

Executive summary. After Apple significantly upgraded Reminders, I finally made the jump from OmniFocus. What I did not want to give up was the frictionless workflow of drafting tasks in a plain text file with nested subtasks. To bridge that gap, I built Txt2Task, a lightweight AppleScript app that parses an indented .txt file and imports parent tasks and subtasks directly into any Apple Reminders list you choose.

Objective: Install Txt2Task, format a task file correctly, and import it into Reminders on the first try.

Target audience: Mac users moving from OmniFocus, Things, or Taskpaper-style text workflows who want to keep drafting in plain text.

Prerequisites

Component	Requirement
macOS	A current macOS release with the upgraded Reminders app (subtask support required)
Reminders list	The destination list must already exist before you run the import
Task file	A plain text `.txt` file (not RTF), one task per line
Permissions	Access to Reminders for Txt2Task (macOS prompts on first run)

Step-by-Step Installation

Step 1 | Download the app

Goal: Get the Txt2Task disk image onto your Mac.

Action: Click the button below. The download is a zipped .dmg file.

Step 2 | Unzip and mount the .dmg

Goal: Open the installer window.

Action: Double-click the downloaded .zip to extract it, then double-click the .dmg to mount it. If you prefer the terminal:

cd ~/Downloads
unzip Txt2Tasks.dmg_.zip
hdiutil attach Txt2Tasks.dmg

Txt2Task disk image window with the app and Applications folder shortcut

Step 3 | Install to Applications

Goal: Put the app where macOS expects it.

Action: Drag the Txt2Task app onto the Applications folder shortcut in the disk image window, then eject the disk image.

Dragging Txt2Task into the Applications folder

Step 4 | Grant Reminders access

Goal: Allow Txt2Task to create reminders.

Action: Launch Txt2Task from Applications. When macOS asks whether Txt2Task can access Reminders, click OK. If macOS also asks for Accessibility or Automation access, allow it as well.

GUI verification: Open System Settings > Privacy & Security > Reminders and confirm Txt2Task is listed and enabled.

Building the Task File

The parser is simple on purpose. Keep these rules in mind:

Each line is imported as one task in Reminders.
A line that starts with a tab or a space becomes a subtask of the nearest non-indented line above it.
Reminders supports one level of subtasks, so keep nesting one level deep.
Save the file as plain text. In TextEdit, use Format > Make Plain Text before saving.

Here is a sample file you can copy and use as a starting template:

Rebuild the home lab
	Back up the current firewall config
	Re-rack the switches
	Update firmware on all access points
Publish the Txt2Task blog post
	Capture the DMG screenshot
	Record the import GIF
	Proofread and schedule
Renew domain certificates

That file produces three parent tasks. The first has three subtasks, the second has three, and the last stands alone.

Example indented text file ready for import

Pre-flight check

Before importing, confirm your indentation is what you think it is. On macOS, cat -et shows every tab as ^I and every line ending as $, so stray spaces and blank lines stand out:

cat -et ~/Desktop/tasks.txt

Expected output for the sample file:

Rebuild the home lab$
^IBack up the current firewall config$
^IRe-rack the switches$
^IUpdate firmware on all access points$
Publish the Txt2Task blog post$
^ICapture the DMG screenshot$
^IRecord the import GIF$
^IProofread and schedule$
Renew domain certificates$

You can also count what should land in Reminders. The first command counts parent tasks, the second counts subtasks:

grep -cE '^[^[:space:]]' ~/Desktop/tasks.txt
grep -cE '^[[:space:]]+[^[:space:]]' ~/Desktop/tasks.txt

Running the Import

Launch Txt2Task.
Select your source .txt file when prompted.
Choose the Reminders list to import into.
Take your hands off the keyboard and mouse and let it run.

Important: Do not touch the keyboard or switch apps while the import is running. Txt2Task drives Reminders directly, and any input during the run can end up in the wrong place or break the subtask structure.

Txt2Task prompting for a source file and a destination list, then importing tasks

Verification

Open the destination list in Reminders. Each parent task should show a disclosure arrow with its subtasks underneath.
Compare the number of parent tasks and subtasks to the grep counts from the pre-flight check.
Because Reminders syncs through iCloud, the tasks should appear on your iPhone and iPad shortly after.

Troubleshooting and Gotchas

macOS will not open the app

Apps downloaded from the web can be held by Gatekeeper on first launch. Try to open Txt2Task once, then go to System Settings > Privacy & Security, scroll to the Security section, and click Open Anyway next to the Txt2Task message.

Nothing imports, or it stops partway

This is almost always a permission that was denied on the first prompt. Check System Settings > Privacy & Security under Reminders, Automation, and Accessibility, and enable Txt2Task wherever it appears. If you denied a prompt and it never comes back, reset the permission and relaunch the app. Note that these commands reset the permission for every app, not just Txt2Task:

tccutil reset Reminders
tccutil reset AppleEvents
tccutil reset Accessibility

Subtasks land as top-level tasks (or the reverse)

Run the cat -et pre-flight check. A parent line with an invisible leading space will be treated as a subtask, and an indented line copied from a rich text source may carry non-standard whitespace. Pick tabs, use them everywhere, and remove blank lines before running the import.

Random characters appear inside task names

Something received keyboard input during the run. Delete the imported tasks from the list, close other apps that might grab focus (chat apps and notification pop-ups are common culprits), turn on a Focus mode, and run the import again without touching anything.

Txt2Task – Import a ASCII list of tasks into Apple Reminders

Prerequisites

Step-by-Step Installation

Step 1 | Download the app

Step 2 | Unzip and mount the .dmg

Step 3 | Install to Applications

Step 4 | Grant Reminders access

Building the Task File

Pre-flight check

Running the Import

Verification

Troubleshooting and Gotchas

macOS will not open the app

Nothing imports, or it stops partway

Subtasks land as top-level tasks (or the reverse)

Random characters appear inside task names

Recent posts