START HERE

CheekPouch 사용 안내

CheekPouch는 beancount 파일을 원본으로 쓰는 로컬 우선 개인 금융 도구입니다. 서버 계정 없이 내 컴퓨터의 원장을 직접 다룹니다.

01

설치와 첫 실행

  1. Windows 설치본을 실행합니다.

    현재 alpha는 제한 배포 중이므로 전달받은 설치본을 사용합니다.

  2. 원장 폴더를 고릅니다.

    기존 .beancount 폴더를 열거나 빈 폴더에 기본 계정 체계를 만들 수 있습니다.

  3. 원장 문서에서 기록을 시작합니다.

    하단 입력행에 내용, 카테고리, 결제수단, 금액을 넣습니다.

alpha 버전

기능과 파일 형식이 바뀔 수 있습니다. 중요한 원장은 별도 백업을 유지하세요.

02

원장 시작하기

원장 파일은 표준 beancount 텍스트입니다. 앱에서 기록한 거래는 다른 beancount 도구에서도 읽을 수 있고, CheekPouch를 닫아도 파일은 선택한 폴더에 그대로 남습니다.

원장
월별 거래를 보고 빠르게 추가하거나 기존 거래를 수정합니다.
자산
자산과 부채 계정을 계층으로 보고 계좌·카드를 추가합니다.
질의와 보드
기간과 조건으로 원장을 묶어 보고, 자주 보는 결과를 고정합니다.
03

업데이트

Windows 설치본은 private GitHub Release에서 새 버전을 확인합니다. 설정의 업데이트에서 전달받은 read-only token을 한 번 저장하세요.

  1. 업데이트 확인으로 새 버전을 조회합니다.
  2. 다운로드를 눌러 설치 파일을 준비합니다.
  3. 지금 설치를 누르면 앱을 종료하고 갱신합니다.

새 버전이 있으면 왼쪽 하단에 업데이트 있음이 나타납니다. 확인만으로 다운로드하거나 설치하지는 않습니다.

04

데이터와 보안

  • 원장 원본은 선택한 로컬 폴더의 평문 beancount 파일입니다.
  • 백업과 동기화 경계를 나갈 때만 암호화합니다.
  • 업데이트 token은 OS 보호 저장소에 보관하며 화면에 다시 표시하지 않습니다.
  • token은 대상 private repository 하나의 Contents 읽기 권한만 사용합니다.
05

문제 해결

업데이트를 확인하지 못합니다.

네트워크 연결과 token의 만료 여부, repository Contents 읽기 권한을 확인한 뒤 같은 자리에서 다시 시도하세요.

원장 일부가 보이지 않습니다.

설정의 진단에서 읽은 파일과 파싱 오류를 확인하세요. 원본 파일은 자동으로 삭제하거나 덮어쓰지 않습니다.

macOS나 Linux에서도 업데이트할 수 있나요?

현재 자동 업데이트 설치는 Windows x64 설치본만 지원합니다.