FinchGram이 하는 모든 것

Telegram 공식 앱이 허용하는 방법으로 로그인하거나, 새 계정을 만듭니다.

• 전화번호

  내 번호를 입력한 다음, Telegram이 보내 주는 코드를 입력합니다.

• 2단계 인증 비밀번호

  계정에 설정되어 있으면, 코드 다음에 FinchGram이 물어봅니다.

• QR 코드

  휴대폰의 Telegram으로 코드를 스캔하며, 아무것도 입력하지 않습니다.

• 새 계정

  로그인 페이지에서 Telegram에 가입합니다.

• 2단계 인증

  설정에서 켜고, 비밀번호와 힌트, 복구 이메일을 바꾸거나, 끌 수 있습니다.

탭과 검색이 있는 Telegram 채팅 목록을 키보드에 맞춰 만들었습니다.

• 폴더

  내 Telegram 폴더, 각각 그 안의 채팅과 읽지 않은 수를 보여 줍니다.

• 고정한 채팅

  고정한 채팅은 목록 맨 위에 머뭅니다.

• 읽지 않은 수와 멘션

  채팅마다 읽지 않은 메시지 수가 표시되고, 누군가 나를 멘션하면 표시가 붙습니다.

• 저장된 메시지

  목록 맨 위에 고정된 항목으로, 한 번도 쓰지 않았어도 항상 있습니다.

• 탭으로 여는 채팅

  여러 채팅을 탭으로 열어 두고, 닫고, 탭에서 바로 음소거할 수 있습니다.

• 검색

  ⌘K

  보이는 이름으로 채팅을 찾으며, 저장된 메시지도 포함됩니다. Return을 누르면 열립니다.

• 채팅에서 검색

  ⌘F

  열린 채팅에서 입력한 단어가 들어 있는 메시지를 찾습니다.

• 채널과 봇

  내 채널만 모아 보는 화면과 내 봇만 모아 보는 화면이 있습니다.

• 입력 중

  상대가 입력 중인지 보이고, Telegram 앱에서처럼 상대도 내가 입력 중인 것을 봅니다.

메시지에 담길 수 있는 모든 것, 그리고 메시지로 할 수 있는 일을 모은 메뉴입니다.

• 서식

  굵게, 기울임, 코드, 링크가 보낸 그대로 표시됩니다.

• 링크 미리보기

  링크가 있는 메시지 아래에 페이지 미리보기 카드가 붙습니다.

• 답장과 전달

  메시지가 무엇에 답하는지, 전달된 메시지가 어디에서 왔는지 보여 줍니다.

• 채팅 속 미디어

  사진, 동영상, GIF, 스티커, 파일. 움직이는 스티커는 아직 정지 이미지로 표시됩니다.

• 메시지 메뉴

  오른쪽 클릭: 답장, 편집, 복사, 링크 복사, 전달, 신고, 삭제, 또는 여러 개 선택할 수 있습니다.

• 자동 삭제 미디어

  Telegram 공식 앱에서처럼 흐리게 표시되고 한 번만 열립니다.

• 어디로 가는지 알려 주는 링크

  표시된 글자가 실제 주소와 다른 링크는 열기 전에 사이트와 전체 주소를 보여 주며 물어봅니다.

사진과 동영상은 창 전체를 덮는 뷰어에서 열리고, 같은 앨범의 나머지도 함께 볼 수 있습니다.

• 앨범

  사진 양옆의 넓은 화살표로 앨범을 넘깁니다.

• 캡션

  긴 캡션도 사진 아래에 표시됩니다.

• mpv로 재생하는 동영상

  소스에서 빌드해 앱에 넣었으며, 가능한 경우 Mac의 하드웨어로 디코딩합니다.

• 음량

  ↑↓

  스피커에 마우스를 올리면 나오는 슬라이더, 화살표 키나 스크롤 휠로 조절하며, 다음 동영상에도 그대로 유지됩니다.

• 저장

  채팅에서 저장을 허용하면 사진이나 동영상을 다운로드 폴더에 저장합니다.

• 직접 지울 수 있는 캐시

  Telegram이 보내 준 사진, 동영상, 파일은 ~/Documents/FinchGram/media_cache에 있습니다. 지워도 되며, 지운 뒤 다시 보는 것은 다시 가져옵니다.

