Skip to content

wanquantong/web-to-app

 
 

Repository files navigation

WebToApp Logo

WebToApp

🚀 Transform Websites into Android Apps in Seconds

English | 简体中文

Stars Forks License

Android 6.0+ Kotlin Jetpack Compose Material 3


📱 No coding required · Build APKs directly on your phone · No Android Studio needed



🌟 Zero coding • One-click build • Feature-rich • Open source & free 🌟


📚 Table of Contents

Click to expand/collapse

✨ Key Features

🌐 Core Conversion

Feature Description
🌐 Website to App Wrap any URL into standalone app
🎬 Media to App Images/videos to fullscreen apps
💻 HTML to App React/Vue/Next.js support
📦 One-Click Build No Android Studio needed

🤖 AI Powered

Feature Description
🧩 Extension Modules 10 built-in, 28 templates
🤖 AI Development Natural language coding
🎨 AI Icon Generator Generate beautiful icons
🎵 Music Search Online BGM with lyrics

🛡️ Security & Privacy

Feature Description
🔐 APK Encryption AES-256-GCM protection
🛡️ Browser Spoofing UA & fingerprint spoofing
🚫 Hosts Blocking Domain-level ad blocking
🌍 Isolated Environment Multi-instance isolation

✨ Extra Features

Feature Description
🖼️ Media Gallery Built-in media manager
📱 APK Architecture Multi-arch APK support
📋 Long Press Menu Enhanced context menu
🌐 Browser Engine Custom WebView kernel

☁️ Cloud Services (Pro/Ultra)

Feature Description
☁️ Cloud Projects Activation codes, announcements, version updates, remote config
📤 APK Share Pages Beautiful download pages with GitHub/Gitee dual links
📊 Analytics Dashboard Installs, active users, device/country/version distribution
🔗 Webhooks Event-driven callbacks with HMAC signature verification
💾 Cloud Backup Backup projects to GitHub/Gitee repositories
📦 Dual Distribution Publish APKs to GitHub Releases + Gitee Releases

💡 100% open source & free locally. Cloud services are optional paid features that cover server costs.

📸 Screenshots

Home Create App App Settings Extension Modules

AI Features Build APK Theme Settings

Preview More Features


🎯 Use Cases

📱 Personal 🏢 Business
Quick website access Enterprise internal systems
Media showcase apps Product demo apps
Web enhancement tools Kiosk mode displays
Privacy protection Training apps
👨‍💻 Developer 👨‍👩‍👧 Family
Frontend project packaging Kids learning apps
H5 game packaging Screen time control
Web app testing Educational apps
Rapid prototyping Safe browsing

📦 Quick Start

1️⃣ Clone the repository

git clone https://github.com/shiahonb777/web-to-app.git

2️⃣ Open in Android Studio 3️⃣ Build and run on your device 4️⃣ Start converting websites to apps!

💡 Or download the APK directly from Releases


📋 Feature Details

🌐 Core Features (click to expand)
  • URL to App: Enter any website URL to generate a standalone app
  • Media to App: Convert images/videos into independent apps
  • HTML to App: Convert HTML/CSS/JS projects into standalone apps
  • Frontend Framework Support: React, Vue, Next.js, Nuxt, Svelte one-click packaging
  • Server-Side Apps: Support Node.js, PHP, Python, Go, WordPress projects as standalone apps
  • Gallery App: Create gallery showcase apps from multiple images/videos
  • Custom Icon: Select from gallery or generate with AI
  • Custom Name: Customize the app display name
  • Custom Package Name: Support custom APK package name and version
🧩 Extension Module System
  • Tampermonkey-like Scripts: Inject custom JavaScript/CSS into webpages
  • 10 Built-in Modules: Video downloader, Bilibili/Douyin/Xiaohongshu video extractor, video enhancer, web analyzer, dark mode, privacy protection, content enhancer, element blocker
  • 28 Code Templates: Quickly create common functionality modules
  • Module Categories: 23 categories (content filter, content enhance, style modifier, theme, function enhance, automation, navigation, data extract, data save, interaction, accessibility, media, video, image, audio, security, anti-tracking, social, shopping, reading, translate, developer tools, other)
  • URL Match Rules: Support wildcards and regex patterns
  • Config System: Modules support user-customizable settings
  • Permission Declaration: Fine-grained permission control
  • Share Code: One-click generate share code/QR code for easy module sharing
  • Import/Export: Support module file import and export
  • Chrome Extension Support: Import and run Chrome browser extensions with automatic desktop→mobile adaptation
  • Userscript Support: Import Greasemonkey/Tampermonkey userscripts
