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

A native Android application that converts any website URL into a standalone Android App.
https://github.com/shiahonb777/web-to-app

android app web

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/shiahonb777/web-to-app
• Owner: shiahonb777
• License: unlicense
• Created: 2025-11-26T04:45:16.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2026-03-25T16:17:15.000Z (3 months ago)
• Last Synced: 2026-03-26T18:07:40.396Z (3 months ago)
• Topics: android, app, web
• Language: Kotlin
• Homepage:
• Size: 18 MB
• Stars: 1,791
• Watchers: 11
• Forks: 233
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          




# WebToApp

### 🚀 Transform Websites into Android Apps in Seconds

**English** | [简体中文](README_CN.md)



  

  

  





  

  

  

  






> 📱 **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](#-key-features)

- [📸 Screenshots](#-screenshots)

- [🎯 Use Cases](#-use-cases)

- [📦 Quick Start](#-quick-start)

- [📋 Feature Details](#-feature-details)

- [☁️ Cloud Services (Pro)](#%EF%B8%8F-cloud-services-pro)

- [🛠️ Tech Stack](#%EF%B8%8F-tech-stack)

- [📁 Project Structure](#-project-structure)

- [📖 Usage Guide](#-usage-guide)

- [🔧 Build from Source](#-build-from-source)

- [🧩 Extension Module System](#-extension-module-system)

- [📢 Announcement Templates](#-announcement-templates)

- [📜 Changelog](#-changelog)

- [📬 Contact](#-contact)

---

## ✨ 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





  

  

  

  





  

  

  

  





  

  





---

## 🎯 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

```bash

# 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](https://github.com/shiahonb777/web-to-app/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) |



## 📁 Project Structure

```

app/src/main/java/com/webtoapp/

├── WebToAppApplication.kt      # Application class

├── core/                       # Core modules

│   ├── activation/            # Activation code management

│   ├── adblock/              # Ad blocking engine

│   ├── ads/                  # Ad SDK integration

│   ├── ai/                   # AI features

│   │   ├── AiApiClient.kt   # Multi-provider AI API client

│   │   ├── AiConfigManager.kt # API key/model config management

│   │   ├── AiGenerationService.kt # AI image generation service

│   │   └── htmlcoding/      # AI HTML coding Agent

│   ├── announcement/         # Announcement management

│   ├── apkbuilder/          # APK builder

│   │   ├── ApkBuilder.kt    # Build core (streaming, encryption)

│   │   ├── JarSigner.kt     # APK signing (apksig v1/v2/v3)

│   │   ├── ApkTemplate.kt   # Config/template management

│   │   ├── ArscEditor.kt    # ARSC resource editor

│   │   ├── ArscRebuilder.kt # ARSC rebuilder

│   │   ├── AxmlEditor.kt    # Binary XML editor

│   │   ├── AxmlRebuilder.kt # XML rebuilder

│   │   └── BuildLogger.kt   # Build logger

│   ├── appmodifier/         # App modifier core

│   ├── autostart/           # Boot auto-start/scheduled start

│   ├── background/          # Background running service

│   ├── backup/              # Data backup

│   ├── bgm/                 # Background music

│   │   ├── BgmPlayer.kt     # Player (lyrics sync)

│   │   ├── OnlineMusicApi.kt # Online music search API

│   │   └── OnlineMusicDownloader.kt # Music downloader

│   ├── blacktech/           # Black tech features

│   ├── crypto/              # Encryption system (14 files)

│   │   ├── AssetEncryptor.kt # AES-256-GCM encryption

│   │   ├── AssetDecryptor.kt # Runtime decryption

│   │   ├── NativeCrypto.kt  # Native encryption

│   │   └── RuntimeProtection.kt # Runtime protection

│   ├── disguise/            # Browser spoofing (UA/fingerprint)

│   ├── download/            # Dependency download engine

│   ├── engine/              # Browser engine management

│   │   ├── BrowserEngine.kt  # Browser engine interface

│   │   ├── BrowserEngineCallback.kt # Engine callback

│   │   ├── EngineManager.kt  # Engine manager

│   │   ├── EngineType.kt     # Engine type enum

│   │   ├── SystemWebViewEngine.kt # WebView engine

│   │   ├── GeckoViewEngine.kt # GeckoView (Firefox) engine

│   │   ├── download/         # Engine download

│   │   │   ├── EngineFileManager.kt # Engine file management

│   │   │   └── GeckoEngineDownloader.kt # GeckoView downloader

│   │   └── shields/         # Browser shields

│   │       ├── BrowserShields.kt # Shields controller

│   │       ├── ShieldsConfig.kt # Shields config

│   │       ├── ShieldsStats.kt # Shields statistics

│   │       ├── TrackerBlocker.kt # Tracker blocking

│   │       ├── HttpsUpgrader.kt  # HTTPS upgrader

│   │       ├── GpcInjector.kt # GPC signal injection

│   │       ├── CookieConsentBlocker.kt # Cookie consent blocker

│   │       └── ReaderMode.kt # Reader mode

│   ├── errorpage/           # Error pages

│   ├── export/              # Project export

│   ├── extension/           # Extension module system

│   │   ├── ExtensionModule.kt # Module data model (23 categories/permissions/config)

│   │   ├── ExtensionManager.kt # Module lifecycle management

│   │   ├── BuiltInModules.kt # 10 built-in modules

│   │   ├── BuiltInChromeExtensions.kt # Built-in Chrome extensions

│   │   ├── ModuleTemplates.kt # 28 code templates

│   │   ├── ModulePreset.kt   # Module presets

│   │   ├── CodeSnippets.kt  # 21-category 200+ code snippets

│   │   ├── ExtensionFileManager.kt # Extension file management

│   │   ├── ExtensionPanelScript.kt # Extension panel script

│   │   ├── ExtensionPanelBridge.kt # Panel bridge

│   │   ├── ExtensionPopupManager.kt # Popup manager

│   │   ├── ExtensionResourceInterceptor.kt # Resource interceptor

│   │   ├── ExtensionStorageSync.kt # Storage sync

│   │   ├── ChromeExtensionParser.kt # Chrome extension parser

│   │   ├── ChromeExtensionPolyfill.kt # Chrome API polyfill

│   │   ├── ChromeExtensionRuntime.kt # Chrome extension runtime

│   │   ├── ChromeExtensionMobileCompat.kt # Desktop→mobile adaptation

│   │   ├── DeclarativeNetRequestEngine.kt # Declarative net request engine

│   │   ├── WebRequestBridge.kt # Web request bridge

│   │   ├── GreasemonkeyBridge.kt # Greasemonkey script compat

│   │   ├── UserScriptParser.kt # Userscript parser

│   │   ├── UserScriptWindowScript.kt # Userscript window

│   │   ├── AiModuleDeveloper.kt # AI module developer

│   │   ├── QrCodeUtils.kt   # QR code utilities

│   │   ├── DebugTestPages.kt # Debug test pages

│   │   └── agent/           # AI Agent module development

│   │       ├── ModuleAgentEngine.kt # Agent engine

│   │       ├── EnhancedAgentEngine.kt # Enhanced agent

│   │       ├── AgentContext.kt # Agent context

│   │       ├── AgentTool.kt  # Agent tool definitions

│   │       ├── AgentToolExecutor.kt # Tool executor

│   │       └── AgentWorkingMemory.kt # Agent working memory

│   ├── forcedrun/           # Forced run mode

│   │   ├── ForcedRunManager.kt # Forced run manager

│   │   ├── ForcedRunConfig.kt # Forced run config

│   │   ├── ForcedRunHardwareController.kt # Hardware controller

│   │   ├── ForcedRunAccessibilityService.kt # Accessibility service

│   │   ├── ForcedRunGuardService.kt # Guard service

│   │   └── ForcedRunPermissionHelper.kt # Permission helper

│   ├── frontend/            # Frontend project handling

│   │   ├── ProjectDetector.kt # React/Vue/Next.js detection

│   │   ├── FrontendProjectBuilder.kt # Frontend project builder

│   │   ├── FrontendProjectConfig.kt # Frontend project config

│   │   └── SampleProjectManager.kt # Sample project management

│   ├── golang/              # Go app runtime

│   ├── hardening/           # APK hardening protection

│   │   ├── AppHardeningEngine.kt # Hardening engine

│   │   ├── AntiReverseEngine.kt  # Anti-reverse engineering

│   │   ├── DexProtector.kt  # Dex protection

│   │   ├── CodeObfuscator.kt # Code obfuscation

│   │   ├── NativeProtector.kt # Native layer protection

│   │   ├── EnvironmentDetector.kt # Environment detection

│   │   └── RuntimeShield.kt # Runtime shield

│   ├── i18n/                # Multi-language support (CN/EN/AR)

│   ├── isolation/           # Isolated browser environment

│   │   ├── IsolationManager.kt # Isolation manager

│   │   ├── IsolationConfig.kt # Isolation config

│   │   ├── IsolationScriptInjector.kt # Script injection

│   │   └── FingerprintGenerator.kt # Fingerprint generator

│   ├── linux/               # Linux environment one-click build

│   ├── nodejs/              # Node.js app runtime

│   ├── php/                 # PHP app runtime

│   ├── port/                # Port management

│   ├── python/              # Python app runtime

│   ├── shell/               # Shell mode management

│   ├── logging/             # Logging system

│   │   └── AppLogger.kt     # Application logger

│   ├── sample/              # Sample projects

│   │   └── SampleProjectExtractor.kt # Sample project extractor

│   ├── webview/             # WebView management

│   │   ├── WebViewManager.kt # WebView core manager

│   │   ├── LocalHttpServer.kt # Local HTTP server

│   │   ├── LongPressHandler.kt # Long press menu handler

│   │   ├── TranslateBridge.kt # Translation bridge

│   │   ├── NativeBridge.kt  # Native capability bridge (28 APIs)

│   │   └── DownloadBridge.kt # Download bridge

│   └── wordpress/           # WordPress app runtime

├── ui/                        # UI layer

│   ├── MainActivity.kt      # Main Activity

│   ├── gallery/             # Gallery player

│   │   ├── GalleryPlayerActivity.kt # Gallery Activity

│   │   └── GalleryPlayerScreen.kt # Gallery player screen

│   ├── htmlpreview/         # HTML preview

│   │   └── HtmlPreviewActivity.kt # HTML preview Activity

│   ├── media/               # Media playback

│   │   └── MediaAppActivity.kt # Media app Activity

│   ├── navigation/          # Navigation

│   │   └── AppNavigation.kt # App navigation graph

│   ├── shell/               # Shell mode

│   │   └── ShellActivity.kt # Shell Activity (standalone APK entry)

│   ├── splash/              # Splash screen

│   │   └── SplashLauncherActivity.kt # Splash screen Activity

│   ├── viewmodel/           # ViewModel

│   │   ├── MainViewModel.kt # Main ViewModel

│   │   └── AiModuleDeveloperViewModel.kt # AI module dev ViewModel

│   ├── webview/             # WebView container

│   │   └── WebViewActivity.kt # WebView Activity

│   ├── screens/             # Screens

│   │   ├── HomeScreen.kt    # Home (app list)

│   │   ├── CreateAppScreen.kt # Create website app

│   │   ├── CreateMediaAppScreen.kt # Create media app

│   │   ├── CreateHtmlAppScreen.kt # Create HTML app

│   │   ├── CreateFrontendAppScreen.kt # Create frontend framework app

│   │   ├── CreateGalleryAppScreen.kt # Create gallery app

│   │   ├── CreateNodeJsAppScreen.kt # Create Node.js app

│   │   ├── CreatePhpAppScreen.kt # Create PHP app

│   │   ├── CreatePythonAppScreen.kt # Create Python app

│   │   ├── CreateGoAppScreen.kt # Create Go app

│   │   ├── CreateWordPressAppScreen.kt # Create WordPress app

│   │   ├── ExtensionModuleScreen.kt # Extension modules

│   │   ├── ModuleEditorScreen.kt # Module editor

│   │   ├── AiModuleDeveloperScreen.kt # AI module dev

│   │   ├── AiCodingScreen.kt # AI coding assistant

│   │   ├── HtmlCodingScreen.kt # AI HTML coding

│   │   ├── AiSettingsScreen.kt # AI settings

│   │   ├── BrowserKernelScreen.kt # Browser engine management

│   │   ├── HostsAdBlockScreen.kt # Hosts ad blocking

│   │   ├── ThemeSettingsScreen.kt # Theme settings

│   │   ├── LinuxEnvironmentScreen.kt # Linux environment

│   │   ├── RuntimeDepsScreen.kt # Runtime dependency management

│   │   ├── PortManagerScreen.kt # Port management

│   │   ├── AppModifierScreen.kt # App modifier

│   │   ├── WordPressSettingsScreen.kt # WordPress settings

│   │   ├── AboutScreen.kt   # About/changelog

│   │   └── aimodule/        # AI module dev (refactored)

│   │       ├── AiModuleDeveloperScreenRefactored.kt

│   │       ├── AiModuleDeveloperUiState.kt

│   │       └── AiModuleDeveloperViewModel.kt

│   ├── components/          # Reusable components (38 files)

│   │   ├── announcement/    # Announcement templates

│   │   │   ├── AnnouncementTemplates.kt # 10 announcement templates

│   │   │   └── AnnouncementTemplateSelector.kt # Template selector

│   │   ├── aimodule/        # AI module dev components

│   │   │   ├── CodePreviewPanel.kt # Code preview

│   │   │   ├── ErrorCard.kt # Error card

│   │   │   ├── ModelSelector.kt # Model selector

│   │   │   ├── StreamingMessageBubble.kt # Streaming message

│   │   │   ├── ThinkingBlock.kt # Thinking block

│   │   │   └── ToolCallCard.kt # Tool call card

│   │   ├── htmlcoding/      # HTML coding components

│   │   │   └── HtmlCodingComponents.kt

│   │   ├── IconGeneratorDialog.kt # AI icon generator

│   │   ├── IconPickerWithLibrary.kt # Icon picker

│   │   ├── IconLibraryDialog.kt # Icon library

│   │   ├── BgmCard.kt       # BGM config card

│   │   ├── BgmSelector.kt   # BGM selector/online search

│   │   ├── VideoTrimmer.kt  # Video trimmer

│   │   ├── EncryptionConfigCard.kt # Encryption config

│   │   ├── HardeningConfigCard.kt # APK hardening config

│   │   ├── IsolationConfigCard.kt # Isolation config

│   │   ├── DisguiseConfigCard.kt # Browser spoofing config

│   │   ├── BackgroundRunConfigCard.kt # Background run config

│   │   ├── ForcedRunConfigCard.kt # Forced run config

│   │   ├── ForcedRunCountdownOverlay.kt # Forced run countdown

│   │   ├── BlackTechConfigCard.kt # Black tech config

│   │   ├── AutoStartCard.kt # Auto start config

│   │   ├── ActivationCodeCard.kt # Activation code config

│   │   ├── EnhancedActivationDialog.kt # Enhanced activation dialog

│   │   ├── DataBackupCard.kt # Data backup card

│   │   ├── StatusBarConfigCard.kt # Status bar config

│   │   ├── StatusBarBackground.kt # Status bar background

│   │   ├── StatusBarImageCropper.kt # Status bar image cropper

│   │   ├── ExtensionModuleCard.kt # Extension module card

│   │   ├── ExtensionModuleSelector.kt # Module selector

│   │   ├── CodeSnippetSelector.kt # Code snippet selector

│   │   ├── SampleProjectCard.kt # Sample project card

│   │   ├── TypedSampleProjectCard.kt # Typed sample card

│   │   ├── LongPressMenu.kt # Long press menu component

│   │   ├── QrCodeShareDialog.kt # QR code sharing

│   │   ├── AppNameTextField.kt # App name input

│   │   ├── CategoryComponents.kt # Category components

│   │   ├── ColorPickerDialog.kt # Color picker

│   │   ├── CommonUIComponents.kt # Common UI components

│   │   ├── EnhancedElevatedCard.kt # Enhanced card

│   │   ├── ThemedComponents.kt # Themed components

│   │   ├── LanguageSelector.kt # Language selector

│   │   ├── LrcEditorDialog.kt # LRC lyrics editor

│   │   └── ManualLrcAligner.kt # Manual lyrics aligner

│   ├── data/                # Data layer

│   │   ├── model/           # Data models

│   │   │   ├── WebApp.kt    # App entity (11 AppTypes)

│   │   │   ├── AppCategory.kt # App category

│   │   │   └── AiConfig.kt  # AI config

│   │   ├── dao/             # DAO

│   │   │   ├── WebAppDao.kt # App DAO

│   │   │   └── AppCategoryDao.kt # Category DAO

│   │   ├── database/        # Database

│   │   │   └── AppDatabase.kt # Room database

│   │   ├── repository/      # Repository

│   │   │   ├── WebAppRepository.kt # App repository

│   │   │   └── AppCategoryRepository.kt # Category repository

│   │   └── converter/       # Type converters

│   │       └── Converters.kt # Room TypeConverter

│   └── theme/               # Theme system

│       ├── Theme.kt         # Theme definition

│       ├── AppThemes.kt     # App theme collection

│       ├── ThemeAnimations.kt # Theme animations

│       └── ThemeManager.kt  # Theme manager

└── util/                      # Utilities (21 files)

    ├── Extensions.kt        # Kotlin extensions

    ├── HtmlProjectProcessor.kt # HTML project processing

    ├── ZipProjectImporter.kt # ZIP project import

    ├── MediaSaver.kt        # Media saving

    ├── MediaStorage.kt      # Media storage

    ├── FaviconFetcher.kt    # Favicon fetcher

    ├── IconStorage.kt       # Icon storage

    ├── IconLibraryStorage.kt # Icon library storage

    ├── CacheManager.kt      # Cache management

    ├── DownloadHelper.kt    # Download helper

    ├── DownloadNotificationManager.kt # Download notifications

    ├── AppUpdateChecker.kt  # App update checker

    ├── OfflineManager.kt    # Offline management

    ├── GsonProvider.kt      # Gson provider

    ├── UrlSafety.kt         # URL safety check

    ├── BgmStorage.kt        # BGM storage

    ├── HtmlStorage.kt       # HTML storage

    ├── SplashStorage.kt     # Splash screen storage

    ├── ProcessCompat.kt     # Process compat

    ├── ThreadLocalCompat.kt # ThreadLocal compat

    └── TvUtils.kt           # TV adaptation utilities

```

## 📖 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

```bash

# 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`:

```kotlin

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 |

### Module Development Example

```javascript

// Example: Auto hide ads

const selectors = getConfig('selectors', '.ad-banner').split('\n');

function hideAds() {

    selectors.forEach(sel => {

        document.querySelectorAll(sel).forEach(el => {

            el.style.display = 'none';

        });

    });

}

hideAds();

new MutationObserver(hideAds).observe(document.body, { childList: true, subtree: true });

```

## 📢 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

MIT License

## 📜 Changelog

### v1.9.5

**New Features**

- Cookies persistence feature

- Multi API key management configuration

- Model name search feature

- Hide URL preview feature

- Popup blocker feature

**Improvements**

- Optimized custom API endpoint adaptation

- Optimized model name display

- Optimized multi-language content adaptation

**Bug Fixes**

- Fixed gallery app build path issue

- Fixed microphone permission issue

- Fixed zoom property not working issue

- Fixed activation code language display issue

- Fixed frontend and gallery app filename display issue

- Fixed core config edit for some app types not working

- Fixed keyboard initialization issue

### v1.9.0

**New Features**

- Browser Engine: Support for custom WebView kernel configuration

- Browser Spoofing: User-Agent and browser fingerprint spoofing

- Hosts Blocking: Custom hosts file for domain-level blocking

- Long Press Menu: Enhanced long-press context menu options

- APK Architecture: Support for selecting target CPU architectures (arm64-v8a, armeabi-v7a, x86, x86_64)

- Media Gallery: Built-in media gallery for managing images and videos

**Improvements**

- Optimized extension module functionality

- Improved English and Arabic translation support

- Enhanced theme interactions and performance

- Optimized API configuration testing

**Bug Fixes**

- Fixed app name displaying excessive spaces

- Fixed popup announcement navigation issues

- Fixed crash when calling external browser

- Fixed download errors

- Fixed crash when editing modules

- Fixed AI image generation not working

- Fixed downloader and player coordination issues

### v1.8.5

**New Features**

- App Category: Organize apps into custom categories

- Website Favicon Fetch: Automatically fetch website icons as app icons

- Random App Name: Generate random app names with one click

- Multi App Icons: Support multiple icon options per app

**Improvements**

- Optimized data backup functionality

- Optimized BlackTech feature

**Bug Fixes**

- Fixed element blocker issues

- Fixed background run feature crash

- Fixed multi-language string adaptation issues

### v1.8.0

**New Features**

- Multi-language Support: Chinese, English, and Arabic languages

- Share APK Feature: Share built APK files

- Element Blocker Extension Module: Visually block webpage elements

- Forced Run Mode: Support app forced run mode

- Linux One-Click Build: Support one-click frontend project build in Linux environment

- Vue/React/Vite to APK: Convert frontend framework projects to APK

**Improvements**

- Optimized theme functionality

- Optimized About page UI

**Bug Fixes**

- Fixed status bar issue in fullscreen mode

- Fixed crash issue on some devices/emulators

### v1.7.7

**New Features**

- Status bar style configuration: Custom height, background color/image, transparency

- APK encryption protection: Encrypt configuration files and resources

### v1.7.6

**New Features & Improvements**

- Boot auto-start and scheduled auto-start functionality

- Data backup: One-click export/import all app data

- Transparent status bar overlay in fullscreen mode

### v1.7.5

**New Features & Improvements**

- Show status bar option in fullscreen mode: Solves the navigation bar issue when not using fullscreen mode

- Fixed long-press text cannot be copied in HTML projects

- Support Android 6.0 (API 23)

### v1.7.4

**Bug Fixes**

- Fixed HTML app not showing status bar issue

- Fixed some system apps showing empty names

- Fixed code block content overlay issue in AI Module Developer

- Fixed tool calling failure in AI HTML Coding

- Optimized AI HTML Coding prompts and model compatibility

### v1.7.3

**New Features & Improvements**

- Status bar color follows theme: Defaults to theme color, light background for light theme, dark background for dark theme

- Support custom status bar background color: Choose transparent, follow theme, or custom color

- Fixed status bar text visibility issue

### v1.7.2

**Bug Fixes**

- Fixed JS file picker compatibility issue on some systems

- Fixed video fullscreen not auto-rotating to landscape, now auto-rotates and fills screen

### v1.7.1

**Bug Fixes & New Features**

- Fixed long-press image save not working on Xiaohongshu and similar sites

- Added Xiaohongshu image downloader module with batch download support

- Fixed Blob format file (e.g., JSON) export failure

- Fixed CSS/JS not working after HTML project import

- Fixed duplicate app name display in recent tasks list

### v1.7.0

**Bug Fixes & Improvements**

- Fixed dozens of known issues

- Optimized AI Agent programming architecture

- Immersive fullscreen mode for exported APKs

  - Status bar and navigation bar fully transparent

  - Content fills the entire screen

  - Support for notch/punch-hole displays

  - Auto-hide virtual buttons during video playback

- Extended app name length support (up to ~60 Chinese characters)

### v1.6.0

**New Features**

- Extension Module System: Tampermonkey-like JS/CSS injection system

  - 9 feature-rich built-in modules (video download, platform video extractors, video enhancer, web analyzer, dark mode, privacy protection, content enhancer)

  - 30+ code templates for quick module creation

  - 20+ module categories covering common needs

  - URL match rules support (wildcards/regex)

  - User-configurable settings

  - Share code import/export

- AI Module Development Agent: AI-assisted extension module development

  - Natural language requirement description, auto code generation

  - Automatic syntax check and security scan

  - Auto-fix detected errors

  - Code snippet library for quick insertion

- AI Icon Generator: Generate app icons using AI

- Icon Library: Collect and manage generated icons

- Online Music Search: Search and download music online for BGM

- Announcement Template System: 10 beautiful popup templates

- Auto Web Translation: Automatic webpage content translation

**Improvements**

- Refactored extension module architecture for more flexible development

- Optimized AI features, support more models and providers

### v1.5.0

**New Features**

- AI HTML Coding Assistant: AI-powered code generation

  - Multiple text/image generation models

  - Session management, templates, styles

  - Code block parsing, live preview

- AI Settings: Unified API key and model management

  - Multiple API keys, real-time connection testing

  - Custom Base URL, model list fetched from API

- HTML App: Convert HTML/CSS/JS projects into standalone Android apps

- Theme System: Brand new theme customization

  - Multiple beautiful theme styles, dark mode support

  - Customizable animation effects and speed

- Background Music (BGM): Add BGM with LRC lyrics sync

**Improvements**

- Home UI integration with AI Coding, Theme, AI Settings entries

- FAB menu adds HTML app creation

### v1.3.0

**New Features**

- Media App: Convert images/videos into standalone apps

- User Scripts: Support custom JavaScript injection

- Splash Screen: Support image/video with audio toggle, landscape, fill screen

- Video Trimmer: Visual video segment selection with real-time preview

**Improvements**

- Data model refactoring for video trimming configuration persistence

- Shell mode (APK export) fully supports splash screen playback

- Optimized MediaPlayer for precise seek and auto-stop

**Bug Fixes**

- Fixed shortcut icon incorrectly using splash image

- Fixed database schema mismatch causing crashes

### v1.2.x

- APK icon cropping fix (Android Adaptive Icon compliance)

- Release build custom icon fix

- Fullscreen mode support

### v1.1.0

- One-click APK building

- App modifier with clone install

- Desktop mode for web pages

- Material Design 3 UI

### v1.0.0

- Initial release

- URL to shortcut

- Activation codes, announcements, ad blocking

- Project template export

## 📬 Contact

Developed independently by shiaho. Feel free to reach out!

### 📱 Social Media

| Platform | Account | Link |

|----------|---------|------|

| **X (Twitter)** | @shiaho777 | [x.com/@shiaho777](https://x.com/@shiaho777) |

| **Telegram** | webtoapp777 | [t.me/webtoapp777](https://t.me/webtoapp777) |

| **GitHub** | shiahonb777 | [github.com/shiahonb777/web-to-app](https://github.com/shiahonb777/web-to-app) |

| **Bilibili** | Video Tutorials | [b23.tv/8mGDo2N](https://b23.tv/8mGDo2N) |

### 💬 Community Groups

| Platform | Group ID/Link | Description |

|----------|---------------|-------------|

| **QQ Group** | 1041130206 | Daily interaction, updates & latest releases |

| **Telegram Group** | [t.me/webtoapp777](https://t.me/webtoapp777) | International user community |

### 📧 Contact Info

| Method | Account |

|--------|---------|

| **Author QQ** | 2711674184 |

| **QQ Email** | 2711674184@qq.com |

| **Gmail** | weuwo479@gmail.com |

---

## ⚠️ Legal Disclaimer

> **Important Notice**: By using this software, you acknowledge that you have read, understood, and agreed to all the following terms.

### 1. Software Nature and Purpose

This software is an **open-source technical research and educational demonstration tool**. All features are implemented based on Android's public APIs, intended to demonstrate mobile application development technology. This software does not encourage or support any illegal use.

### 2. User Responsibilities and Obligations

Users should ensure they use this software in **legal and legitimate** scenarios, including but not limited to:

- **Self-Management**: For personal focus training and study time management

- **Enterprise Display**: For exhibition terminals in trade shows, malls, etc.

- **Parental Supervision**: Reasonable use with minors' informed consent

- **Educational Research**: For technical learning and security research

⛔ **Strictly prohibited** to use this software for any behavior that infringes on others' personal freedom, privacy, property rights, or other legitimate rights and interests.

### 3. Special Declaration for Advanced Features

The "Forced Run" and related hardware control features (hereinafter referred to as "Advanced Features") contained in this software are of a **technical demonstration nature**:

1. **[Informed Consent Principle]** Advanced features should only be enabled when the device owner or user is fully informed and has explicitly consented

2. **[Autonomous Control Principle]** All features provide emergency exit mechanisms; users can terminate at any time via password

3. **[Technology Neutrality Principle]** The features themselves are not illegal; their legality depends on the user's specific use method and purpose

4. **[Risk Assumption Principle]** Enabling advanced features may cause device heating, accelerated battery consumption, etc.; users must assume related risks

### 4. Disclaimer

1. This software is provided "**AS IS**"; the developer makes no express or implied warranties regarding the software's suitability, reliability, or security

2. **All legal liabilities** arising from users' use of this software in violation of laws, regulations, or this statement shall be borne by the users themselves and have nothing to do with the developer

3. The developer shall not be liable for any direct, indirect, incidental, special, or punitive damages caused by the use of this software

4. Any third party's modification or distribution of this software's source code shall bear its own legal responsibility

### 5. Compliance Guidelines

To ensure legal and compliant use, users are advised to:

- ✅ Obtain written or electronic consent from the actual device user before use

- ✅ Develop corresponding usage specifications and management systems in enterprise scenarios

- ✅ Ensure compliance with relevant educational regulations in educational scenarios

- ✅ Regularly check and comply with the latest requirements of local laws and regulations

### 6. Intellectual Property Statement

This software is released under the **MIT Open Source License**. Users may freely use, modify, and distribute it, but must retain the original copyright notice. Legal responsibilities for secondary development based on this software shall be borne by the secondary developer.

### End User Agreement Confirmation

By continuing to use this software, you confirm that:

- ✓ You are at least 18 years old or have obtained consent from a legal guardian

- ✓ You have fully read and understood all the above terms

- ✓ You agree to comply with all terms of use and local laws and regulations

- ✓ You voluntarily assume all risks and responsibilities that may arise from using this software

---

*This statement takes effect from the date of publication. The developer reserves the right to modify this statement at any time.*

*Last updated: January 2026*

---



**Open Source · Free Forever · Star ⭐ to Support**