Repository navigation
RedTerm v2.0.0
Highlights
- Bundled OpenSSH for all four architectures. Connect to any host without
installing a package first. - Backup and restore now round-trip a distribution cleanly, storing only the
distribution's own files. - Soft keyboard behaves as expected: tap inside the terminal to open it, press
back to close it. - Package management works on Arch and openSUSE from a fresh install.
- Landscape layout on the welcome screen is usable again.
- Rotating the phone no longer cancels an install or disturbs the terminal.
Fixed
- Install progress is no longer cancelled by a configuration change.
- The back button closes the keyboard instead of leaving the terminal unusable.
Added
-
SSH → Test runs a non-interactive connection check (
BatchMode, 10 second connect timeout,
remote commandtrue) and shows the verbose trace, so a failed connection names its cause
instead of dying silently. -
Kali Linux: added as a supported distro, installed from NetHunter's own rootfs on
kali.download(it is not published by Termux proot-distro). Available on all four architectures. -
Free-space check before install: the installer now measures available storage against the space a distro needs and refuses up front with a clear message instead of failing part-way through extraction.
-
Distro diagnostics: a Diagnose action on every installed distro reports on 12 health checks (rootfs layout, root uid, DNS,
bash,busybox,/bin/sh,/usrpermissions,/tmp, device nodes,sudo,/root, size) and can be copied to the clipboard. -
File manager actions: every row has a visible ⋮ button for Rename, Copy, Cut, Delete, plus Edit for text files, Open in terminal and Folder info for folders. New folder, paste and refresh actions, a hidden-files toggle, Go to
/rootand a folder size summary. -
Recursive file search: search now walks the entire subtree below the current folder and updates as you type, instead of only matching names in the folder you were looking at. Results are capped and it says so when truncated.
-
File manager navigation: the back arrow and the system back gesture both go up one directory instead of leaving the app, and the arrow keeps the same appearance used everywhere else in the app.
-
Image and video preview: images open with automatic downscaling and EXIF rotation so photos are not sideways; videos play in place.
-
Text editor: text files can be edited in the app and saved back into the rootfs. Saving stages a temporary file and renames it over the original, so an interrupted write cannot truncate a config, and the original permission bits are re-applied first so scripts keep their executable bit.
-
Per-distro and multiple sessions: launching a distro that has no session open now creates one instead of re-showing whatever session happened to be open, and New Session offers every installed distro — picking the current one starts a second, independent session.
-
Package updates: run a distro's own package manager update from the app, with the real output streamed live, and a notification when it finishes.
-
Base image update: check whether Termux publishes a newer proot-distro image for an installed distro and swap it in, keeping
/rootand/home. If anything fails, the previous install is put back. -
Storage usage: free and total space on shared storage, plus per-distro the largest directories with proportional bars.
-
SSH: save servers and connect straight from the app. A full OpenSSH client is bundled with the app, cross-compiled for all four ABIs, so a connection needs no distribution installed and does not depend on a distro shipping
openssh-client. It is unpacked into a small rootfs of its own and run through proot, because Android 12+ mounts app storagenoexec— the same constraint the distro binaries already work around — so the client is subject to exactly the same rule. Host key checking is on, and an ed25519 key pair can be generated from the SSH screen. -
ANSI recordings: record the output of a command with colours and cursor control intact, then replay it in the app. Recordings can be shared or deleted.
-
Backup manager: a dedicated screen lists backup archives with size and date, and offers restore, share or delete for each, plus cleanup of files left behind by interrupted backups.
-
App log: Settings → App log keeps a persistent, bounded log of the app. It can be copied to the clipboard, shared, or downloaded to
Downloads/, and Capture system log adds everything the process wrote to logcat, including output from the support libraries, so a failure that ends a process immediately can actually be diagnosed. -
Completion notifications: background work (package updates, base image updates, backups, recordings) posts a notification when it finishes.
-
Termux proot-distro rootfs: all distros now install from the official prebuilt rootfs images published by termux/proot-distro, extracted and verified in-app.
-
Per-architecture SHA-256 verification: every distro/arch pair ships a hardcoded checksum; downloads are verified before extraction and a mismatch discards the partial file and asks for a clean retry.
-
Resumable distro downloads: interrupted downloads resume over HTTP
Rangeinstead of restarting from zero; a corrupt or server-rejected range falls back to a full re-download automatically. -
Crash reports: uncaught exceptions are recorded centrally under Settings → Crash Reports, following Termux's rollover scheme (
crash-report.txt, thencrash-report2.txt, … at 4096 characters each). Reports can be viewed and copied in-app, downloaded toDownloads/RedTerm-crash-report-<timestamp>.txt, or deleted. -
File viewer: tapping a file in the built-in file manager now opens it in a new viewer with monospace text, horizontal scrolling, binary detection, a 2 MB preview cap and a Copy action. Previously files could be listed but never opened.
-
Home button on the welcome screen: a Home icon now sits opposite Settings, so Home is reachable before any distro is installed.
-
openSUSE: added as a supported distro.
-
Settings section icons: seven new vector drawables (
ic_section_distro,ic_section_appearance,ic_section_font,ic_section_terminal,ic_section_power,ic_section_extra_keys,ic_section_app_lock) shown next to each settings section header. -
Hardcoded strings extracted: all hardcoded text in XML layouts moved to
strings.xml(~90 string resources), enabling full localization. -
RTL symmetry: settings layout uses symmetric horizontal padding for proper right-to-left support.
-
Plurals support:
match_count_for_queryconverted from<string>to<plurals>with propergetQuantityString()in code. -
KILL_BACKGROUND_PROCESSESpermission: added to manifest. -
ToolbarTitletheme: newTextAppearancestyle for toolbar titles (single-line, ellipsize end).
Changed
- Rootfs source: distro downloads point at
termux/proot-distrorelease assets instead of self-hosted tarballs. - Distro lineup: openSUSE added. Artix is no longer offered; Kali returns as a NetHunter rootfs (see Added).
- First-time distro setup: the setup script now installs
bashandsudowith each distro's own package manager,unsetsENVand falls back to the distro's own/bin/shwhenbashis unavailable. Alpine previously had nobash, leaving users in Android'smkshwherebashwas "inaccessible or not found". The script is version-stamped and regenerated on existing installs, and failures no longer abort the whole setup. - Per-distro setup correctness: Arch runs a full
pacman -Syyuupgrade (a partialpacman -Syagainst a prebuilt rootfs left packages requiring a newerGLIBCthan the image shipped); openSUSE clears and recreates/var/cache/zyppand disables the x86-onlyrepo-openh264repository that brokesolvcache builds; Fedora/Rocky/AlmaLinux passskip_if_unavailable, lower retries and shorter timeouts so a stale mirror 404 cannot fail the whole run. - Shell configs preserved:
.bashrcand.bash_profileare only written when missing, so user customizations are never overwritten. - SHA256 checksums: populated for every supported distro/architecture rather than omitted.
- Notification permission flow: the foreground service is no longer gated on
POST_NOTIFICATIONSbeing granted at the moment the activity is created, which meant it was never started and no ongoing notification ever appeared. The service now starts fromonResumeregardless, and the Android 14+PROPERTY_SPECIAL_USE_FGS_SUBTYPEis declared. - Rootfs permissions: extracted directories are
0755and files0644/0755(applied withOs.chmod), withumask 022in the proot launcher. Previously every directory was forced to0700, which produceddirectory permissions differ on /usrwarnings and blocked some package managers. - Distro size display: computed on a background thread and cached with a 10-minute TTL instead of walking the entire rootfs on the main thread.
- Terminal toolbar title: shows only the distro/session name instead of appending the full working-directory path.
- Version bump: versionName
1.0.4→2.0.0, targetSdk35→37. - Resource shrinking:
isShrinkResources = trueenabled in release build. - Toolchain: Gradle
9.7.1→9.8.0. - Dependencies:
core-ktx1.18.0→1.19.1,appcompat1.7.0→1.8.0. - proot rebuilt from source: cross-compiled at the current
termux/prootcommit for all four ABIs (arm64-v8a,armeabi-v7a,x86_64,x86) and linked with 16 KB page alignment, so RedTerm's own native libraries are loadable on 16 KB-page devices.native/build-proot.shwas fixed to install thelibproot*.sonames the app actually loads, build talloc per-ABI, and support all four architectures. - Welcome buttons: changed from
<Button>to<MaterialButton>for proper Material Design styling. - Welcome settings button: simplified from nested
LinearLayout+ImageViewto a singleTextViewwithapp:drawableEndCompat. - Settings section headers: now use
app:drawableStartCompatwith tinted icons instead of plain text. - Programmatic strings: all
setText()calls in Kotlin now usegetString()/getQuantityString()with format strings instead of hardcoded text. - Kotlin KTX adoption:
prefs.edit { }KTX extension,.toUri()extension,.isVisibleKTX property, andapplyblocks replaced witheditor.apply { }throughout. - RTL text alignment:
GravityCompat.ENDused instead of hardcodedgravity="end"in layouts. - Drawable references:
android:drawableEnd/android:drawableTintreplaced withapp:drawableEndCompat/app:drawableTintin welcome layout for backward compatibility. - Welcome screen buttons: removed
buttonBarButtonStyleattribute (was causing plain-text appearance); Material Button styling now applied directly.
Fixed
- Opening the app from a shortcut while a session is already open now works.
- Large distributions no longer crash the app during install.
- Notifications for background work now appear and report completion.
ESCandTABextra keys now reach the terminal.- Pasting into a full-screen program no longer hangs.
- The theme can be changed from the terminal.
- Cancelling a distribution install now cleans up properly and can be resumed.
- Image previews render correctly, and file rows respond to taps.
- Tool screens have a working back button, and extra key rows are aligned.
- A backup is no longer hidden after reinstalling the app.
- A package manager killed mid-update no longer blocks the next one with
Could not get lock.