Pemecahan masalah
Perbaikan untuk masalah umum 1FileTool: peringatan installer, run gagal, OCR dan unduhan model, batas harian, aktivasi lisensi, dan AI Chat.
Kebanyakan masalah 1FileTool bermuara pada installer, unduhan pertama yang diblokir, atau Replace source yang bekerja persis seperti katanya — kerjakan bagian yang cocok dengan gejala Anda.
Menginstal dan mengupdate
Windows bilang "Windows protected your PC" (SmartScreen). Installer Windows belum di-code-sign, jadi SmartScreen menandainya saat peluncuran pertama. Pilih More info → Run anyway — unduhan berasal dari rilis resmi. (Build macOS ditandatangani dan dinotarisasi; peringatan ini khusus Windows.)
AppImage tidak mau meluncur di Linux. Jadikan executable (chmod +x), dan jika distro Anda tidak punya FUSE, instal libfuse2/fuse atau jalankan dengan --appimage-extract-and-run. Build Linux tidak ditandatangani — package manager mungkin memperingatkan pada .deb juga.
Tidak ada build ARM di Windows atau Linux. Aplikasi mengirim build ARM hanya untuk Apple Silicon; Windows dan Linux x64 didukung.
Update: gunakan Check for Updates... di menu aplikasi (macOS) atau menu File (Windows/Linux). Aplikasi juga memeriksa GitHub Releases sendiri setiap 6 jam; kelola di Settings › Updates.
Menjalankan tool
Lindungi file asli Anda dulu
Replace source aktif secara default: hasil menimpa file asli dan tidak ada cadangan yang disimpan. Sebelum mengikuti panduan, buka Settings › General dan nonaktifkan Replace source, atau pilih folder output terpisah.
Saya tidak menemukan hasilnya. Periksa kartu hasil setelah run, lalu History — setiap run tercatat. Jika Replace source nyala, output adalah file asli (ditimpa di tempat); jika mati, lihat di ~/Documents/1FileTool atau folder yang Anda pilih dengan Change.
Tool gagal dengan pesan error. Kartu hasil menampilkan teks error; salin sebelum mencoba ulang. Penyebab umum: format input tidak didukung tool itu (mis. HEIC hanya input — Anda tidak bisa mengonversi ke HEIC), file sumber korup, atau file dikunci aplikasi lain.
File output lebih besar dari aslinya. Itu terjadi secara sah — beberapa sumber (file yang sudah dioptimalkan, JPEG berkualitas rendah yang di-encode ulang jadi PNG) tidak bisa menyusut. Kartu hasil selalu menampilkan ukuran sebelum/sesudah sehingga tidak ada yang disembunyikan.
OCR keluar kacau atau kosong. Tesseract.js khusus bahasa Inggris dan menulis file .txt, bukan PDF yang bisa dicari; tulisan tangan dan pindaian resolusi rendah tidak akan terbaca baik.
Fitur AI minta mengunduh model. Wajar — pemakaian pertama suara (~63 MB dari Hugging Face) atau Background Removal (~178 MB dari GitHub) mengunduh model sekali. Jika macet, periksa koneksi dan coba lagi; setelah diunduh ia bekerja offline.
Batas dan lisensi
"Daily limit reached — resets tomorrow". Tier gratis menghitung 8 file output per hari kalender; penghitung sidebar menunjukkan posisi Anda. Pro menghapus batas — lihat Free vs Pro.
Aktivasi lisensi gagal. Tempel ulang kunci lengkap di Settings › License, pastikan Anda masih dalam batas perangkat (1/3/5), dan nonaktifkan perangkat lama dari tab yang sama sebelum mencoba ulang. Aktivasi butuh akses jaringan ke Lemon Squeezy.
AI Chat
AI Chat tidak bekerja. Ia adalah jembatan ke CLI AI yang Anda instal sendiri (Claude Code, Gemini CLI, Codex, dan kawan-kawan) — CLI harus terinstal dan sudah masuk, dan provider model melihat apa pun yang dibacanya. Auto-setup mencakup Claude Code dan Gemini CLI; CLI lain perlu setup manual. Jika tidak ada yang merespons, buka terminal dan periksa CLI berjalan mandiri dulu.