html-to-exe 1.0.0

Konversi HTML ke EXE berbasis Electron

HTML to EXE Converter

Aplikasi Konversi Proyek Web ke Desktop dengan Electron

---

📋 Daftar Isi

1. Deskripsi Proyek
2. Fitur Utama
3. Algoritma & Arsitektur
4. Persyaratan Sistem
5. Panduan Instalasi Lengkap
6. Cara Penggunaan
7. Troubleshooting
8. Kontribusi
9. Lisensi

---

📌 Deskripsi Proyek

Aplikasi HTML to EXE Converter memungkinkan pengguna mengubah proyek web (HTML, CSS, JavaScript) menjadi aplikasi desktop berbasis Electron yang dapat dijalankan di Windows, macOS, dan Linux.

🔹 Mengapa menggunakan aplikasi ini?
✔ Mudah digunakan dengan antarmuka GUI (Graphical User Interface)
✔ Mendukung berbagai konfigurasi window (ukuran, fullscreen, frameless, dll.)
✔ Preview langsung sebelum konversi
✔ Dapat menambahkan ikon aplikasi khusus

---

✨ Fitur Utama

✅ Konversi ke EXE

• Mendukung Windows (.exe), macOS (.app), Linux (binary)
• Opsi pengemasan dengan ASAR (enkripsi file sumber)

✅ Konfigurasi Window

• Ukuran (width, height, min/max dimensions)
• Mode Fullscreen & Kiosk
• Warna latar belakang dan transparansi
• Frame window (borders, title bar)

✅ Web Preferences

• Node.js Integration (akses filesystem dari JavaScript)
• Context Isolation (keamanan tambahan)
• WebGL & Sandbox Mode

✅ Preview Mode

• Server lokal untuk melihat hasil sebelum konversi
• Buka di browser atau Electron window

✅ Logging & Error Handling

• Output log detail selama proses konversi
• Pengecekan otomatis Node.js & Electron

---

⚙ Algoritma & Arsitektur

📂 Alur Kerja Utama

graph TD
    A[Start] --> B[Pilih Folder HTML]
    B --> C[Konfigurasi Aplikasi]
    C --> D[Generate main.js & package.json]
    D --> E[NPM Install Dependencies]
    E --> F[Electron-Packager Build]
    F --> G[Output EXE]
    G --> H[Selesai]

🔧 Proses Konversi

1. Input:

   • Folder HTML (index.html harus ada)
   • Nama aplikasi, output directory, ikon (opsional)

2. Generate Project Electron:

   • Buat package.json dengan konfigurasi dasar
   • Generate main.js berdasarkan pengaturan GUI

3. Proses Build:

   • Jalankan npm install untuk menginstal Electron
   • Gunakan electron-packager untuk membuat executable

4. Output:

   • File aplikasi siap pakai di folder dist/

---

🖥 Persyaratan Sistem

Komponen	Versi Minimal	Catatan
OS	Windows 10 / macOS 10.12+ / Linux (x64)	-
Python	3.6+	Untuk menjalankan GUI
Node.js	14.x+	Wajib untuk Electron
npm	6.x+	Package manager Node.js
RAM	2GB+	Lebih baik 4GB untuk build besar

---

📥 Panduan Instalasi Lengkap

1️⃣ Instal Python & PIP

• Download Python dari python.org
• Pastikan "Add Python to PATH" dicentang saat instalasi
• Verifikasi instalasi:

  python --version
  pip --version
  

2️⃣ Instal Node.js & npm

• Download dari nodejs.org (pilih LTS version)
• Verifikasi instalasi:

  node --version
  npm --version
  

3️⃣ Clone/Download Proyek

git clone https://github.com/username/html-to-exe-converter.git
cd html-to-exe-converter

4️⃣ Instal Dependencies Python

pip install tk pillow

5️⃣ Jalankan Aplikasi

python gui.py

Atau buat EXE untuk GUI ini sendiri:

pyinstaller --onefile --windowed --icon=icon.ico gui.py

---

🖱 Cara Penggunaan

1️⃣ Tab Settings

• HTML Folder: Pilih folder yang berisi index.html
• App Name: Nama aplikasi output
• Output Folder: Lokasi penyimpanan hasil konversi
• Icon (Opsional): .ico (Windows), .icns (macOS), .png (Linux)
• Platform: Pilih OS target

2️⃣ Tab Electron Options

• Window Settings: Ukuran, resizable, fullscreen
• Web Preferences: Node.js integration, sandbox mode

3️⃣ Tab Preview

• Start Preview: Jalankan pratinjau di Electron
• Open in Browser: Buka di browser default

4️⃣ Konversi ke EXE

• Klik "Convert to EXE"
• Proses akan berjalan, lihat log di Output Console

---

⚠ Troubleshooting

Masalah	Solusi
Node.js tidak terdeteksi	Pastikan Node.js terinstall dan PATH benar
Error saat konversi	Periksa log, pastikan index.html ada
Preview tidak muncul	Tutup aplikasi lain yang menggunakan port yang sama
Build gagal	Coba npm install electron --global

---

🤝 Kontribusi

• Laporkan bug di Issues
• Ajukan fitur baru via Pull Request

---

📜 Lisensi

MIT License - Bebas digunakan untuk proyek komersial & open source.

---

🎉 Selamat Mencoba! 🚀