🤖 AI Module Development Agent
  • Natural Language Development: Describe requirements in natural language, AI generates module code
  • Syntax Check: Automatic JavaScript/CSS syntax error detection
  • Security Scan: Detect XSS, eval, and other security issues
  • Auto Fix: AI automatically fixes detected errors
  • Code Snippet Library: Quick insert common code snippets
  • Debug Test Pages: Built-in test pages to verify module effects
🎨 AI Features
  • Multi-Provider Support: Google Gemini, OpenAI, GLM, Volcano, MiniMax, OpenRouter, etc.
  • AI HTML Coding: AI-assisted HTML/CSS/JS code generation
  • AI Icon Generator: Generate app icons using AI
  • Icon Library: Collect and manage generated icons
  • Session Management: Multi-session, templates, style customization
  • Live Preview: Preview generated code in real-time
  • AI Settings: Unified API key and model management
✨ Integrated Features
  • Splash Screen: Support image/video splash animations with built-in video trimmer
  • Background Music: Add BGM playlist with LRC lyrics sync
  • Online Music Search: Search and download music online for BGM with lyrics sync
  • Activation Code: Built-in activation with SHA-256 encrypted verification
  • Announcements: Display announcements on startup with link support
  • Announcement Templates: 10 beautiful templates (Xiaohongshu, gradient, glassmorphism, neon, etc.)
  • Ad Blocking: Built-in ad blocking engine to filter web ads and popups
  • Hosts Blocking: Custom hosts file for domain-level blocking and filtering
  • Auto Web Translation: Automatic webpage translation, supports CN/EN/JP/Arabic
  • Browser Engine: Support WebView and GeckoView (Firefox) dual-engine switching
  • Browser Shields: Tracker blocking, HTTPS auto-upgrade, cookie consent blocker, reader mode
  • Browser Spoofing: User-Agent and browser fingerprint spoofing
  • Isolated Browser Environment: Independent runtime for each app with fingerprint spoofing and multi-instance isolation
  • Long Press Menu: Enhanced long-press context menu with custom actions
  • Background Running: Keep running in background after exit, maintain task execution
  • Forced Run Mode: Scheduled forced run, block Home/Back keys, black tech features
  • Auto Start: Support boot auto-start and scheduled auto-start
  • APK Encryption: Config/code/media encryption, integrity check, anti-debug protection
  • Ad Integration: Reserved ad SDK interfaces (banner/interstitial/splash)
📤 Export Options
  • Desktop Shortcut: Create desktop icons, launch like native apps
  • Build APK: Generate standalone APK packages without Android Studio
  • APK Architecture: Select target CPU architectures (arm64-v8a, armeabi-v7a, x86, x86_64)
  • Project Template: Export complete Android Studio projects
🛡️ APK Hardening
  • Hardening Engine: One-click APK hardening protection
  • Anti-Reverse: Prevent decompilation and reverse engineering
  • Dex Protection: Dex file encryption protection
  • Code Obfuscation: Code obfuscation processing
  • Native Protection: Native layer security protection
  • Runtime Shield: Anti-debugging, environment detection
  • Integrity Check: Anti-tampering integrity verification
🎥 Media App Features
  • Image to App: Full-screen image display with fill screen option
  • Video to App: Video playback with loop, audio toggle, autoplay (supports large video streaming)
  • Media Gallery: Built-in gallery for managing and browsing images and videos
  • Display Config: Audio toggle, loop, autoplay, fill screen options
  • Encryption Support: Media files support encryption protection
  • APK Export: Media apps support standalone APK export
🎨 Theme System
  • Multiple Themes: Beautiful built-in theme styles
  • Dark Mode: Follow system or manual toggle
  • Animations: Customizable animation effects and speed
  • Particle Effects: Some themes support particle backgrounds
⚡ App Modifier
  • App Scanner: Automatically scan all installed apps
  • Icon/Name Modifier: Freely modify any app's icon and name
  • Clone Install: Install modified apps with independent package names
  • Shortcut Launch: Create shortcuts with new icons to launch original apps

☁️ Cloud Services (Pro)

Philosophy: WebToApp is 100% open source. All local features are free forever. Cloud services are optional paid features — you're paying for server resources, not for the app itself.

What Pro/Ultra Users Get

Pro and Ultra subscriptions unlock cloud-powered features that require our server infrastructure:

Feature Pro Ultra
Cloud Projects (activation codes, announcements, version updates, remote config) Up to 10 Up to 50
APK Share Pages — beautiful download landing pages with GitHub + Gitee dual links
Analytics Dashboard — installs, active users, country/device/OS/version distribution
Webhooks — event-driven callbacks (code activated, version published, daily report) with HMAC signing
Cloud Backup — push project source to GitHub/Gitee repos
Dual APK Distribution — publish to GitHub Releases + Gitee Releases simultaneously
Per-project activation codes 200 1,000
Per-project active announcements 5 20
Per-project retained versions 5 20
Per-project remote config keys 10 50
FCM Push Notifications