파일은 갖고 있는 그대로 보내고, 보내기 전에 카드로 확인합니다.

• 파일을 넣는 세 가지 방법

  ⌘V

  클립을 누르거나, 창에 파일을 끌어다 놓거나, 붙여 넣습니다.

• 보내기 카드

  캡션을 붙이고, 사진으로 보낼지 파일로 보낼지 고릅니다.

• 앨범

  사진과 동영상 최대 10개가 앨범 하나로 묶입니다.

• 자동 삭제 타이머

  개인 채팅에서는 사진이나 동영상에 자동 삭제를 설정할 수 있습니다.

• 소리 없이

  상대에게 소리가 나지 않게 보냅니다.

• Enter 키로 보내기

  ⏎

  Return으로 보내고, Shift나 Option과 함께 Return을 누르면 줄을 바꿉니다. 끄면 ⌘Return으로 보냅니다.

어느 채팅에서나 화면 일부를 캡처하고, 그려 넣고, 보냅니다.

• 단축키 하나

  ⌘⇧A

  단축키를 누르거나, 클립 옆의 가위를 클릭합니다.

• 내 단축키

  설정 → 일반 → 스크린샷에서 다른 단축키를 고릅니다.

• 창 하나 또는 선택 영역

  창을 클릭해 통째로 고르거나, 돋보기와 픽셀 단위 크기를 보며 영역을 끌어 지정합니다.

• 모든 디스플레이

  오버레이가 메뉴 막대를 포함해 모든 디스플레이를 덮습니다.

• 그려 넣기

  사각형, 타원, 화살표, 펜, 글자, 모자이크를 세 가지 굵기와 여섯 가지 색으로 그립니다.

• 실행 취소와 실행 복귀

  ⌘Z⌘⇧Z

  그려 넣은 것은 모두 되돌릴 수 있고, 다시 되살릴 수도 있습니다.

• 미세 조정

  ←→↑↓

  화살표 키로 선택 영역을 1포인트씩, Shift와 함께 누르면 10포인트씩 옮깁니다.

• 보내기, 복사, 저장

  ⏎⌘C⌘S

  Return을 누르면 보내기 카드에 들어갑니다. 복사하거나 다운로드 폴더에 저장할 수도 있습니다.

• 화면에서 비켜 줍니다

  스크린샷을 찍는 동안 FinchGram 창을 가릴 수 있습니다.

별도의 페이지로 된 WebDAV 클라이언트: 앱 안에서 둘러보는 내 NAS입니다.

• 내 서버

  NAS, 시드박스, PikPak, Alist 또는 OpenList, 그리고 vget serve로 공유한 폴더입니다.

  작동 방식

• 경로로 보는 폴더

  “Home NAS /Movies/2026”: 경로의 폴더 하나하나가 되돌아가는 한 단계입니다.

• 파일 또는 폴더 통째로

  원하는 파일을 체크하거나, 폴더를 통째로 고릅니다.

• 빠른 속도

  파일마다 8 MB 조각으로 최대 12개 연결을 써서 받고, 서버가 지원하면 HTTP/2를 씁니다.

• 멈춰도 이어서 받습니다

  멈춘 다운로드는 멈춘 곳부터 이어서 받습니다.

• 바쁜 서버를 기다립니다

  서버가 바쁘다고 응답하면 최대 5분까지 기다립니다.

• 바로 뷰어로

  사진과 동영상은 도착하면 미디어 뷰어에서 열립니다.

• 비밀번호는 암호화해 보관합니다

  FinchGram 자체 데이터베이스에 들어가며, 데이터베이스는 통째로 암호화되고 그 키는 내 로그인 키체인에 있습니다. 평문 파일에 두는 일은 절대 없습니다.

• 서버마다 폴더 하나

  다운로드한 파일은 ~/Documents/FinchGram/webdav 아래 서버마다 하나씩 있는 폴더에, 또는 직접 고른 폴더에 저장됩니다.

• 디스크의 남은 공간을 확인합니다

  디스크에 들어가지 않는 파일은 시작하기 전에 거부하고, 크기를 알 수 없는 파일은 디스크가 가득 차기 전에 멈춥니다.

• 읽기 전용

  서버의 파일을 업로드, 이름 변경, 삭제하지 않습니다.

