Home
Unspool is a native macOS application for finding and downloading attachments from Telegram chats while preserving the filenames Telegram supplied. It uses SwiftUI, Swift 6 strict concurrency, and the official TDLib client library.
| Goal | Guide |
|---|---|
| Connect Telegram and choose a folder | Getting Started |
| Understand the product | Feature Overview |
| Find a specific file | Search, Filters, Sorting, and Selection |
| Preserve filename provenance | Attachments, Formats, and Filenames |
| Download safely | Download Workflow |
| Resolve file conflicts | Conflicts, File Safety, and Recovery |
| Diagnose a problem | Troubleshooting |
- The selected chat is the active browse boundary.
- Telegram's original filename is authoritative when it exists.
- Existing files are skipped by default; replace and copy naming require an explicit choice during preflight.
- Downloads go only to a user-selected security-scoped folder.
The repository screenshots use isolated synthetic preview fixtures. The capture path does not open a personal Telegram session.
Unspool is source-only. There is no signed, notarized, or App Store release. Real Telegram accounts, long histories, network interruption, disk pressure, and macOS accessibility settings remain manual release gates.
Unspool is independent software and is not affiliated with, maintained by, or endorsed by Telegram.