DeckDroid

    ██████╗ ███████╗ ██████╗██╗  ██╗██████╗ ██████╗  ██████╗ ██╗██████╗ 
    ██╔══██╗██╔════╝██╔════╝██║ ██╔╝██╔══██╗██╔══██╗██╔═══██╗██║██╔══██╗
    ██║  ██║█████╗  ██║     █████╔╝ ██║  ██║██████╔╝██║   ██║██║██║  ██║
    ██║  ██║██╔══╝  ██║     ██╔═██╗ ██║  ██║██╔══██╗██║   ██║██║██║  ██║
    ██████╔╝███████╗╚██████╗██║  ██╗██████╔╝██║  ██║╚██████╔╝██║██████╔╝
    ╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝╚═════╝
    DeckDroid v1.1.0 — Any device. Any arch. One terminal.

Any device. Any architecture. One terminal.

DeckDroid is a whole-new "add-on", "wrapper" or what you call it (I learn from mistakes guys) that is designed for Android-based cyberdecks. DeckDroid comes with a bunch of handy tools (the list is below) and also comes with a w3m wrapper, (Don't worry guys XSS injection is for better use of w3m) custom profiles for different use cases and a lot of UI themes for you customizers. It's fully open-source, and I am looking forward for your reviews! And again, sorry for that "OS" issue I had with the old TermuxDeck "OS".

---

Quick Install

curl -sL https://nos-coding.github.io/deckdroid/install.sh | bash
zsh

First-Run Setup (Recommended)

Run decksetup to configure your cyberdeck:

decksetup

This wizard helps you set:

• Hostname — Your device name
• Profile — hacker / developer / writer / crypto / radio / iot
• Theme — cyberpunk / ghost / blood / nord / ocean / etc.
• Auto-update — Enable automatic update checks
• Additional packages — Install extra tools

---

Cyberdeck Tools

Command	Description
deckbat	Advanced battery metrics (temp, voltage, health, alerts)
deckping	Multi-layer connectivity audit (Gateway → DNS → Internet)
deckid	Deep device identity and network footprint
deckwifi	WiFi scanner with signal bars and security detection
decklocate	GPS + cell tower triangulation via Termux:API
deckclock	Multi-timezone world clock with NTP sync check
decksniff	tcpdump wrapper with preset capture profiles
decknote	Plain-text markdown notes system
deckbrowse	Universal terminal browser (w3m/lynx/browsh) with XSS injection fix
deckdisk	Disk management (list, mount, unmount, format)
decklog	Log viewer for DeckDroid logs
deckclean	Storage cleanup utility
deckupdate	Check & apply DeckDroid updates
decktheme	Theme manager (8 themes + 7 profile themes)
deckmenu	Interactive TUI launcher for all tools
deckhelp	Help utility with usage examples
decksetup	First-run setup wizard
deckai	AI launcher (interactive menu: opencode / gemini-cli)
tetris	Play Tetris game

Usage examples:

deckbat --json
deckping --host 8.8.8.8
deckwifi --json
decklocate --track 5
deckbrowse github
deckbrowse search termux
deckdisk list
decktheme list
decktheme set nord
decklog view tools
deckclean check
deckupdate check
tetris

---

Repository Tools

Command	Description
ddeckconf	Config manager (get/set/list/validate)
ddeckprof	Profile manager (set/unset/list profiles)
deckdroid-doctor	System health audit and repair
deckdroid-sync	Git-backed multi-device config sync
deckremove	Uninstall DeckDroid completely (with y/n confirmation)
deckdroid-web	Local web dashboard (localhost:8080)
deckdroid-plugin	Community plugin registry manager
deckdroid-vault	GPG encryption for sensitive config

Usage examples:

ddeckconf set theme.name ghost
ddeckconf list
ddeckconf validate
ddeckprof list
ddeckprof set hacker
ddeckprof status
deckdroid-doctor
deckdroid-web

# Uninstall from inside DeckDroid
deckremove

# Uninstall from pure Termux (without DeckDroid loaded)
bash -c 'curl -sL https://raw.githubusercontent.com/nOS-Coding/deckdroid/main/deckremove | bash'

---

Profile Management

Stackable environments tailored to your mission:

ddeckprof list              # Show available profiles
ddeckprof set writer        # Install + activate writer profile
ddeckprof set hacker        # Install + activate hacker profile
ddeckprof set developer     # Install + activate dev profile
ddeckprof set crypto        # Install + activate crypto profile
ddeckprof set radio         # Install + activate SDR profile
ddeckprof set iot           # Install + activate IoT profile
ddeckprof install-all       # Install everything
ddeckprof status            # Show active profiles

Profile	Packages
Hacker	nmap, tcpdump, netcat, tshark, whois, dnsutils
Developer	git, openssh, python, nodejs, nano
Writer	mdcat, pandoc
Crypto	gnupg, openssl
Radio	rtl-sdr, sox, multimon-ng
IoT	python, mosquitto-clients

---

Themes

Visual Themes (8)

decktheme list
decktheme set <name>

Theme	Description
cyberpunk	Green/cyan, matrix-style (default)
ghost	White/grey, minimal
blood	Deep red, aggressive
matrix	Classic green terminal
nord	Arctic blue
dracula	Purple/vampire
monokai	Pink/yellow contrast
ocean	Deep blue

Profile Themes (7)

Auto-match your active profile:

Theme	Matches Profile	Style
hacker	hacker	Matrix/green
developer	developer	Clean blue
writer	writer	Minimal purple
crypto	crypto	Dark purple
radio	radio	Navy/signal
hamradio	hamradio	Navy/signal
iot	iot	Circuit cyan

# Set visual theme
decktheme set ocean

# Set profile theme (auto-matches active profile)
decktheme set hacker

---

Configuration

All settings stored in ~/.deckdroid/config.json:

ddeckconf set hostname mydroid
ddeckconf set theme.name blood
ddeckconf get version
ddeckconf list

---

Architecture Support

Runs on all Termux-supported architectures:

• ARM64 (aarch64)
• ARM32 (armv7)
• x86_64
• x86

---

Changelog

v1.1.0

Release Date: 2026-05-04

Rebranded: TermuxDeck OS → DeckDroid

• All config paths moved from ~/.termuxdeck/ to ~/.deckdroid/
• All termuxdeck-* repo tools renamed to deckdroid-*
• Install script updated for new repo: nos-coding.github.io/deckdroid
• ASCII logo updated to spell DECKDROID
• Environment variable renamed TDECK_HOME → DDROID_HOME

New Features

• New Boot Experience — Custom ASCII logo + profile-specific quotes, one-liner system info
• Interactive Launcher — deckmenu — TUI menu to browse and launch all tools
• Theme System — 8 visual themes + 7 profile themes with automatic switching
• Profile Quotes — Each profile has unique philosophic quotes shown at boot

New Tools

• deckhelp — Unified help system with usage examples for all tools
• deckmenu — Interactive TUI launcher (number/letter selection)
• decklog — Log viewer for DeckDroid logs
• deckclean — Storage cleanup utility
• deckupdate — Check for updates
• decktheme — Theme manager (visual + profile themes)
• deckdisk — Disk management (list, mount, unmount, format)
• ddeckprof — Profile manager (install/set/unset profiles)

Improvements

• All deck tools now support --json and --log flags
• deckbrowse now works without URL input (defaults to Google)
• deckai supports opencode & gemini-cli with interactive install
• ddeckconf updated with full dot-notation support
• Boot script colored by active theme, shows battery status

Bug Fixes

• Fixed missing .zshrc in repo (now deployed on install)
• Fixed deckbrowse missing from installer list
• Fixed repo URL to use GitHub Pages format
• Fixed ddeckconf reset referencing non-existent flag

Files Added

• .zshrc — Base shell configuration with zinit plugins
• themes/*.toml — 8 visual themes + 7 profile themes
• themes/*.quotes — Profile-specific philosophic quotes (10 per profile)

First-Run Setup

• decksetup — Interactive first-run wizard:
  • Hostname, Profile, Theme, Auto-update, Additional packages

Auto-Update System

• deckupdate auto on — Enable automatic update checks on shell start
• deckupdate auto off — Disable auto-updates
• deckupdate check — Manual version check
• deckupdate upgrade — Force upgrade to latest version

---

Contributing

• No CLA required
• MIT Licensed
• Headless philosophy is mandatory

---

DeckDroid — Any device. Any arch. One terminal.