• About TDOC
• Features
• Installation
• Commands
• Repository Code Scanner
• Internationalization
• Plugin System
• Security Model
• Contributing
• License
• Contact

TDOC (Termux Doctor) is a powerful CLI tool to diagnose, fix, and manage your Termux environment.
It is designed for:

• Detecting broken packages, storage, repository settings, and more
• Automatic or interactive fixes with user confirmation
• Generating JSON reports and live system monitoring
• Scanning project repositories for bugs, syntax errors, and misconfigurations
• Full internationalization support (English & Bahasa Indonesia)
• Professional UX with colors, icons, and spinners

TDOC is lightweight, open-source, and optimized for Termux users and developers.

• ✅ System scan (storage, repositories, Python, NodeJS, Git, etc.)
• ✅ Repository code scan — bugs, syntax errors, tracebacks across all languages (tdoc repo-scan)
• ✅ Auto code scan when running tdoc scan inside a project folder
• ✅ Manual / automatic fixes (tdoc fix, tdoc fix --auto)
• ✅ Fix preview / dry-run before applying (tdoc fix --preview)
• ✅ Interactive fix for Python and Git (previously skipped silently)
• ✅ Ad-hoc package check (tdoc check <package>)
• ✅ Operation history viewer (tdoc history)
• ✅ Live continuous monitoring (tdoc doctor --live)
• ✅ Storage, network & CPU benchmark (tdoc benchmark)
• ✅ Status reports (tdoc status, tdoc report)
• ✅ Doctor JSON output (tdoc doctor --json, tdoc doctor --json-ai)
• ✅ Repository security scan (tdoc security, tdoc security --json)
• ✅ Internationalization — English & Bahasa Indonesia (tdoc lang set id)
• ✅ Plugin system — drop .sh files in modules/ to add custom checks
• ✅ Professional CLI UX (colors, icons, spinners)

pkg update && pkg upgrade
pkg install git curl tar

git clone https://github.com/djunekz/tdoc
cd tdoc
bash install.sh

The installer copies TDOC to $PREFIX/lib/tdoc and creates a symlink at $PREFIX/bin/tdoc.

tdoc repo-scan scans your entire project directory for bugs, syntax errors, deprecated patterns, and traceback logs — without needing any external linters installed.

TDOC automatically detects whether you are inside a project folder by looking for common markers (.git, Dockerfile, package.json, Cargo.toml, setup.py, pyproject.toml, requirements.txt, Makefile, docker-compose.yml, .github, go.mod, composer.json).

• Inside a project folder — scans the current directory tree
• Outside a project / at $HOME — scans $HOME
• Running tdoc scan — if a project marker is found, the code scan runs automatically after the system scan

# Scan the project you are currently in
cd ~/projects/my-app
tdoc repo-scan

# Or just run the normal scan — code scan fires automatically
tdoc scan