SDK API for Built Apps

Apps built with cloud projects automatically get:

GET  /sdk/{project_key}/check-update    → Over-the-air update check
GET  /sdk/{project_key}/announcements   → Remote announcements
GET  /sdk/{project_key}/config           → Remote configuration
POST /sdk/{project_key}/verify-code      → Activation code verification
POST /sdk/{project_key}/stats            → Usage analytics reporting

All SDK endpoints are cached by Cloudflare CDN (5-min TTL) for global performance.

Share Page

Every cloud project gets a public download page at:

https://api.shiaho.sbs/s/{project_key}

Shows app info, changelog, and dual download buttons (GitHub international + Gitee China).


🛠️ Tech Stack

Category Technology
📝 Language Kotlin 1.9+
🎨 UI Jetpack Compose + Material 3
🏗️ Architecture MVVM + Repository
🗄️ Database Room + DataStore
🌐 Network OkHttp
🖼️ Image Coil
🌍 Browser Engine WebView + GeckoView (Firefox)
🔐 Encryption AES-256-GCM + PBKDF2
✍️ Signing apksig (v1/v2/v3)
🛡️ Native CMake C++17 / NDK
📷 QR Code ZXing
🌍 i18n Dynamic Switching
📱 Min SDK Android 6.0 (API 23)
🎯 Target SDK Android 16 (API 36)

🌍 i18n Structure

  • app/src/main/java/com/webtoapp/core/i18n/Strings.kt Keeps compatibility getters and language/context wiring only.
  • app/src/main/java/com/webtoapp/core/i18n/strings Feature strings are split here by responsibility, including common UI, create/project flows, cloud/community, AI/AI coding/AI config, module/extension, shell/webview, snippet/store/billing, music/build/UI, and legacy compatibility buckets.

📖 Usage Guide

Create Website App

  1. Click "Create App" button on home screen
  2. Enter app name and website URL
  3. (Optional) Select custom icon or generate with AI
  4. (Optional) Configure splash screen, BGM, activation code, announcement, ad blocking, etc.
  5. (Optional) Select extension modules to enhance functionality
  6. Click Save

Create Media App

  1. Click "Create Media App" button
  2. Select image or video file
  3. Configure display options (loop, autoplay, audio toggle, etc.)
  4. (Optional) Add background music
  5. Save and build APK

Create HTML App

  1. Click "Create HTML App" button
  2. Select HTML project folder or single file
  3. Set entry file (default index.html)
  4. Supports React/Vue/Next.js build outputs
  5. Save and build APK

Use Extension Modules

  1. When creating/editing an app, expand the "Extension Modules" card
  2. Click "Select Modules" to browse 10 built-in modules
  3. Select desired modules (video download, dark mode, privacy protection, etc.)
  4. Modules will automatically inject and execute when the app runs

AI-Assisted Development

  1. Go to "Extension Modules" > "AI Module Development"
  2. Describe the functionality you want in natural language
  3. AI generates module code with syntax check and security scan
  4. Preview the effect and save

Run an App

  • Click app card to preview directly
  • Long press or click menu for more options

Build APK Package

  1. Click app card menu > "Build APK"
  2. Configure encryption options (optional)
  3. Configure isolated browser environment (optional)
  4. Configure background running (optional)
  5. Click "Start Build"
  6. Installation dialog appears automatically when complete

Configure Forced Run Mode

  1. When creating/editing an app, expand "Forced Run" card
  2. Enable forced run and select mode (fixed time/countdown/duration)
  3. Configure time period and active days
  4. Configure black tech features (optional)
  5. Build APK and app will force run at specified times

Use App Modifier

  1. Click home menu > "App Modifier"
  2. Search or filter target app in the app list
  3. Click app to enter modification interface
  4. Select new icon, enter new name
  5. Choose operation:
    • Shortcut: Create desktop shortcut with new icon
    • Clone Install: Generate new APK and install as independent app

🔧 Build from Source

Requirements

  • Android Studio Hedgehog (2023.1.1) or later
  • JDK 17
  • Gradle 8.14+

Build Steps

# Clone the repository
git clone https://github.com/shiahonb777/web-to-app.git

# Enter project directory
cd web-to-app

# Build Debug version
./gradlew assembleDebug

# Build Release version
./gradlew assembleRelease

Signing Configuration

For Release builds, configure signing in app/build.gradle.kts:

