Everything FinchGram does

Log in the ways Telegram's own apps allow, or make a new account.

• Phone number

  Your number, then the code Telegram sends you.

• Two-step password

  If your account has one, FinchGram asks for it after the code.

• QR code

  Scan the code with Telegram on your phone, without typing anything.

• New accounts

  Sign up for Telegram from the login page.

• Two-step verification

  Turn it on in Settings; change the password, its hint or the recovery email; or turn it off.

Telegram's chat list, with tabs and search, made for the keyboard.

• Folders

  Your Telegram folders, each with its chats and their unread counts.

• Pinned chats

  Pinned chats stay at the top of the list.

• Unread counts and mentions

  Each chat shows how much is unread, and a mark when someone mentions you.

• Saved Messages

  A fixed row at the top of the list, there even before you have used it.

• Chats in tabs

  Keep several chats open as tabs, close them, and mute a chat from its tab.

• Search

  ⌘K

  Find a chat by the name you see, Saved Messages included; Return opens it.

• Search in a chat

  ⌘F

  Find the messages in the open chat that contain your words.

• Channels and bots

  A view of your channels, and one of your bots.

• Typing

  See when someone is typing; they see you typing too, as in Telegram's apps.

Everything a message can carry, and a menu for what you can do with it.

• Formatting

  Bold, italic, code and links, shown as they were sent.

• Link previews

  A card with the page's preview under a message with a link.

• Replies and forwards

  What a message answers, and where a forwarded one came from.

• Media in the chat

  Photos, videos, GIFs, stickers and files; moving stickers show their still picture for now.

• The message menu

  A right click: reply, edit, copy, copy the link, forward, report, delete, or choose several.

• Self-destructing media

  Shown blurred and opened once, as in Telegram's own apps.

• Links that say where they go

  A link whose words are not its address asks before it opens, showing the site and the whole address.

Photos and videos open over the window, with the rest of their album.

• Albums

  Step through an album with the wide arrows on either side of the picture.

• Captions

  Long ones included, under the picture.

• Video through mpv

  Built from source into the app, decoding on the Mac's hardware where it can.

• Volume

  ↑↓

  A tray out of the speaker on hover, the arrow keys or the wheel; kept for the next video.

• Saving

  Save a photo or a video to Downloads, where the chat allows saving.

• A cache you can clear

  The photos, videos and files Telegram sent sit in ~/Documents/FinchGram/media_cache; clear it, and what you look at again is fetched again.

Files go in the way you have them, and a card shows them before they go.

• Three ways in

  ⌘V

  The paperclip, dragging files onto the window, or pasting them.

• The send card

  A caption, and the choice of sending as photos or as files.

• Albums

  Up to ten photos and videos go together as one album.

• Self-destruct timer

  In a private chat, a photo or video can be set to self-destruct.

• Without sound

  Send so that the other side gets no sound.

• Send with Enter

  ⏎

  Return sends and Shift or Option with Return starts a new line; turn it off to send with ⌘Return.

Take a piece of the screen, mark it up and send it, from every chat.

• One shortcut

  ⌘⇧A

  Press it, or click the scissors next to the paperclip.

• Your own shortcut

  Choose another in Settings → General → Screenshots.

• A window or a selection

  Click a window to take it whole, or drag a selection, with a magnifier and its size in pixels.

• Every display

  The overlay covers each display, the menu bar included.

• Mark it up

  Rectangles, ellipses, arrows, pen strokes, text and mosaic, in three sizes and six colors.

• Undo and redo

  ⌘Z⌘⇧Z

  Every mark can be taken back, and put back.

• Fine moves

  ←→↑↓

  The arrow keys move the selection by a point, or ten with Shift.

• Send, copy or save

  ⏎⌘C⌘S

  Return puts it into the send card; or copy it, or save it to Downloads.

• Out of the picture

  FinchGram's own window can hide while you take a screenshot.

A WebDAV client on a page of its own: your NAS, browsed in the app.

• Your servers

  A NAS, a seedbox, PikPak, Alist or OpenList, or a folder shared with vget serve.

  How it works

• Folders as a path

  “Home NAS /Movies/2026”: each folder of the path is a step back.

• Files or whole folders

  Tick the files you want, or take a folder with everything in it.

• Fast

  Each file in 8 MB pieces over up to twelve connections, on HTTP/2 where the server offers it.

• Goes on after a stop

  A stopped download picks up where it stopped.

• Patient with busy servers

  A server that says it is busy is waited for, up to five minutes.

• Straight to the viewer

  Photos and videos open in the media viewer as they arrive.

• Passwords encrypted

  In FinchGram's own database, encrypted as a whole with its key in your login keychain; never in a plain file.

• A folder per server

  Downloads land in ~/Documents/FinchGram/webdav, a folder for each server, or in the folder you choose.

• Room on the disk

  A file that does not fit is refused before it starts, and one of unknown size stops before the disk is full.

• Read-only

  Nothing on the server is uploaded, renamed or deleted.

• No Telegram account needed

  The Downloads page opens before you sign in.

