Germux

About the project

Germux is an Android terminal growing into an AI, package and graphics workspace.

The project is created by Adam Szczepański with the help of artificial intelligence. The goal is a practical Android environment: terminal, native packages, APK building, a PC Live USB Builder and a future graphics plugin.

Download APK See updates AI workflow
AS

Creator

Adam Szczepański

Germux is being developed through conversation, testing and AI-assisted code. Instead of building only another terminal, the project connects an Android app, Linux tools, package recipes, server infrastructure, documentation and a future graphics module.

The author photo can later be added as assets/adam-szczepanski.jpg and replace this placeholder.

Current state

Germux should be useful before it becomes a large ecosystem.

Android/Bionic terminal

A custom shell, profiles, history, colored output, large text handling and stabilized TUI behavior for tools such as Claude and Codex.

AI as operator

AI should read project docs, use gxm commands, analyze logs, repair recipes and guide the user without guessing system state.

Package recipes

The project develops recipe formats, build statuses, test reports and tools for porting Linux programs to Android/Bionic.

Live USB Builder

The phone can control the request, while a PC/Live USB machine builds heavier packages and returns artifacts, logs and smoke test results.

APK toolchain

A planned bundle will connect Gradle, Android SDK/NDK, aapt2, zipalign and APK signing into one developer workflow.

Source Translator

A tool for AI and developers: source scanning, porting plans, glibc/Bionic difference detection and safe compatibility patches.

Roadmap

Near-term development directions.

  1. 1TUI tests: less, nano, vim, real htop, tmux and screen, with fixes only where a real program breaks.
  2. 2APK/dev bundle: Java, Gradle, Android SDK/NDK, aapt2 and a ready APK build flow inside Germux.
  3. 3Server packages: SSH, a lightweight web server, Node/Python, git, curl and tools for local APIs or websites on the phone.
  4. 4Graphics as a test stage: VNC/X11/Openbox or another minimal desktop, first as packages, later as a separate plugin.
  5. 5Public recipes and ranking: confirmed builds, logs, authors, statuses and safe installation of checked variants.
  6. 6Translations: extract app strings into language files and gradually add more website and interface languages.

Idea

Not just a terminal.

Germux should be a place where the user can run Linux tools on Android, but also ask AI to build packages, read logs, create APKs, prepare a server or configure a graphical environment.

Rule

Evidence before publication.

A recipe or package should not be trusted only because it exists. The project should collect a build result, log, smoke test, author and status. AI can help, but the user should see what was done.