Panduan Instalasi & Flashing KuyFox

Dokumen ini menjelaskan cara memasang dan menjalankan KuyFox pada perangkat Android melalui Custom Recovery (OrangeFox, TWRP, atau PBRP).

📋 Persyaratan Perangkat

Sebelum memulai, pastikan perangkat Anda memenuhi kriteria berikut:

1. Sudah Terpasang Custom Recovery:
   • OrangeFox Recovery (Sangat Direkomendasikan)
   • TWRP (Team Win Recovery Project)
   • PitchBlack Recovery (PBRP)
2. Partisi /data Terdekripsi:
   • Jika HP Anda menggunakan PIN/Pola/Password, masukkan kode tersebut saat pertama kali masuk ke recovery agar partisi data terbuka (decrypted).
3. Penyimpanan Internal / USB OTG:
   • Ruang penyimpanan kosong minimal 100 MB untuk database profil dan pencadangan.

⚡ Metode 1: Flashing Lewat File ZIP (Direkomendasikan)

Metode ini adalah cara paling cepat, bersih, dan otomatis. Script installer di dalam ZIP akan mengatur seluruh perizinan sistem dan membuat jalan pintas perintah global secara otomatis.

Langkah-langkah:

1. Salin file KuyFox-v1.0.zip ke memori internal HP (/sdcard/) atau flashdisk USB OTG.
2. Masuk ke mode Recovery (matikan HP, lalu tahan tombol Power + Volume Atas / Bawah tergantung tipe HP Anda).
3. Masuk ke menu Install / Files di tampilan recovery.
4. Pilih file KuyFox-v1.0.zip.
5. Geser slider (Swipe to Flash) untuk memulai instalasi.
6. Proses instalasi akan:
   • Mengekstrak engine KuyFox ke /sdcard/KuyFox/.
   • Mengatur izin eksekusi (chmod 755).
   • Menyuntikkan alias auto-load ke terminal OrangeFox (/sdcard/Fox/fox.bashrc) sehingga shortcut kuyfox langsung aktif setiap kali terminal dibuka.
   • Menambahkan boot hook di /sdcard/Fox/init.d/99kuyfox untuk meregenerasi symlink /sbin/kuyfox otomatis saat recovery dinyalakan.
   • Membuat symlink dan binary wrapper di /system/bin/kuyfox (persisten di partisi ROM) dan /sdcard/.bashrc.
   • Mengaktifkan proteksi whitelist otomatis agar folder /sdcard/Fox dan /sdcard/KuyFox tidak terhapus saat pembersihan.
7. Setelah muncul pesan [SUCCESS] KuyFox Installation Finished!, Anda tidak perlu melakukan reboot, langsung lanjut ke tahap penggunaan.

🛠️ Metode 2: Ekstrak Folder Manual (Tanpa Flash)

Jika Anda tidak ingin melakukan flash file ZIP, Anda bisa menaruh folder KuyFox secara manual:

1. Ekstrak file zip di PC atau menggunakan file manager di HP.
2. Pastikan susunan folder berada tepat di:

   /sdcard/KuyFox/
   ├── core/
   ├── database/
   ├── config.cfg
   ├── backup_config.cfg
   └── kuyfox.sh
   

3. Buka Terminal di Recovery, lalu ketik:
   Terminal

   sh /sdcard/KuyFox/kuyfox.sh
   

🚀 Cara Menjalankan KuyFox di Recovery

Setelah terpasang, terdapat 2 cara praktis untuk menjalankan antarmuka KuyFox di terminal recovery:

🔹 Cara 1: Eksekusi Langsung (Paling Cepat — Tanpa Mount Partisi Apapun)

1. Buka menu Terminal di recovery:
   • OrangeFox: Garis tiga (Menu) -> Terminal
   • TWRP: Advanced -> Terminal
2. Ketik perintah berikut lalu tekan Enter:
   Terminal

   sh /sdcard/KuyFox/kuyfox.sh
   

   Metode ini langsung berjalan tanpa perlu repot mencentang mount partisi apapun. Saat opsi spoofing dijalankan, engine KuyFox otomatis me-mount partisi /system dan /vendor ke mode RW di latar belakang.

🔹 Cara 2: Memakai Shortcut Singkat kuyfox (Via Mount System)

1. Di menu utama Recovery (OrangeFox / TWRP), buka menu Mount lalu centang partisi System.
2. Buka menu Terminal, lalu cukup ketik:
   Terminal

   kuyfox
   

3. Tekan Enter. Binary wrapper permanen tersimpan di partisi ROM (/system/bin/kuyfox). Begitu partisi System dicentang, shortcut kuyfox langsung terbaca di $PATH.