Build. Brand. Deploy. — One Panel to Rule Them All.

🚀 WUZEN is a powerful web-based control panel that lets you generate custom, signed Android APKs in minutes — no Android Studio, no complex builds, no tears.

---

📑 Table of Contents

• ✨ What Is WUZEN?
• 🌟 Features
• ⚙️ Prerequisites
• 📦 Installation
  • ⚡ Quick Start (Recommended)
  • 🛠️ Manual Setup
• 🔧 Configuration
• 🖥️ Accessing the Panel
• 📱 Building Your First APK
• 🔒 Security
• 🐛 Troubleshooting
• 🤝 Contributing

---

🌐 Web Panel (PC View)

📂 Click to expand Web Panel screenshots

---

📱 Telegram Panel (Tele View)

📂 Click to expand Telegram Panel screenshots

---

✨ What Is WUZEN?

WUZEN Application Builder is a self-hosted, Node.js-powered web panel that allows anyone — even beginners — to generate custom branded Android APKs directly from a browser interface.

No coding knowledge required. Just configure, upload your logo, hit Build, and download your APK.

Browser → WUZEN Panel → Build Script → Signed APK ✅

📦 Download Source Code

🌟 Features

Feature	Description
🔧 One-Click APK Build	Generate APKs from a simple web form — no terminal needed
🎨 Custom Branding	Upload your own logo, set your app name
🌐 WebView Integration	Wrap any URL into a native Android app instantly
🔐 Signed APK Output	All builds are signed and ready for installation
⚡ Fast Builds	Optimized build pipeline powered by apktool + apksigner
📋 Live Build Logs	Watch your APK compile in real-time via the log panel
🖥️ Web-Based Panel	Accessible from any browser on your network

---

⚙️ Prerequisites

⚠️ Before you begin, make sure your server or VPS is running Ubuntu/Debian Linux.
Windows is NOT supported natively. Use WSL2 or a Linux VPS.

You'll need the following installed:

Tool	Version	Why It's Needed
nvm	Latest	Manages Node.js versions cleanly
Node.js	v24 LTS	Runs the WUZEN web panel
OpenJDK	17+	Required by APK tools (Java dependency)
apktool	2.9.3+	Decodes and rebuilds APK files
apksigner	via Android Build Tools	Signs APKs so they can be installed
PM2	Latest	Keeps the panel running in the background

---

📦 Installation

Step 1 — Clone the Repository

