WebToApp

🚀 Transform Websites into Android Apps in Seconds

English | 简体中文

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

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

# 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

app/src/main/java/com/webtoapp/
├── WebToAppApplication.kt      # Application class
├── core/                       # Core modules
│   ├── activation/            # Activation code management
│   ├── adblock/              # Ad blocking engine
│   ├── ai/                   # AI features
│   │   ├── AiApiClient.kt   # Multi-provider AI API client
│   │   └── htmlcoding/      # AI HTML coding Agent
│   ├── announcement/         # Announcement management
│   ├── apkbuilder/          # APK builder
│   │   ├── ApkBuilder.kt    # Build core (streaming, encryption)
│   │   ├── ApkSigner.kt     # JarSigner APK signing
│   │   └── ApkTemplate.kt   # Config/template management
│   ├── autostart/           # Boot auto-start/scheduled start
│   ├── background/          # Background running service
│   ├── bgm/                 # Background music
│   │   ├── BgmPlayer.kt     # Player (lyrics sync)
│   │   └── OnlineMusicApi.kt # Online music search/download
│   ├── crypto/              # Encryption system
│   │   ├── AssetEncryptor.kt # AES-256-GCM encryption
│   │   └── AssetDecryptor.kt # Runtime decryption
│   ├── extension/           # Extension module system
│   │   ├── BuiltInModules.kt # 10 built-in modules
│   │   ├── ModuleTemplates.kt # 30+ code templates
│   │   └── agent/           # AI Agent module development
│   ├── forcedrun/           # Forced run mode
│   │   ├── ForcedRunManager.kt # Forced run manager
│   │   └── ForcedRunHardwareController.kt # Black tech features
│   ├── i18n/                # Multi-language support
│   ├── isolation/           # Isolated browser environment
│   │   └── IsolationManager.kt # Fingerprint spoofing/isolation
│   ├── shell/               # Shell mode management
│   └── webview/             # WebView management
│       ├── TranslateBridge.kt # Translation bridge
│       ├── NativeBridge.kt  # Native capability bridge
│       └── DownloadBridge.kt # Download bridge
├── ui/                        # UI layer
│   ├── MainActivity.kt      # Main Activity
│   ├── screens/             # Screens
│   │   ├── HomeScreen.kt    # Home (app list)
│   │   ├── CreateAppScreen.kt # Create website app
│   │   ├── CreateMediaAppScreen.kt # Create media app
│   │   ├── CreateHtmlAppScreen.kt # Create HTML app
│   │   ├── ExtensionModuleScreen.kt # Extension modules
│   │   ├── AiModuleDeveloperScreen.kt # AI module dev
│   │   ├── HtmlCodingScreen.kt # AI HTML coding
│   │   ├── AppModifierScreen.kt # App modifier
│   │   └── AboutScreen.kt   # About/changelog
│   ├── components/          # Reusable components
│   │   ├── announcement/    # 10 announcement templates
│   │   ├── IconGeneratorDialog.kt # AI icon generator
│   │   ├── OnlineMusicSelector.kt # Online music
│   │   ├── EncryptionConfigCard.kt # Encryption config
│   │   ├── IsolationConfigCard.kt # Isolation config
│   │   ├── BackgroundRunConfigCard.kt # Background run config
│   │   └── ForcedRunConfigCard.kt # Forced run config
│   └── theme/               # Theme system
└── util/                      # Utilities

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

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

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

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

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

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

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

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

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

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

# 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

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"
    }
}

• Content Filter, Content Enhance, Style Modifier, Theme
• Function Enhance, Automation, Navigation, Data Extract
• Media, Video Enhance, Image Processing, Audio Control
• Security & Privacy, Anti-Tracking, Social, Shopping
• Reading Mode, Translation, Developer Tools, Other

// 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 });

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

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 are verified locally only, extend for server-side verification if needed
5. Extension modules execute in WebView, some sites may have CSP restrictions

MIT License

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

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

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

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

New Features

• Status bar style configuration: Custom height, background color/image, transparency
• APK encryption protection: Encrypt configuration files and resources

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

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)

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

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

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

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

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)

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

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

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

• APK icon cropping fix (Android Adaptive Icon compliance)
• Release build custom icon fix
• Fullscreen mode support

• One-click APK building
• App modifier with clone install
• Desktop mode for web pages
• Material Design 3 UI

• Initial release
• URL to shortcut
• Activation codes, announcements, ad blocking
• Project template export

Developed independently by shiaho. Feel free to reach out!

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

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.

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.

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

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

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

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.

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