holjab/AutoMorph — Repoburst

Star growth

Today—

This week—

This month—

Repository activity

Activity history will appear here once this repo has been tracked for a couple of days.

Embed badge

Show this repository's current trending rank in your README.

Markdown for your README

[![Trending on Repoburst](https://repoburst.com/api/badge/holjab/AutoMorph)](https://repoburst.com/repo/holjab/AutoMorph)

README

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

Key Features

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.

Screenshots

Control Center & Dashboard

Add Package Wizard

Settings & Tunnels

Documentation

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.

Prerequisites

Docker & Docker Compose

Quick Start

Set up your preferred remote tunnel (Pangolin, Tailscale Funnel, or Cloudflare) to obtain your URL and tokens.
Download compose.yaml (from default_compose.yaml) and example.env.
Fill in your details and tunnel credentials in example.env, then rename it to .env.

Run:

docker compose pull
docker compose up -d

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

A Note on AI

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.

Acknowledgements

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