Settings and Preferences

Settings and Preferences

Settings is one grouped canvas with Telegram, Browsing, Downloads, and Appearance sections. Operational controls write immediately to app preferences.

Telegram

Telegram Account

Shows whether the account is signed in on this Mac and the current connection presentation. Account Actions contains:

• Switch Account;
• Sign Out.

Telegram API

Shows the final two digits of the saved API ID and confirms Keychain storage. Edit validates and replaces the saved API credentials. The API hash field is never prefilled from Keychain into visible UI.

Browsing

History Range

Sets the default range used for chats that do not yet have saved per-chat browse state:

• Last 25 Messages
• Last 50 Messages
• Last 100 Messages
• Last 250 Messages
• Last 500 Messages
• All Messages

The default is Last 100. After a chat has its own stored range, switching back restores that chat-specific value.

Downloads

Destination Folder

Opens the macOS folder picker. The app verifies write access and saves a security-scoped bookmark.

Chat Subfolders

Default: on. When enabled, the destination layer creates a safe directory derived from the chat title and places the original filename inside it.

Skip Already Downloaded

Default: on. Uses local download history and Telegram file IDs to keep completed files out of ordinary selection. Download Again remains available.

Concurrent Downloads

Accepted values: 1–6. Default: 4. Values read from preferences are clamped to the supported range before use.

Increasing concurrency can improve throughput when Telegram and the disk are not the bottleneck, but it can also increase contention and does not bypass Telegram limits.

Reveal Completed Downloads

Default: off. When enabled, Finder reveals completed destination URLs after a batch. Failed, cancelled, and conflict-only batches do not trigger reveal.

Appearance

Appearance

• System — default; follows macOS.
• Light
• Dark

Accessibility

Motion, transparency, contrast, and VoiceOver are not duplicated as fake application toggles. Unspool follows the corresponding macOS environment settings.

Where preferences live

Global settings and per-chat browse state use macOS app preferences (UserDefaults). Per-chat state includes:

• history range;
• quick category;
• extension filter;
• minimum and maximum size input;
• start and end dates;
• sort order.

Filename search and “new since last scan” are intentionally reset on chat activation rather than persisted.

Related: Persistence and Local Data.