a3270

An Android TN3270 terminal emulator based on lib3270j / j3270, built with Jetpack Compose and ported using AI.

Repositories

a3270 (Android App): https://git.hugfreevikings.wtf/rudi/a3270
j3270 (Desktop App & lib3270j Core Library): https://git.hugfreevikings.wtf/rudi/j3270

a3270 relies on the shared 3270 protocol library (lib3270j) provided by the j3270 repository.

CI/CD & Automated Builds

Automated CI/CD is configured using Gitea Actions (.gitea/workflows/build.yml). On every push to main or pull request, the workflow automatically:

Clones a3270 and j3270 (lib3270j).
Configures JDK 21 and the Android SDK.
Builds the debug APK (a3270-debug.apk).
Uploads the resulting APK as a downloadable workflow artifact (a3270-debug).

You can download pre-built APKs directly from the Actions tab of the repository on Gitea.

Prerequisites

Java Development Kit (JDK): JDK 17 or JDK 21
Android SDK: Android SDK with API 34 platforms and build-tools installed (ANDROID_HOME or ANDROID_SDK_ROOT set)

Setup & Building

1. Clone Repositories Side-by-Side

For the easiest setup, clone both j3270 and a3270 into the same parent folder:

git clone https://git.hugfreevikings.wtf/rudi/j3270.git
git clone https://git.hugfreevikings.wtf/rudi/a3270.git
cd a3270

Note: If j3270 is located in another directory, specify its location via the J3270_DIR environment variable:
export J3270_DIR=/path/to/j3270
or via Gradle property:
./gradlew assembleDebug -Pj3270Dir=/path/to/j3270

2. Build the Debug APK

You can build using the helper script:

./build.sh

Or directly with Gradle Wrapper:

./gradlew assembleDebug

The compiled APK will be generated at:

build/outputs/apk/debug/a3270-debug.apk

Deployment / Installation

To install the debug APK onto a connected Android device or emulator via adb:

adb install -r build/outputs/apk/debug/a3270-debug.apk

Contributing

Contributions are welcome!

I have contributed no code to this project, it was entirely written by LLMs with my guidance only.

Acknowledgements

j3270
x3270
Antigravity
Claude Opus 4.6
Gemini 3.1 Pro (High)
Gemini 3.7 Flash (High)

2.4 KiB Raw Blame History