문제 해결
일반적인 1FileTool 문제의 해결법을 모았습니다: 설치 프로그램 경고, 실패한 실행, OCR과 모델 다운로드, 일일 한도, 라이선스 활성화, AI Chat 문제까지 증상별로 찾아볼 수 있습니다. 대부분은 스스로 해결됩니다.
대부분의 1FileTool 문제는 설치 프로그램, 차단된 첫 다운로드, 또는 Replace source가 말한 대로 정확히 하는 것으로 귀결됩니다 — 증상에 맞는 섹션을 따라가세요.
설치와 업데이트
Windows가 "Windows protected your PC"라고 합니다(SmartScreen). Windows 설치 프로그램이 아직 코드 서명되지 않아 SmartScreen이 첫 실행 시 표시합니다. More info → Run anyway를 선택하세요 — 다운로드는 공식 릴리스에서 왔습니다. (macOS 빌드는 서명되고 공증됩니다; 이 경고는 Windows 전용입니다.)
Linux에서 AppImage가 실행되지 않습니다. 실행 가능하게 만드세요(chmod +x). distro에 FUSE가 없으면 libfuse2/fuse를 설치하거나 --appimage-extract-and-run으로 실행하세요. Linux 빌드는 서명되지 않았습니다 — 패키지 관리자가 .deb에도 경고할 수 있습니다.
Windows나 Linux에 ARM 빌드가 없습니다. 앱은 Apple Silicon용 ARM 빌드만 제공합니다; x64 Windows와 Linux가 지원됩니다.
업데이트: 앱 메뉴(macOS) 또는 File 메뉴(Windows/Linux)의 **Check for Updates...**를 사용하세요. 앱은 6시간마다 GitHub Releases를 스스로 확인하기도 합니다; Settings › Updates에서 관리합니다.
도구 실행
먼저 원본을 보호하세요
Replace source는 기본적으로 켜져 있습니다. 결과가 원본 파일을 덮어쓰며 백업은 남지 않습니다. 따라 하기 전에 Settings › General을 열어 Replace source를 끄거나 별도의 출력 폴더를 지정하세요.
결과를 찾을 수 없습니다. 실행 후 결과 카드를 확인하고 History를 보세요 — 모든 실행이 기록됩니다. Replace source가 켜져 있었다면 출력은 원본 파일입니다(그 자리에서 덮어씀); 꺼져 있었다면 ~/Documents/1FileTool 또는 Change로 선택한 폴더를 보세요.
도구가 오류 메시지와 함께 실패했습니다. 결과 카드가 오류 텍스트를 보여 줍니다; 재시도 전에 복사하세요. 흔한 원인: 입력 형식이 그 도구에서 지원되지 않음(예: HEIC는 입력 전용 — HEIC로 변환할 수 없음), 손상된 원본 파일, 다른 앱이 파일을 잠금.
출력 파일이 원본보다 큽니다. 합법적으로 일어날 수 있습니다 — 일부 소스(이미 최적화된 파일, PNG로 재인코딩된 저품질 JPEG)는 줄어들 수 없습니다. 결과 카드는 항상 전/후 크기를 보여 주므로 숨겨지는 게 없습니다.
OCR 결과가 깨지거나 비었습니다. Tesseract.js는 영어 전용이며 검색 가능한 PDF가 아닌 .txt 파일을 씁니다; 필기와 저해상도 스캔은 잘 읽히지 않습니다.
AI 기능이 모델 다운로드를 요청했습니다. 정상입니다 — 음성(~63MB, Hugging Face)이나 Background Removal(~178MB, GitHub)의 첫 사용은 모델을 한 번 다운로드합니다. 멈추면 연결을 확인하고 재시도하세요; 다운로드 후에는 오프라인으로 작동합니다.
한도와 라이선스
"Daily limit reached — resets tomorrow". 무료 등급은 달력일 기준 하루 출력 파일 8개를 셉니다; 사이드바 카운터가 현재 위치를 보여 줍니다. Pro는 제한을 없앱니다 — Free vs Pro를 보세요.
라이선스 활성화 실패. Settings › License에 전체 키를 다시 붙여 넣고, 기기 한도(1/3/5) 내인지 확인한 뒤, 같은 탭에서 이전 기기를 비활성화하고 재시도하세요. 활성화는 Lemon Squeezy에 대한 네트워크 접근이 필요합니다.
AI Chat
AI Chat이 작동하지 않습니다. 직접 설치한 AI CLI(Claude Code, Gemini CLI, Codex 등)로 가는 브리지입니다 — CLI가 설치되어있고 로그인되어 있어야 하며, 모델 프로바이더는 읽는 것을 봅니다. 자동 설정은 Claude Code와 Gemini CLI를 커버합니다; 다른 CLI는 수동 설정이 필요합니다. 아무것도 응답하지 않으면 터미널을 열어 CLI가 단독으로 실행되는지 먼저 확인하세요.