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 todeckdroid-* - 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 toolsdeckmenu— Interactive TUI launcher (number/letter selection)decklog— Log viewer for DeckDroid logsdeckclean— Storage cleanup utilitydeckupdate— Check for updatesdecktheme— 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
--jsonand--logflags deckbrowsenow works without URL input (defaults to Google)deckaisupports opencode & gemini-cli with interactive installddeckconfupdated with full dot-notation support- Boot script colored by active theme, shows battery status
Bug Fixes
- Fixed missing
.zshrcin repo (now deployed on install) - Fixed
deckbrowsemissing from installer list - Fixed repo URL to use GitHub Pages format
- Fixed
ddeckconf resetreferencing non-existent flag
Files Added
.zshrc— Base shell configuration with zinit pluginsthemes/*.toml— 8 visual themes + 7 profile themesthemes/*.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 startdeckupdate auto off— Disable auto-updatesdeckupdate check— Manual version checkdeckupdate upgrade— Force upgrade to latest version
Contributing
- No CLA required
- MIT Licensed
- Headless philosophy is mandatory
DeckDroid — Any device. Any arch. One terminal.