git clone <[your-repo-url](https://github.com/sunimakgoho-arch/WUZEN-MYTHOS-EDITION.git)>
cd <WUZEN-MYTHOS-EDITION>

---

⚡ Quick Start (Recommended)

✅ Best for beginners. The build script handles most of the setup automatically.

# Step 1: Configure your server settings FIRST (required)
nano json/config.json

# Step 2: Give the script execute permission
chmod +x build.sh

# Step 3: Run the builder
./build.sh

⚠️ Do NOT skip Step 1. The panel will not work correctly without configuring config.json first.

---

🛠️ Manual Setup (Full Control)

Use this method if the quick start fails or you want full control over each component.

---

1️⃣ Install NVM (Node Version Manager)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

Verify:

nvm --version

---

2️⃣ Install Node.js v24 LTS

nvm install 24
nvm use 24
node --version   # Should output v24.x.x

---

3️⃣ Install OpenJDK 17

sudo apt update
sudo apt install openjdk-17-jdk -y
java -version    # Should output openjdk 17.x.x

---

4️⃣ Install apktool (Latest — Manual Method)

⚠️ Do NOT use apt install apktool — the apt version is often outdated and will cause build failures.

# Download the latest apktool JAR
wget https://bitbucket.org/iBotPeaches/apktool/downloads/apktool_2.9.3.jar -O apktool.jar

# Download the Linux wrapper script
wget https://raw.githubusercontent.com/iBotPeaches/Apktool/master/scripts/linux/apktool -O apktool

# Give execute permissions
chmod +x apktool

# Move both files to system path
sudo mv apktool.jar /usr/local/bin/apktool.jar
sudo mv apktool /usr/local/bin/apktool

Verify:

apktool --version

---

5️⃣ Install apksigner (via Android Build Tools)

⚠️ Do NOT use apt install apksigner — it may be outdated or broken on many systems.

# Install dependencies
sudo apt install unzip wget -y

# Download Android command-line tools
wget https://dl.google.com/android/repository/commandlinetools-linux-latest.zip

# Extract into the right folder structure
mkdir -p $HOME/android/cmdline-tools
unzip commandlinetools-linux-latest.zip -d $HOME/android/cmdline-tools

# Set environment variables (add these to ~/.bashrc for persistence)
export ANDROID_HOME=$HOME/android
export PATH=$ANDROID_HOME/cmdline-tools/cmdline-tools/bin:$ANDROID_HOME/platform-tools:$PATH

# Accept licenses and install build tools
yes | sdkmanager --licenses
sdkmanager "build-tools;34.0.0"

💡 Tip: Add the export lines to your ~/.bashrc file so they persist after reboot:

echo 'export ANDROID_HOME=$HOME/android' >> ~/.bashrc
echo 'export PATH=$ANDROID_HOME/cmdline-tools/cmdline-tools/bin:$ANDROID_HOME/platform-tools:$PATH' >> ~/.bashrc
source ~/.bashrc

Verify:

apksigner version

---

6️⃣ Install Project Dependencies

npm install

---

7️⃣ Install PM2 (Process Manager)

PM2 keeps your panel running even after you close the terminal or reboot.

npm install -g pm2

# Start the panel
pm2 start index.js --name "wuzen-panel"

# Auto-restart on system reboot
pm2 startup
pm2 save

---

🔧 Configuration

⚠️ This step is required before running the panel. Skipping it will cause connection errors.

Open the configuration file:

nano json/config.json

Find the def section and update these two values:

"def": {
  "host": "YOUR_SERVER_IP_OR_DOMAIN",
  "port": "3000"
}

Field	What to Put Here	Example
host	Your VPS IP address or domain name	192.168.1.10 or yourdomain.com
port	The port the panel will run on	3000

Example (local test):

"def": {
  "host": "localhost",
  "port": "3000"
}

Example (VPS/production):

"def": {
  "host": "203.0.113.45",
  "port": "3000"
}

Save and exit: Ctrl+X → Y → Enter

---

🖥️ Accessing the Panel

Once the panel is running, open your browser and go to:

http://YOUR_HOST:3000

First-time login:

1. Enter your activation key when prompted
2. Log in with the default password:

Password: WUZEN

🔴 IMPORTANT: Change the default password immediately after your first login. See Security below.

---

📱 Building Your First APK

Follow these steps inside the WUZEN panel:

Step 1 → Click "Build APK" in the panel
Step 2 → Upload your App Logo (PNG recommended, 512×512px)
Step 3 → Enter your App Name
Step 4 → Set the Host & Port for the app's backend
Step 5 → Enter the WebView URL (the website/app URL to wrap)
Step 6 → Click "Build" and wait
Step 7 → Scroll down to the Logs section
Step 8 → Download your signed APK ✅

⏳ Build time is typically 1–5 minutes depending on server performance.
Do not close or refresh the browser while building.

---

🔒 Security

🚨 These steps are critical if your panel is accessible over the internet.

• Change the default password (WUZEN) immediately after first login
• Do not expose the panel publicly without proper authentication
• Use HTTPS in production (set up a reverse proxy with Nginx + Let's Encrypt)
• Restrict access by IP using a firewall (e.g., ufw) if possible
• Keep dependencies updated regularly

Basic firewall setup (optional but recommended):

sudo ufw allow 22      # SSH
sudo ufw allow 3000    # WUZEN Panel
sudo ufw enable

---

🐛 Troubleshooting

🔴 Port already in use

lsof -i :3000          # Find what's using port 3000
kill -9 <PID>          # Kill that process
pm2 restart wuzen-panel

🔴 Permission denied on build.sh

chmod +x build.sh
./build.sh

🔴 Java not found / Java errors

java -version          # Check if Java is installed
sudo apt install openjdk-17-jdk -y   # Reinstall if missing

🔴 apktool: command not found

Re-run the manual apktool install steps. Make sure both files are in /usr/local/bin/:

ls /usr/local/bin/ | grep apktool

🔴 apksigner not found after installation

Make sure your environment variables are set:

source ~/.bashrc
apksigner version

If still missing, re-run the sdkmanager "build-tools;34.0.0" step.

🔴 npm install fails

nvm use 24             # Make sure you're on the right Node version
node --version         # Confirm v24.x.x
npm install            # Retry

🔴 Panel not loading in browser

1. Check PM2 is running: pm2 status
2. Check your config.json host/port match what you're visiting
3. Check firewall isn't blocking the port: sudo ufw status

---

🤝 Contributing

Contributions are welcome! Here's how to get involved:

1. Fork this repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your changes: git commit -m 'Add your feature'
4. Push to the branch: git push origin feature/your-feature
5. Open a Pull Request

Please open an Issue first for major changes so we can discuss the approach.

---

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Built with ❤️ by the WUZEN Team — 2026

If this project helped you, consider giving it a ⭐ — it helps more people find it!