A self-hosted tool for automatically patching and distributing Android packages, built on Morphe Desktop.

• Automated repo tracking: Monitors patch repositories for updates.
• Automatic APK downloads: Downloads base APKs automatically, prioritising Google Play and falling back to APKCombo, Uptodown, and APKPure.
• Email notifications and web portal: Get email alerts with direct download links whenever a patch succeeds, or download builds directly from the web portal. A dedicated Android app for notifications and downloads is planned.
• Scheduled or manual builds: Run automatically once a day at a time of your choice, or start a build manually through the web interface.
• Free hosting: Designed to run within the free tier of Oracle Cloud Infrastructure.
  • Works with free Pangolin tunnels or Tailscale Funnel for a URL to access the web portal and downloads.
  • Supports Cloudflare Tunnels if you use a custom domain.

For full step-by-step guides, visit our Documentation Hub:

• ☁️ Oracle Free Tier Setup Guide (Optional): Optional guide to launch a free VPS on Oracle Cloud (skip if you already have your own server!).
• 🚇 Remote Access & Tunnels Guide: Expose your portal securely with free HTTPS via Pangolin, Tailscale Funnel, or Cloudflare Tunnels.
• 📖 User Guide & Web Interface: Managing packages, customizing patch options, daily schedules, and email notifications.

• Docker & Docker Compose

1. Set up your preferred remote tunnel (Pangolin, Tailscale Funnel, or Cloudflare) to obtain your URL and tokens.

2. Download compose.yaml (from default_compose.yaml) and example.env.

3. Fill in your details and tunnel credentials in example.env, then rename it to .env.

4. Run:

   docker compose pull
   docker compose up -d

5. Open your web portal via your configured tunnel or local URL (http://localhost:8080). For detailed configuration, see the User Guide.

AutoMorph started as a personal project to practise and improve my Python skills. I wrote the vast majority of the backend and core logic myself. The web interface was mostly written with AI assistance, with me guiding the development.

• Morphe Desktop
• Obtainium - Heavily inspired the package scraping and discovery methods.
• goopdl - For downloads from Google Play: https://github.com/Villoh/goopdl