CloneKit - Website Cloning Toolkit

A powerful, cross-platform tool for cloning websites with full JavaScript support, text extraction, and easy deployment.

✨ Features

• 🔍 Advanced Cloning - Uses Playwright to capture fully rendered JavaScript-heavy websites
• 📝 Text Extraction - Automatically extracts all visible text for easy editing
• ✏️ Text Editing - Edit extracted texts and apply changes back to cloned sites
• 🌐 Static Hosting - Serve cloned sites with Python HTTP server
• 🚀 Flask Backend - Full Flask server with login logging capabilities
• ☁️ Cloudflare Tunnel - Expose local servers to the internet
• 🎨 Dark Theme GUI - Beautiful, modern dark-themed interface
• 🖥️ Cross-Platform - Works on Windows, Linux (Kali), and macOS

🚀 Quick Start

Windows:

1. Double-click Launch CloneKit.bat
2. Wait for first-time setup
3. Start cloning!

Linux:

1. Double-click Launch CloneKit.sh
2. Wait for first-time setup
3. Start cloning!

First run takes 5-10 minutes (installing dependencies)
Subsequent runs are instant!

📋 Requirements

• Python 3.7+ (auto-detected by launcher)
• Internet connection (for first-time setup)

🎯 Usage

1. Scrape Site

Basic website scraping using wget. Good for simple static sites.

2. Clone Site

Copy a previously scraped site to a new location.

3. Advanced Clone ⭐

Recommended! Uses Playwright to capture:

• Fully rendered JavaScript
• All CSS and assets
• Interactive GUIs
• Dynamic content

4. Extract Texts

Extract all visible text from a cloned site into a JSON file.

5. Edit Texts

Open the extracted text file in your default editor.

6. Apply Text Changes

Apply edited texts back to the cloned site.

7. Host Folder

Serve any folder as a static website.

8. Flask Clone

Launch Flask server with login logging (for Telegram clone, etc.)

9. Expose Tunnel

Expose local server via Cloudflare tunnel.

Launch Browser

Open a URL in your default browser.

🔧 Installation

See INSTALL.md for detailed installation instructions.

📖 Documentation

• QUICK_START.txt - Quick reference guide
• INSTALL.md - Detailed installation instructions
• LAUNCHER_README.md - Launcher documentation

🐛 Troubleshooting

GUI doesn't open

• Check Python is installed: python --version
• Try manual launch: python launcher.py

"Module not found" errors

• Delete venv folder and run launcher again
• It will reinstall everything automatically

Advanced Clone hangs

• Fixed in latest version! Uses proper timeouts and error handling
• Check log window for detailed error messages

Can't close GUI

• Fixed! GUI now properly closes all processes
• Click X button or use Ctrl+C in terminal

💾 Dropbox/Cloud Storage

1. Upload entire telegram_web_k_clone folder to Dropbox
2. Download on any Windows or Linux machine
3. Double-click launcher
4. Works the same on any machine!

🖥️ Desktop Shortcut

Windows:

• Double-click create_desktop_shortcut.vbs

Linux:

• Run: ./create_desktop_shortcut.sh

⚙️ Technical Details

• Virtual Environment: Isolated Python environment (auto-created)
• Dependencies: Auto-installed on first run
• Process Management: All subprocesses properly tracked and cleaned up
• Thread Safety: All dialogs run in main thread to prevent hangs
• Graceful Shutdown: All processes terminated on exit

🔄 Updates

To update:

1. Download new version
2. Replace old folder
3. Delete venv (optional)
4. Run launcher again

📝 License

This tool is for educational and testing purposes only.

✅ What's Fixed

• ✅ GUI properly closes all processes on exit
• ✅ No more hanging on dialogs
• ✅ Advanced Clone uses proper timeouts
• ✅ All subprocesses tracked and cleaned up
• ✅ Thread-safe dialog handling
• ✅ Cross-platform compatibility
• ✅ Easy installation on Windows and Linux

---

Ready to clone! Just double-click the launcher and start using CloneKit.