Douyin-to-Photos
Use this skill to implement a one-tap Apple Shortcuts flow for authorized Douyin video archiving into Photos.
Hard Rules
- Process only links the user is allowed to download and store.
- Request only required permissions: network + Photos add-only.
- Keep all temporary files in Shortcuts temp folder and delete after import.
- Never persist user links, tokens, or media metadata outside local shortcut runtime.
Workflow
- Accept input from Share Sheet (
URLor text) or clipboard fallback. - Normalize and validate Douyin URL (
douyin.comoriesdouyin.com). - Resolve playable MP4 via API provider chain:
- Primary:
https://www.tikwm.com/api/ - Fallback: user-defined gateway API (for example self-hosted parser)
- Download MP4 to temporary file.
- Save to Photos (optionally target user-selected album).
- Delete temporary file and report success/failure.
Included Resources
scripts/fetch_douyin_no_watermark.sh: provider-chain URL resolver with timeout and structured errors.references/shortcut-build-guide.md: action-by-action Shortcuts build instructions.assets/skill-manifest.json: market-ready manifest template with parameterized options.
Integration Notes
- Share Sheet: enable
URLsinput type. - Back Tap: configure a tiny launcher shortcut that reads clipboard and calls the main shortcut.
- Keep API base URL and album name configurable via shortcut dictionary values.
Validation
- Run URL resolver script with a test share link before wiring into Shortcuts.
- Test four scenarios: success, invalid link, API timeout, API quota/blocked.
- Confirm temporary media file is deleted in both success and failure paths.