When scanning .github/workflows/*.yml, TDOC additionally checks for:

• Missing on: trigger or jobs: block
• Deprecated set-output command (use $GITHUB_OUTPUT instead)
• Deprecated save-state command (use $GITHUB_STATE instead)
• Unpinned actions/checkout (no version tag)

TDOC supports multiple display languages. Language is auto-detected from your system $LANG variable, or can be set manually.

# Set permanently
tdoc lang set id     # Bahasa Indonesia
tdoc lang set en     # English

# One-shot override (not saved)
tdoc --lang id scan

# Via environment variable
TDOC_LANG=id tdoc fix --auto

# Check current language
tdoc lang list

Language files are located in lang/. To add a new language, copy lang/en.sh, translate the values, and run tdoc lang set <code>.

TDOC auto-loads any .sh file placed in the modules/ directory. If a function named check_<filename>() is defined inside, it will be called automatically during tdoc scan.

# Example: modules/ruby.sh
check_ruby() {
  if command -v ruby >/dev/null 2>&1; then
    echo "Ruby=OK" >> "$STATE_FILE"
    print_ok "Ruby"
  else
    echo "Ruby=BROKEN" >> "$STATE_FILE"
    print_err "Ruby"
  fi
}

No changes to core files needed.

TDOC is designed to be safe by default:

• No root access required
• No background services or daemons
• No telemetry or network calls during scan
• No package installation or removal without explicit user confirmation
• Repository verification uses official Termux mechanisms only

TDOC does not modify system state unless explicitly instructed by the user.

Please report security issues privately as described in SECURITY. Do not post exploits publicly.

We welcome contributions! Please read CONTRIBUTING and CODE_OF_CONDUCT before submitting PRs or issues.

• Fork the repository
• Create a descriptive branch name
• Submit a PR with a detailed description
• Follow the existing coding style and versioning conventions

TDOC is licensed under the MIT License.

For commercial or proprietary use, a separate commercial license is available.
See COMMERCIAL_LICENSE.

TDOC Project Team

• 📧 Contact Support
• 🌐 GitHub: TDOC - Termux Doctor

• About TDOC
• Features
• Installation
• Commands
• Internationalization
• Plugin System
• Security Model
• Contributing
• License
• Contact

TDOC (Termux Doctor) is a powerful CLI tool to diagnose, fix, and manage your Termux environment.
It is designed for:

• Detecting broken packages, storage, repository settings, and more
• Automatic or interactive fixes with user confirmation
• Generating JSON reports and live system monitoring
• Full internationalization support (English & Bahasa Indonesia)
• Professional UX with colors, icons, and spinners

TDOC is lightweight, open-source, and optimized for Termux users and developers.

• ✅ System scan (storage, repositories, Python, NodeJS, Git, etc.)
• ✅ Manual / automatic fixes (tdoc fix, tdoc fix --auto)
• ✅ Fix preview / dry-run before applying (tdoc fix --preview)
• ✅ Interactive fix for Python and Git (previously skipped silently)
• ✅ Ad-hoc package check (tdoc check <package>)
• ✅ Operation history viewer (tdoc history)
• ✅ Live continuous monitoring (tdoc doctor --live)
• ✅ Storage, network & CPU benchmark (tdoc benchmark)
• ✅ Status reports (tdoc status, tdoc report)
• ✅ Doctor JSON output (tdoc doctor --json, tdoc doctor --json-ai)
• ✅ Repository security scan (tdoc security, tdoc security --json)
• ✅ Internationalization — English & Bahasa Indonesia (tdoc lang set id)
• ✅ Plugin system — drop .sh files in modules/ to add custom checks
• ✅ Professional CLI UX (colors, icons, spinners)

pkg update && pkg upgrade
pkg install git curl tar

git clone https://github.com/djunekz/tdoc
cd tdoc
bash install.sh

The installer copies TDOC to $PREFIX/lib/tdoc and creates a symlink at $PREFIX/bin/tdoc.

TDOC supports multiple display languages. Language is auto-detected from your system $LANG variable, or can be set manually.

# Set permanently
tdoc lang set id     # Bahasa Indonesia
tdoc lang set en     # English

# One-shot override (not saved)
tdoc --lang id scan

# Via environment variable
TDOC_LANG=id tdoc fix --auto

# Check current language
tdoc lang list

Language files are located in lang/. To add a new language, copy lang/en.sh, translate the values, and run tdoc lang set <code>.

TDOC auto-loads any .sh file placed in the modules/ directory. If a function named check_<filename>() is defined inside, it will be called automatically during tdoc scan.

# Example: modules/ruby.sh
check_ruby() {
  if command -v ruby >/dev/null 2>&1; then
    echo "Ruby=OK" >> "$STATE_FILE"
    print_ok "Ruby"
  else
    echo "Ruby=BROKEN" >> "$STATE_FILE"
    print_err "Ruby"
  fi
}

No changes to core files needed.

TDOC is designed to be safe by default:

• No root access required
• No background services or daemons
• No telemetry or network calls during scan
• No package installation or removal without explicit user confirmation
• Repository verification uses official Termux mechanisms only

TDOC does not modify system state unless explicitly instructed by the user.

Please report security issues privately as described in SECURITY. Do not post exploits publicly.

We welcome contributions! Please read CONTRIBUTING and CODE_OF_CONDUCT before submitting PRs or issues.

• Fork the repository
• Create a descriptive branch name
• Submit a PR with a detailed description
• Follow the existing coding style and versioning conventions

TDOC is licensed under the MIT License.

For commercial or proprietary use, a separate commercial license is available.
See COMMERCIAL_LICENSE.

TDOC Project Team

• 📧 Contact Support
• 🌐 GitHub: TDOC - Termux Doctor