Step 1 of 2
Open the vault manager
Open Obsidian’s vault switcher and choose Manage vaults…. Then choose Open folder as vault.
Take ToucanHomeHelp
Use Obsidian with Take Toucan
Open Take Toucan as a separate Obsidian vault for manual writing, linking drafts, and organizing ideas without moving your scripts.
What you’ll get
The Take Toucan folder becomes a dedicated Obsidian vault. Markdown notes saved there continue to sync to your iPhone.
Take Toucan does not require its own Mac app. You are connecting the Mac app you already write with to one iCloud folder.
On your Mac
Follow the screenshots
Keep this page open on your phone or another window while you complete each action on your Mac.
Step 2 of 2
Choose Take Toucan
In the folder picker, choose Take Toucan under iCloud Drive, then choose Open. The app may show the opened folder as Documents.
Final check
Can you see the Take Toucan files?
Your setup is complete when the writing tool can see:
- Demo — Present Over Perfect.md
- VOICE.md
- AGENTS.md
Nothing is copied or moved. Your Mac and iPhone are looking at the same files through iCloud.
Try it now
Start with one small action
These quick checks help the folder feel like a practical writing space, not a technical setup task.
Open the demo script
Open Demo — Present Over Perfect.md from the file list. You can read or edit it like any other Markdown file.
Write a new script
Create a new Markdown file in the opened folder and write the spoken script in the file body.
Start an ideas note
Create _ideas.md in the opened folder. The leading underscore keeps the note out of Take Toucan’s script list.
Need the app?
Install Obsidian and open it from Applications.
Download Obsidian for Mac ↗Reference
Advanced help
You should not need paths or troubleshooting for the normal setup. They are here if iCloud or a folder picker behaves unexpectedly.
Before you start
- Open Take Toucan on iPhone at least once so it can create the folder and starter files.
- Turn on iCloud Drive on the iPhone and Mac, and use the same Apple Account on both.
- Wait for iCloud to finish syncing. Finder may briefly show a cloud icon beside Take Toucan.
- Complete these steps in a Mac writing tool. Take Toucan itself does not require a Mac app.
The folder’s technical Mac path
Finder deliberately presents the app container as iCloud Drive › Take Toucan. Some writing tools expose its internal working folder name, Documents. They refer to the same iCloud-backed folder.
~/Library/Mobile Documents/iCloud~co~uk~designaway~TakeToucanV2/DocumentsUse the technical path only with Finder’s Go to Folder command (⌘⇧G) when the normal iCloud Drive picker is unavailable.
What Take Toucan puts in the folder
| File | Purpose |
|---|---|
| README.md | Human-readable intro to the workflow |
| Demo — Present Over Perfect.md | Example script to try recording |
| VOICE.md | Your editable voice and tone guide for AI |
| TAKE_TOUCAN_SCRIPT_RULES.md | App-managed script format rules |
| AGENTS.md | Instructions for Codex-style agents |
| CLAUDE.md | Imports rules for Claude Code |
| Your *.md files | Your scripts |
Troubleshooting and sync recovery
Folder doesn't appear in Finder
Confirm iCloud Drive is on, open Take Toucan on iPhone once, wait for sync, and check you're signed into the same Apple ID.
Take Toucan missing under iCloud Drive
Open the iPhone app once, confirm iCloud Drive is enabled for Take Toucan, and give Finder a moment to sync.
The writing tool calls the folder Documents
That is expected. Finder presents iCloud Drive › Take Toucan, while some folder pickers expose the app container's working folder as Documents. They are the same iCloud-backed folder.
Scripts don't show on iPhone
Confirm the file is .md (not .txt), not a reserved name (README.md, VOICE.md, _*.md, AGENTS.md), and pull to refresh on the dashboard.
AI created a file but the app doesn't see it
Files must be directly in the opened Take Toucan folder, not in a subfolder.
Edits not syncing
Check iCloud status and avoid editing the same file on two Macs before sync completes.
Normal sync sequence
- Save your .md file directly in the opened Take Toucan folder on Mac.
- Wait for iCloud to sync (usually seconds to a minute).
- Open Take Toucan on iPhone and pull to refresh on the dashboard.
- Your script appears. Tap it and record with the teleprompter.
Related guides
Still need help?
Send us a message from the support page.