• Clear finished

  One button takes every finished download off the queue.

• Your own certificates

  A certificate you trust in Keychain Access is accepted, a self-signed one included.

• A log for slow servers

  downloads.log records each request, to find out why a server is slow.

FinchGram is an MCP server: Claude Desktop, Claude Code, Cursor and other apps can work with your Telegram through it, once you let them.

• Off until you turn it on

  Settings → AI access is the switch; while it is off, every assistant is turned away.

• The chats you choose

  Every chat except secret chats, or only the ones you pick.

• What it may write

  Messages sent at once under your name, drafts for you to send, or nothing.

• Each app asks first

  The first time an app connects, FinchGram asks you; the answer is kept for that app, across its updates.

• Twelve tools

  List, search and read chats and messages, see what is unread, fetch media, write drafts, send, delete your own messages, mark as read.

  The tools

• Reading marks nothing

  An assistant can read a chat without marking anything as read.

• Never handed out

  Secret chats, self-destructing media, and the media of chats that forbid saving.

• A log

  The AI access page lists what each assistant asked for.

• Bound to your account

  When another account signs in, every app has to be allowed again.

• Ready to paste

  The lines that add FinchGram to Claude Code or Claude Desktop are on the AI access page.

• No AI of its own

  FinchGram calls no AI and trains nothing; an assistant gets only what you let it read.

A right click on a chat or on a folder.

• Mute and pin

  Mute or unmute a chat, pin or unpin it.

• Folders

  Put a chat into one of your folders or take it out; the folders it is in are ticked.

• Copy ID

  A chat's ID, from its menu or from the profile page.

• Block, report, leave, delete

  Block or unblock a person, report a chat, leave a group or channel, delete a chat.

• Mark a folder as read

  Every chat in the folder, at once.

• Sort a folder

  By the latest message, by name, or by unread messages, with pinned chats on top.

Notifications, the Dock and the menu bar, the way Mac apps do them.

• Notifications

  New messages as macOS notifications, with or without their words and sounds.

• Dock badge

  The number of unread messages on the Dock icon.

• Closing the window

  FinchGram stays in the Dock, or quits, as you choose in Settings.

• Menu bar icon

  Open the window or quit from the menu bar; on by default.

• Launch at login

  FinchGram starts when you log in to your Mac.

Three looks, each light and dark, switched without a restart.

• Workbench

  The default: a working window with tabs, in IBM Plex Sans with an indigo accent.

• Broadsheet

  Reads like a newspaper, with an accent color per account, in Source Sans 3.

• Terminal

  A monospace screen with commands in brackets, in JetBrains Mono; it starts dark.

• Light and dark

  Light, dark, or the system's; each theme keeps its own choice.

• Switch any time

  In Settings → Appearance, or from the View menu.

The interface in eleven languages. Messages stay as they were written.

• Eleven languages

  English, Simplified and Traditional Chinese, Spanish, Portuguese, German, French, Russian, Japanese, Korean and Arabic.

• Follows your Mac

  Or the language you pick in Settings → Language, switched without a restart.

• Fonts included

  The fonts for Chinese, Japanese, Korean and Arabic ship with the app.

• The README too

  The project's README is in the same eleven languages.

The shortcuts in FinchGram's menus and windows.

• Search

  ⌘K

  Find a chat, from anywhere in the app.

• Search in a chat

  ⌘F

  Find messages in the open chat.

• Screenshot

  ⌘⇧A

  Freeze the screen and take a piece of it.

• Downloads

  ⌘⌥L

  Open the Downloads page.

• Settings

  ⌘,

  Open Settings.

• Send

  ⏎

  With Send with Enter on; ⌘Return when it is off.

• New line

  ⇧⏎⌥⏎

  Shift or Option with Return.

• Paste files

  ⌘V

  Photos and files from the clipboard go into the send card.

• Cancel

  Esc

  Close the send card or the screenshot overlay.

FinchGram keeps itself up to date, and installs nothing it cannot verify.

• Updates itself

  From GitHub Releases: checked once a day at a random time, or from Help → Check for Updates.

• Verified before installing

  Every release comes with SHA256SUMS and its Ed25519 signature; the app checks both.

• Notarized by Apple

  Signed with a Developer ID, the hardened runtime on, and notarized: a downloaded copy opens like any other app.

• Encrypted on disk

  FinchGram's own database and Telegram's are each encrypted as a whole, with a key of its own in your login keychain.

• Built in the open

  Releases are built only by GitHub Actions, from pinned sources.

• Signed the same way every time

  So macOS keeps your Screen Recording permission across updates.

• Keeps to Telegram's rules

  Read receipts, typing and online status work as in Telegram's apps, and channels show their sponsored messages.

• Collects nothing

  No analytics, no crash reports, no FinchGram server.

  Privacy

• Hardened downloads

  File names that would land outside the download folder are refused, and passwords never follow a redirect to another server.

• Open source

  GPL-3.0, in Rust and Slint, with Telegram's own TDLib running as a separate program.

  Source