• Telegram 계정 필요 없음

  다운로드 페이지는 로그인하기 전에도 열립니다.

• 완료 항목 지우기

  버튼 하나로 완료된 다운로드를 모두 대기열에서 지웁니다.

• 내 인증서

  키체인 접근에서 신뢰하도록 설정한 인증서는 자체 서명 인증서라도 받아들입니다.

• 느린 서버를 위한 기록

  downloads.log에 요청 하나하나를 기록해, 서버가 왜 느린지 알아낼 수 있습니다.

FinchGram은 MCP 서버입니다: Claude Desktop, Claude Code, Cursor 등의 앱이 허용을 받으면 FinchGram을 통해 내 Telegram을 다룰 수 있습니다.

• 켤 때까지 꺼져 있습니다

  설정 → AI 접근이 그 스위치입니다. 꺼져 있는 동안은 모든 어시스턴트를 거부합니다.

• 내가 고른 채팅

  비밀 채팅을 제외한 모든 채팅, 또는 직접 고른 채팅만.

• 쓸 수 있는 것

  내 이름으로 바로 보내기, 임시 저장만 남기고 내가 보내기, 또는 아무것도 안 쓰기.

• 앱마다 먼저 허락을 구합니다

  앱이 처음 연결할 때 FinchGram이 묻습니다. 그 답은 앱이 업데이트되어도 앱마다 유지됩니다.

• 도구 12개

  채팅과 메시지를 나열하고 검색하고 읽기, 읽지 않은 것 확인, 미디어 가져오기, 임시 메시지 쓰기, 보내기, 내가 보낸 메시지 삭제, 읽음으로 표시.

  도구 목록

• 읽어도 표시되지 않습니다

  어시스턴트가 채팅을 읽어도 아무것도 읽음으로 표시되지 않습니다.

• 절대 내주지 않는 것

  비밀 채팅, 자동 삭제 미디어, 그리고 저장을 금지한 채팅의 미디어입니다.

• 기록

  AI 접근 페이지에 어시스턴트마다 무엇을 요청했는지 표시됩니다.

• 계정에 묶여 있습니다

  다른 계정으로 로그인하면 모든 앱을 다시 허용해야 합니다.

• 붙여 넣기만 하면 됩니다

  Claude Code나 Claude Desktop에 FinchGram을 추가하는 설정 내용이 AI 접근 페이지에 있습니다.

• 자체 AI 없음

  FinchGram은 AI를 호출하지도, 무언가를 학습시키지도 않습니다. 어시스턴트는 내가 읽도록 허용한 것만 받습니다.

채팅이나 폴더를 오른쪽 클릭하면 열립니다.

• 음소거와 고정

  채팅을 음소거하거나 해제하고, 고정하거나 해제합니다.

• 폴더

  채팅을 내 폴더에 넣거나 빼며, 들어 있는 폴더에는 체크 표시가 있습니다.

• ID 복사

  채팅의 ID를 채팅 메뉴나 프로필 페이지에서 복사합니다.

• 차단, 신고, 나가기, 삭제

  사용자를 차단하거나 차단 해제하고, 채팅을 신고하고, 그룹이나 채널에서 나가고, 채팅을 삭제합니다.

• 폴더를 읽음으로 표시

  폴더 안의 모든 채팅을 한 번에 표시합니다.

• 폴더 정렬

  최신 메시지순, 이름순, 또는 읽지 않은 메시지순으로 정렬하며, 고정한 채팅은 맨 위에 둡니다.

알림, Dock, 메뉴 막대를 Mac 앱답게 씁니다.

• 알림

  새 메시지를 macOS 알림으로 받으며, 내용과 소리는 켜고 끌 수 있습니다.

• Dock 배지

  Dock 아이콘에 읽지 않은 메시지 수가 표시됩니다.

• 창을 닫을 때

  설정에서 고른 대로 FinchGram이 Dock에 남거나 종료됩니다.

• 메뉴 막대 아이콘

  메뉴 막대에서 창을 열거나 종료합니다. 기본으로 켜져 있습니다.

• 로그인 시 실행

  Mac에 로그인하면 FinchGram이 실행됩니다.

세 가지 모습, 각각 라이트와 다크가 있으며, 다시 시작하지 않고 바꿉니다.

