Skip to content
Remo773 edited this page Sep 8, 2025 · 4 revisions

🧠 T-Header Wiki

T-Header is a customizable terminal header and ZSH enhancement toolkit designed for Termux users. It integrates visual flair, plugin management, and interactive menus using tools like fzf, figlet, lolcat, and gum.


📦 Installation

apt update && yes | apt upgrade && apt update && apt install git fzf -y
git clone https://github.com/remo7777/T-Header.git
cd T-Header/
ls
bash t-header.sh

This script installs required packages, fonts, and sets up ZSH with Oh-My-Zsh and custom themes.


🛠️ Troubleshooting

Termux Force Close Issue
If you're experiencing Termux force closing after installing T-Header:

🔧 Fix:
Navigate to the project root directory and run:

git pull
bash t-header.sh

This will update the files and re-run the setup to resolve any compatibility issues.


📁 File Structure

File/Directory Description
t-header.sh Main installer and setup script
lib/fmenu Interactive menu functions (logo, title, theme, properties)
lib/confzsh ZSH plugin manager and theme creator
bin/theader CLI dispatcher for T-Header commands
dotfile/.profile Shell enhancements and widgets
dotfile/.aliases Custom aliases (user-defined)

🎨 Features

Terminal Header Customization

  • ASCII logo via figlet and boxes
  • Dynamic title rendering with lolcat
  • Indentation and layout control

ZSH Enhancements

  • Oh-My-Zsh installer
  • Plugin manager with GitHub integration
  • Custom theme generator (theader.zsh-theme)
  • Interactive theme switcher

Termux Integration

  • Reads .termux/colors.properties for theme adaptation
  • Updates termux.properties via fzf menu
  • Reloads Termux settings automatically

Widgets (ZSH)

  • Alt+T: Insert file path
  • Alt+C: Change directory
  • Ctrl+R: Search history

🔧 Usage

After installation, use the theader command:

theader

Or symlinked commands:

clogo     # Change logo
ctitle    # Change title
ctpro     # Change termux.properties
cztheme   # Change ZSH theme

🧩 Dependencies

  • fzf, figlet, lolcat, boxes, gum, zsh, eza, bat, timg, logo-ls
  • Nerd Font: UbuntuMono
  • Custom figlet font: pixelfont.flf

🧙‍♂️ Advanced Configuration

Edit ~/.config/theader/theader.cfg to manually tweak:

logo=mylogo.txt
title=Tyro 2.0
indent=2
termux_properties=HASH
TNAME=yourname

🧼 Uninstall

To remove T-Header:

rm -rf ~/.config/theader
rm ~/.zshrc
chsh -s bash

💬 Credits

Created by remo7777
Inspired by Termux customization and ZSH theming.