Folio Helper

Mac App Store 버전의 Folio Writer가 Mac에 이미 설치된 도구로 컴파일할 수 있게 해 주는 작은 무료 동반 앱입니다. Apple의 샌드박스 때문에 앱이 직접 실행할 수 없는 도구들입니다.

버전 1.6.4 · 무료 · Apple 공증 완료 · macOS 13 이상. Mac App Store 버전에서만, 그리고 직접 설치한 도구를 쓸 때만 필요합니다.

1.6.4의 새 기능 — 더 빠르고 튼튼해진 도우미: 모든 도구를 한꺼번에 찾고 찾은 위치를 기억하므로, 콜드 스타트 시 가끔 “도구 없음”으로 표시되던 도구 패널이 1~2초 만에 채워집니다. 컴파일 ▸ 중단은 이제 최상위 프로세스뿐 아니라 렌더러가 시작한 모든 것(latexmk의 xelatex, Quarto의 pandoc과 Jupyter)을 멈춥니다. 그리고 일찍 종료되는 도구가 더 이상 컴파일 도중에 도우미까지 함께 끌어내리지 않습니다. 자동 업데이트가 켜져 있다면 이미 설치되어 있습니다.

이미 Folio Helper가 있나요? Folio Writer 1.8.6과 Folio Helper 1.6.3부터는 업데이트가 자동입니다. 앱이 하루에 한 번쯤 새 릴리스를 확인하고, 다운로드의 코드 서명을 검증하며, 실행 중인 도우미가 백그라운드에서 조용히 스스로를 교체합니다. 대화상자도, 클릭도, 승인할 것도 없습니다. 먼저 묻기를 원한다면 설정 ▸ 컴파일에서 끌 수 있으며, 수동 업데이트 버튼은 컴파일 ▸ 외부 도구 설정…에 있습니다.

Folio Writer 1.8.4 이하를 쓰고 있나요? 그 버전들은 Folio Helper 1.5와 짝을 이룹니다(해당 버전의 링크가 가리키는, 버전 번호 없는 FolioHelper.zip으로도 제공됩니다).

수동 업데이트도 가능합니다. Folio Writer를 종료하고(Folio Helper도 함께 종료됩니다), 응용 프로그램 폴더의 Folio Helper.app을 새 버전으로 교체한 뒤, Folio Writer를 다시 여세요.

무엇을 위한 것인가

App Store 버전은 Apple의 샌드박스 안에서 실행되며, 샌드박스는 Homebrew, MacTeX, TinyTeX로 직접 설치한 조판 도구를 포함해 외부 프로그램의 실행을 금지합니다. Folio Helper는 샌드박스 밖에 머물며 Folio Writer를 대신해 그 도구들을 실행하는 아주 작은 에이전트입니다: pandoc, pandoc-crossref, typst, xelatex / pdflatex / lualatex / latexmk, tectonic, quarto, 그리고 claude 명령줄. 이것을 설치하면 App Store 버전에서도 내 LaTeX로 PDF 컴파일, Quarto로 .qmd 프로젝트 렌더링, 글쓰기 도우미의 Claude CLI 모드가 모두 작동합니다.

아직 도구가 없나요? 터미널에서 명령 하나로 pandoc, pandoc-crossref, Quarto, Typst, LaTeX 엔진을 설치하세요(원하는 것을 고를 수 있는 메뉴가 표시됩니다).

curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash

설치 방법

쉬운 방법(Folio Writer 1.8.5 이상): 컴파일 ▸ 외부 도구 설정…을 열고 Folio Helper 설치를 클릭하세요. Folio Writer가 도우미를 내려받아 서명을 검증하고 응용 프로그램 폴더에 넣습니다. 응용 프로그램 폴더 접근을 한 번 승인하고 macOS의 공증 확인 창에 한 번 동의하면, 도우미와의 상호작용은 그것으로 끝입니다. 그 뒤로는 스스로 자동으로 최신 상태를 유지합니다.

수동으로:

위의 zip 파일을 내려받아 압축을 푸세요(Safari가 이미 풀어 두었을 수도 있습니다).
Folio Helper.app을 응용 프로그램 폴더로 드래그하세요.
한 번 실행하세요. 창은 없습니다. 백그라운드 도우미로 스스로를 등록하며, 시스템 설정 ▸ 일반 ▸ 로그인 항목에 “Folio Helper”로 표시됩니다.
Folio Writer에서 컴파일 ▸ 외부 도구 설정…을 열고 다시 검사를 누르세요. 도우미 카드에 찾은 모든 도구가 경로와 버전과 함께 나열됩니다.

하는 일과 하지 않는 일

위에 나열된 고정된 도구 목록만 실행합니다. 다른 것을 실행하도록 요청할 수 없습니다.
Folio Writer가 요청할 때만 실행합니다. 연결이 Folio Writer에서 온 것인지 코드 서명으로 검증합니다.
창도, 메뉴 막대 항목도, 자체 네트워크 접근도 없고, 아무것도 수집하지 않습니다. 일반적인 위치(Homebrew, MacTeX, TinyTeX, /usr/local)와 로그인 셸의 PATH에서 도구를 찾습니다.

제거하기

도우미를 종료하고(시스템 설정 ▸ 로그인 항목 ▸ “Folio Helper” 끄기), 응용 프로그램 폴더에서 Folio Helper.app을 삭제하세요. Folio Writer는 계속 작동하며, 컴파일은 샌드박스가 허용하는 범위로 돌아갈 뿐입니다.