• 워크벤치

  기본 테마: 탭이 있는 작업 창입니다. 글꼴은 IBM Plex Sans, 강조색은 남색입니다.

• 브로드시트

  신문처럼 읽히고 계정마다 강조색이 있습니다. 글꼴은 Source Sans 3입니다.

• 터미널

  대괄호로 묶은 명령이 있는 고정폭 글꼴 화면입니다. 글꼴은 JetBrains Mono, 처음에는 다크로 열립니다.

• 라이트와 다크

  라이트, 다크, 또는 시스템 설정을 따르며, 테마마다 선택이 따로 저장됩니다.

• 언제든지 바꿀 수 있습니다

  설정 → 화면 모드에서, 또는 보기 메뉴에서 바꿉니다.

인터페이스는 11개 언어로 제공됩니다. 메시지는 쓰인 그대로 표시됩니다.

• 11개 언어

  영어, 중국어 간체와 번체, 스페인어, 포르투갈어, 독일어, 프랑스어, 러시아어, 일본어, 한국어, 아랍어.

• Mac의 언어를 따릅니다

  또는 설정 → 언어에서 고른 언어를 따르며, 다시 시작하지 않고 바뀝니다.

• 글꼴 포함

  중국어, 일본어, 한국어, 아랍어 글꼴이 앱에 함께 들어 있습니다.

• README도

  프로젝트의 README도 같은 11개 언어로 되어 있습니다.

FinchGram의 메뉴와 창에서 쓰는 단축키입니다.

• 검색

  ⌘K

  앱 어디에서나 채팅을 찾습니다.

• 채팅에서 검색

  ⌘F

  열린 채팅에서 메시지를 찾습니다.

• 스크린샷

  ⌘⇧A

  화면을 고정하고 일부를 캡처합니다.

• 다운로드 페이지

  ⌘⌥L

  다운로드 페이지를 엽니다.

• 설정

  ⌘,

  설정을 엽니다.

• 보내기

  ⏎

  Enter 키로 보내기가 켜져 있을 때이며, 꺼져 있으면 ⌘Return입니다.

• 줄 바꿈

  ⇧⏎⌥⏎

  Return을 Shift나 Option과 함께 누릅니다.

• 파일 붙여 넣기

  ⌘V

  클립보드의 사진과 파일이 보내기 카드에 들어갑니다.

• 취소

  Esc

  보내기 카드나 스크린샷 오버레이를 닫습니다.

FinchGram은 스스로 최신 상태를 유지하며, 검증할 수 없는 것은 설치하지 않습니다.

• 스스로 업데이트합니다

  GitHub Releases에서: 하루에 한 번 임의의 시각에 확인하거나, 도움말 → 업데이트 확인에서 직접 확인합니다.

• 설치 전에 검증합니다

  모든 릴리스에는 SHA256SUMS와 그 Ed25519 서명이 함께 오며, 앱은 둘 다 확인합니다.

• Apple의 공증을 받았습니다

  Developer ID로 서명하고, 강화된 런타임을 켜고, Apple의 공증을 받았습니다: 다운로드한 앱이 여느 앱처럼 열립니다.

• 디스크에 암호화되어 저장됩니다

  FinchGram 자체 데이터베이스와 Telegram의 데이터베이스는 각각 통째로 암호화되고, 저마다 별도의 키가 내 로그인 키체인에 있습니다.

• 공개적으로 빌드합니다

  릴리스는 오직 GitHub Actions가 고정된 소스에서 빌드합니다.

• 매번 같은 방식으로 서명됩니다

  그래서 업데이트해도 macOS가 화면 기록 권한을 유지합니다.

• Telegram의 규칙을 지킵니다

  읽음 확인, 입력 중 표시, 온라인 상태는 Telegram 앱과 같이 동작하고, 채널은 스폰서 메시지를 표시합니다.

• 아무것도 수집하지 않습니다

  분석도, 충돌 보고도, FinchGram 서버도 없습니다.

  개인정보 보호

• 보안을 강화한 다운로드

  다운로드 폴더 밖에 놓이게 될 파일 이름은 거부하고, 다른 서버로 리디렉션될 때 비밀번호는 절대 따라가지 않습니다.

• 오픈 소스

  GPL-3.0, Rust와 Slint로 만들었으며, Telegram 공식 TDLib은 별도의 프로그램으로 실행됩니다.

  소스