Termux Customization

Stars Forks zsh bash

Termux Theme Changer (TTC) is a fully automated, pure-shell Termux customization suite. One command installs everything — dependencies, ZSH plugins, custom fonts, a personalized ASCII banner, and a themed color palette. It auto-detects first-time users and runs setup automatically, and checks for version updates on every launch.

• Pure shell — no Python required, runs entirely in Bash/ZSH.
• Auto-install — missing tools (git, zsh, figlet, fzf, etc.) are installed automatically on first run.
• First-time detection — automatically starts theme installation for new users, no extra steps needed.
• Version-based update system — checks version.json on GitHub on every launch and notifies you when a new version is available.
• Flexible update prompt — choose to update now, skip once, or skip this version entirely.
• Modular structure — main controller, installer, and updater are separate files for easier maintenance.
• Auto-size UI — all boxes auto-fit to your terminal width.
• Fully customized ZSH prompt with colors and modern aesthetics.
• ZSH plugins: autosuggestions, syntax-highlighting, autocomplete, fzf, bgnotify.
• logo-ls integration for a modern ls experience with icons.
• Custom Nerd Font + termux.properties configuration.
• Personalized RXFETCH-style terminal banner with your name.
• Restore script to safely revert Termux to its default state.

One-time setup — clones the repo and creates the ttc command globally.

Step 1 — Clone the repo

apt update && apt upgrade -y
pkg install git -y
git clone https://github.com/M41NUL/termux-theme-changer.git
cd termux-theme-changer

Step 2 — Run setup

bash setup.sh

The setup will:

• Install any missing required tools automatically
• Set up ZSH plugins, Nerd Font, and color theme
• Create the ttc global command
• Auto-launch TTC after setup completes

Step 3 — Run anytime after install

ttc

Re-install / Update manually

cd termux-theme-changer
bash setup.sh

Recommended: Run on a fresh Termux installation for best results.

Remove TTC folder:

rm -rf ~/termux-theme-changer

Remove the ttc global command:

rm -f $PREFIX/bin/ttc

Remove ZSH config (optional):

rm -f ~/.zshrc ~/.zsh_history ~/.profile

Or use the built-in restore script to reset everything:

bash ~/restore.sh

Every time ttc launches, it fetches version.json from GitHub and compares it with the local version.

To release a new update, only version.json needs to be changed:

{
 "version": "2.0.0",
 "message": "Added new features and improvements."
}

On every ttc launch, these packages are checked and installed if missing:

git curl zsh figlet fzf neofetch

No user input needed — all done automatically.

termux-theme-changer/
├── ttc.sh # Main controller & menu
├── install.sh # Theme installer (modular)
├── update.sh # Version check & update logic
├── setup.sh # One-time repo setup
├── version.json # Current version info (checked on every launch)
├── shared/
│ └── prog.sh # Shared colors, progress bar, helpers
├── installer/
│ ├── env/i1-env.sh # figlet + TTC ASCII display
│ ├── core/i2-core.sh # Core packages (bash, curl, git, zsh)
│ ├── extra/i3-extra.sh # logo-ls build & aliases
│ ├── plugins/i4-plugins.sh # ZSH plugins clone
│ ├── theme/i5-theme.sh # Colors, font, termux.properties, banner
│ ├── shell/i6-shell.sh # .zshrc write & zsh default shell
│ ├── restore/i7-restore.sh # Create ~/restore.sh
│ └── final/i8-final.sh # Done message
├── Font/
│ └── font.ttf # Custom Nerd Font
└── themes/
 └── banner.sh # RXFETCH-style terminal banner (generated)

GitHub Telegram Channel Group YouTube Email

_{© 2026 CODEX-M41NUL. All Rights Reserved.}