signingConfigs {
    create("release") {
        storeFile = file("your-keystore.jks")
        storePassword = "your-store-password"
        keyAlias = "your-key-alias"
        keyPassword = "your-key-password"
    }
}

🧩 Extension Module System

Built-in Modules

Module Function
⬇️ Video Downloader Auto-detect webpage videos, supports MP4 and Blob stream download
📺 Bilibili Video Extractor Extract Bilibili highest quality video and audio stream URLs
🎬 Douyin Video Extractor Extract Douyin watermark-free video URLs
📱 Xiaohongshu Video Extractor Extract Xiaohongshu video playback URLs
⚡ Video Enhancer Speed control (0.5x-5x), picture-in-picture, background play, block app redirect
🔧 Web Analyzer Element inspector, network monitor, cookie manager, console injection
🌙 Advanced Dark Mode Smart color inversion, image brightness control, scheduled toggle
🛡️ Privacy Protection Ad blocking, anti-fingerprint tracking, click hijack protection, external link warning
📝 Content Enhancer Force copy, selection translate, long screenshot, Markdown conversion
🚫 Element Blocker Block ads, popups, and specified elements

Module Categories (23)

  • Content Filter, Content Enhance, Style Modifier, Theme
  • Function Enhance, Automation, Navigation, Data Extract
  • Data Save, Interaction, Accessibility
  • Media, Video, Image, Audio
  • Security, Anti-Tracking, Social, Shopping
  • Reading, Translation, Developer Tools, Other

NativeBridge API (Native Capabilities)

Extension modules can call Android native functions via window.NativeBridge:

API Function
showToast(msg, duration?) Show Toast notification
vibrate(ms?) Trigger vibration feedback
vibratePattern(pattern, repeat?) Pattern vibration
copyToClipboard(text) Copy to clipboard
getClipboardText() Read clipboard content
share(title, text, url?) System share dialog
shareImage(imageUrl, title?) Share image
openUrl(url) Open URL in browser
openApp(packageName) Open another app
saveImageToGallery(url, filename?) Save image to gallery
saveVideoToGallery(url, filename?) Save video to gallery
getDeviceInfo() Get device info (JSON)
getAppInfo() Get app info (JSON)
isNetworkAvailable() Check network status
getNetworkType() Get network type
saveToFile(content, filename, mimeType?) Save file
log(message) Output log
setOrientation(orientation) Set screen orientation
getOrientation() Get current orientation
lockOrientation() Lock screen orientation
unlockOrientation() Unlock screen orientation
downloadVideo(url, filename) Download video
downloadWithHeaders(url, filename, headersJson) Download with headers
setScreenBrightness(brightness) Set screen brightness
setKeepScreenOn(keepOn) Keep screen on
enterFullscreen() Enter fullscreen mode
exitFullscreen() Exit fullscreen mode
isFullscreen() Check fullscreen status

📢 Announcement Templates

10 beautiful announcement popup templates:

  • Minimal - Clean and simple
  • Xiaohongshu Style - Lively and cute
  • Gradient - Modern and stylish
  • Glassmorphism - Transparent texture
  • Neon - Cool glowing effect
  • Cute - Pink and sweet
  • Elegant - Golden and noble
  • Festive - Celebratory and lively
  • Dark - Mysterious and deep
  • Nature - Fresh and green

📝 Notes

  1. Some websites may have anti-crawling mechanisms, loading may be limited
  2. Network permission required for normal use
  3. Exported projects need to be compiled with Android Studio on PC
  4. Activation codes support both local verification and cloud-based verification (Pro/Ultra)
  5. Extension modules execute in WebView, some sites may have CSP restrictions
  6. Cloud services require an active Pro/Ultra subscription; all local features remain free forever

📜 License

The Unlicense

📬 Contact

Developed independently by shiaho. Feel free to reach out!

📱 Social Media

Platform Account Link
X (Twitter) @shiaho777 x.com/@shiaho777
Telegram webtoapp777 t.me/webtoapp777
GitHub shiahonb777 github.com/shiahonb777/web-to-app
Bilibili Video Tutorials b23.tv/8mGDo2N

💬 Community Groups

Platform Group ID/Link Description
QQ Group 1041130206 Daily interaction, updates & latest releases
Telegram Group t.me/webtoapp777 International user community

📧 Contact Info

Method Account
Author QQ 2711674184
QQ Email 2711674184@qq.com
Gmail weuwo479@gmail.com

Open Source · Free Forever · Star ⭐ to Support

About

A native Android application that converts any website URL into a standalone Android App.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Kotlin 79.2%
  • Python 16.1%
  • PHP 1.4%
  • C 1.3%
  • HTML 0.6%
  • C++ 0.5%
  • Other 0.9%