termux-connecting 1.0.0

package/README.md

@@ -0,0 +1,125 @@
+# Termux Connecting
+
+CLI untuk setup Termux dan koneksi SSH dari PC/Mac — plus Telegram alert jika koneksi putus.
+
+## Tutorial Lengkap
+
+### 1. Install di Termux
+
+Jalankan di HP (Termux):
+
+```bash
+pkg install -y nodejs-lts
+npm i -g termux-connecting
+```
+
+Atau via curl installer (tanpa Node.js):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Ariska138/termux-connecting/main/install.sh | bash
+```
+
+### 2. Setup Perangkat Termux
+
+```bash
+termux-connecting
+```
+
+Script akan melakukan:
+1. `pkg update && pkg upgrade` — jika repo error, tawarkan ganti ke repo stable via `termux-change-repo`
+2. Cek Git & Node.js — tawarkan install jika belum ada
+3. Cek password SSH — jika belum, minta buat password baru via `passwd`
+4. Tampilkan **Username** dan **IP Address** perangkat
+
+Simpan info username dan IP yang muncul. Ini yang akan dipakai dari PC.
+
+> **Sebelum lanjut**: pastikan SSH server sudah jalan di Termux:
+> ```bash
+> sshd
+> ```
+> Cek IP kapan saja: `ip a | grep inet`
+
+### 3. Install & Koneksi dari PC/Mac
+
+Di komputer, install:
+
+```bash
+npm i -g termux-connecting
+```
+
+Lalu jalankan:
+
+```bash
+termux-connect-pc
+```
+
+Karena pertama kali, akan masuk ke menu **connection**:
+
+```
+Nama alias [termux-a8star]:
+Username [u0_a237]:
+IP Address [192.168.1.8]:
+```
+
+Isi dengan username dan IP yang ditampilkan di langkah 2.
+
+Script akan:
+- Cek koneksi (key-based dulu, fallback ke password)
+- Tawarkan buat SSH key agar koneksi tanpa password
+- Buat SSH config alias
+- **Hanya first run**: tawarkan setup **Telegram Alert**
+
+#### Telegram Alert (opsional, first run saja)
+
+```
+Ingin dapat notifikasi Telegram saat koneksi bermasalah? [y/N]: y
+Bot Token (dari @BotFather):
+Chat ID (atau username @username):
+```
+
+Cara dapat token:
+1. Buka Telegram, cari **@BotFather**
+2. Kirim `/newbot`, ikuti petunjuk
+3. Dapatkan token (format: `123456:ABC-DEF1234`)
+
+Chat ID bisa diisi username Anda (misal `@ariska138`).
+
+### 4. Cek Koneksi
+
+```bash
+termux-connect-pc check
+```
+
+Jika koneksi putus, script akan:
+1. Kirim notifikasi ke Telegram admin
+2. Tawarkan retry
+
+## Subcommand Reference
+
+```bash
+termux-connect-pc connection    # Setup/ubah koneksi
+termux-connect-pc check         # Cek koneksi & kirim alert
+termux-connect-pc help          # Bantuan
+termux-connect-pc version       # Versi
+```
+
+## Koneksi Manual via SSH
+
+Setelah setup, cukup:
+```bash
+ssh termux-a8star
+```
+
+Atau manual:
+```bash
+ssh -p 8022 u0_a237@192.168.1.8
+```
+
+## Dokumentasi Detail
+
+- [Architecture](docs/architecture.md) — System design, flow, timeout policy
+- [Troubleshooting](docs/troubleshooting.md) — Common issues & solutions
+
+## Lisensi
+
+MIT

package/bin/termux-connect-pc

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+set -e
+
+VERSION="1.0.0"
+CONFIG_DIR="$HOME/.config/termux-connecting"
+CONFIG_FILE="$CONFIG_DIR/config"
+SSH_PORT=8022
+SSH_KEY="$HOME/.ssh/id_ed25519"
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
+info()  { echo -e "${GREEN}[✓]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[!]${NC} $1"; }
+error() { echo -e "${RED}[✗]${NC} $1"; }
+title() { echo -e "\n${CYAN}━━━ $1 ━━━${NC}\n"; }
+
+prompt() {
+    local val default="$2"
+    echo -n "$1${default:+ [$default]}: "
+    read -r val
+    echo "${val:-$default}"
+}
+
+load_config() {
+    [ -f "$CONFIG_FILE" ] && source "$CONFIG_FILE"
+}
+
+save_config() {
+    mkdir -p "$CONFIG_DIR"
+    cat > "$CONFIG_FILE" << EOF
+HOST_ALIAS="$HOST_ALIAS"
+SSH_USER="$SSH_USER"
+SSH_HOST="$SSH_HOST"
+SSH_PORT=$SSH_PORT
+TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN"
+TELEGRAM_CHAT_ID="$TELEGRAM_CHAT_ID"
+EOF
+    chmod 600 "$CONFIG_FILE"
+}
+
+telegram_alert() {
+    local msg="$1"
+    if [ -n "$TELEGRAM_BOT_TOKEN" ] && [ -n "$TELEGRAM_CHAT_ID" ]; then
+        curl -s --connect-timeout 10 --max-time 15 \
+            "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+            -d "chat_id=${TELEGRAM_CHAT_ID}" \
+            -d "text=${msg}" >/dev/null
+    fi
+}
+
+# ─── COMMAND: connection ──────────────────────────────────────
+cmd_connection() {
+    load_config
+    title "TERMUX CONNECT — Connection Setup"
+
+    local first_run=false
+    if [ ! -f "$CONFIG_FILE" ]; then
+        first_run=true
+        echo "Pertama kali dijalankan. Setup koneksi ke Termux."
+        echo "------------------------------------------------"
+    fi
+
+    HOST_ALIAS=$(prompt "Nama alias" "${HOST_ALIAS:-termux-a8star}")
+    SSH_USER=$(prompt "Username" "${SSH_USER:-u0_a237}")
+    SSH_HOST=$(prompt "IP Address" "${SSH_HOST:-192.168.1.8}")
+
+    title "1. Cek Konektifitas"
+    echo "Mencoba ke ${SSH_USER}@${SSH_HOST}:${SSH_PORT}..."
+
+    local connected=false
+    if timeout 10 ssh -o ConnectTimeout=5 -o BatchMode=yes -p "$SSH_PORT" "${SSH_USER}@${SSH_HOST}" "echo connected"; then
+        info "Koneksi berhasil (key-based)"
+        connected=true
+    elif command -v sshpass; then
+        local pass
+        pass=$(prompt "Password SSH" "")
+        if timeout 10 sshpass -p "$pass" ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 -p "$SSH_PORT" "${SSH_USER}@${SSH_HOST}" "echo connected"; then
+            info "Koneksi berhasil (password)"
+            connected=true
+        fi
+    else
+        echo ""
+        warn "sshpass tidak terinstall. Konek manual dulu: ssh -p ${SSH_PORT} ${SSH_USER}@${SSH_HOST}"
+        echo -n "  Setelah berhasil, tekan enter untuk lanjut..."; read -r
+        if timeout 10 ssh -o ConnectTimeout=5 -o BatchMode=yes -p "$SSH_PORT" "${SSH_USER}@${SSH_HOST}" "echo connected"; then
+            connected=true
+        fi
+    fi
+
+    if ! $connected; then
+        error "Tidak bisa terhubung ke ${SSH_USER}@${SSH_HOST}:${SSH_PORT}"
+        echo "  Pastikan sshd sudah jalan di Termux dan satu jaringan."
+        return 1
+    fi
+
+    # SSH key
+    if [ ! -f "$SSH_KEY" ]; then
+        echo ""
+        echo -n "Buat SSH key biar tanpa password? [Y/n]: "
+        read -r mk
+        if [[ -z "$mk" || "$mk" =~ ^[Yy]$ ]]; then
+            ssh-keygen -t ed25519 -f "$SSH_KEY" -N "" -C "termux-connect"
+        fi
+    fi
+    if [ -f "$SSH_KEY" ]; then
+        timeout 15 ssh-copy-id -o StrictHostKeyChecking=no -o ConnectTimeout=10 -p "$SSH_PORT" "${SSH_USER}@${SSH_HOST}" 2>&1 || \
+            warn "Copy key gagal. Manual: ssh-copy-id -p ${SSH_PORT} ${SSH_USER}@${SSH_HOST}"
+    fi
+
+    # SSH config
+    mkdir -p "$HOME/.ssh"
+    if ! grep -q "Host $HOST_ALIAS$" "$HOME/.ssh/config" 2>/dev/null; then
+        cat >> "$HOME/.ssh/config" << EOF
+
+Host $HOST_ALIAS
+    HostName $SSH_HOST
+    User $SSH_USER
+    Port $SSH_PORT
+    StrictHostKeyChecking no
+    UserKnownHostsFile /dev/null
+EOF
+        chmod 600 "$HOME/.ssh/config"
+    fi
+    info "Koneksi siap: ssh $HOST_ALIAS"
+
+    # Telegram — hanya first run
+    if $first_run; then
+        title "2. Telegram Alert (opsional)"
+        echo "Ingin dapat notifikasi Telegram saat koneksi bermasalah?"
+        echo -n "Setup sekarang? [y/N]: "; read -r tk
+        if [[ "$tk" =~ ^[Yy]$ ]]; then
+            TELEGRAM_BOT_TOKEN=$(prompt "Bot Token (dari @BotFather)" "")
+            TELEGRAM_CHAT_ID=$(prompt "Chat ID (atau username @username)" "")
+            if [ -n "$TELEGRAM_BOT_TOKEN" ] && [ -n "$TELEGRAM_CHAT_ID" ]; then
+                telegram_alert "✅ *termux-connect-pc* — Admin tersimpan"
+                info "Telegram alert aktif"
+            else
+                warn "Lewati Telegram. Bisa diatur nanti dengan edit: $CONFIG_FILE"
+            fi
+        else
+            info "Telegram bisa diaktifkan nanti: $CONFIG_FILE"
+        fi
+    fi
+
+    save_config
+    echo ""
+    info "Setup selesai! Jalankan: termux-connect-pc check"
+}
+
+# ─── COMMAND: check ───────────────────────────────────────────
+cmd_check() {
+    load_config
+    if [ ! -f "$CONFIG_FILE" ]; then
+        warn "Belum ada konfigurasi. Jalankan dulu: termux-connect-pc connection"
+        return 1
+    fi
+
+    title "TERMUX CONNECT — Check"
+    echo "Memeriksa ${HOST_ALIAS} (${SSH_USER}@${SSH_HOST}:${SSH_PORT})..."
+    echo ""
+
+    local ok=false
+    if timeout 10 ssh -o ConnectTimeout=5 -o BatchMode=yes "$HOST_ALIAS" "echo connected"; then
+        info "Koneksi OK"
+        ok=true
+    else
+        error "Koneksi GAGAL"
+        telegram_alert "🚨 *Koneksi Termux PUTUS*%0AHost: ${HOST_ALIAS}%0AUser: ${SSH_USER}%0AIP: ${SSH_HOST}:${SSH_PORT}%0AWaktu: $(date)"
+        echo ""
+        warn "Notifikasi sudah dikirim ke Telegram admin"
+        echo ""
+        echo -n "Coba lagi? [y/N]: "; read -r retry
+        if [[ "$retry" =~ ^[Yy]$ ]]; then
+            cmd_check
+            return
+        fi
+    fi
+
+    if $ok; then
+        echo ""
+        info "Gunakan ssh $HOST_ALIAS untuk koneksi"
+        echo ""
+        echo -n "Cek lagi nanti secara berkala? (setup cron/dimonitor) [y/N]: "; read -r monitor
+        if [[ "$monitor" =~ ^[Yy]$ ]]; then
+            echo ""
+            echo "  Tambahkan ke crontab (crontab -e):"
+            echo "  */5 * * * * ${0} check"
+        fi
+    fi
+}
+
+# ─── COMMAND: help ────────────────────────────────────────────
+cmd_help() {
+    echo ""
+    echo "termux-connect-pc v${VERSION}"
+    echo "CLI koneksi Termux dari PC/Mac"
+    echo ""
+    echo "Penggunaan:"
+    echo "  termux-connect-pc connection    Setup koneksi ke Termux (hanya sekali)"
+    echo "  termux-connect-pc check         Cek status koneksi & kirim alert"
+    echo "  termux-connect-pc help          Tampilkan bantuan ini"
+    echo "  termux-connect-pc version       Tampilkan versi"
+    echo ""
+    echo "Telegram alert otomatis ke admin saat koneksi putus."
+    echo ""
+}
+
+# ─── COMMAND: version ─────────────────────────────────────────
+cmd_version() {
+    echo "termux-connect-pc v${VERSION}"
+}
+
+# ─── MAIN ─────────────────────────────────────────────────────
+main() {
+    case "${1:-}" in
+        connection) cmd_connection ;;
+        check)      cmd_check ;;
+        help|--help|-h) cmd_help ;;
+        version|--version|-v) cmd_version ;;
+        *)
+            if [ ! -f "$CONFIG_FILE" ]; then
+                echo "Pertama kali dijalankan! Setup koneksi dulu."
+                echo ""
+                cmd_connection
+            else
+                cmd_help
+            fi
+            ;;
+    esac
+}
+
+main "$@"

package/bin/termux-connecting

@@ -0,0 +1,90 @@
+#!/data/data/com.termux/files/usr/bin/bash
+
+set -e
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+info()  { echo -e "${GREEN}[✓]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[!]${NC} $1"; }
+error() { echo -e "${RED}[✗]${NC} $1"; }
+title() { echo -e "\n${CYAN}━━━ $1 ━━━${NC}\n"; }
+
+title "TERMUX CONNECTING — Setup"
+echo "Memeriksa dan mengkonfigurasi Termux..."
+echo "----------------------------------------"
+
+title "1. Update & Upgrade Paket"
+echo "Menjalankan pkg update && pkg upgrade..."
+if timeout 300 pkg update -y && timeout 300 pkg upgrade -y; then
+    info "Update & upgrade berhasil"
+else
+    warn "Gagal update/upgrade. Mungkin repo tidak stabil."
+    echo ""
+    echo "  Untuk mengganti ke repo stable, jalankan:"
+    echo "  termux-change-repo"
+    echo ""
+    echo -n "  Ingin ganti repo sekarang? [y/N]: "
+    read -r change_repo
+    if [[ "$change_repo" =~ ^[Yy]$ ]]; then
+        termux-change-repo
+        echo "  Ulangi update setelah selesai."
+    fi
+fi
+
+title "2. Cek Git & Node.js"
+for cmd in git node; do
+    if command -v "$cmd"; then
+        info "$cmd sudah terinstall ($($cmd --version || echo '?'))"
+    else
+        warn "$cmd belum terinstall."
+        echo -n "  Install $cmd sekarang? [Y/n]: "
+        read -r install_it
+        if [[ -z "$install_it" || "$install_it" =~ ^[Yy]$ ]]; then
+            pkg install -y "$cmd" && info "$cmd berhasil diinstall" || error "Gagal install $cmd"
+        else
+            warn "Lewati install $cmd"
+        fi
+    fi
+done
+
+title "3. Cek Password (passwd)"
+if [ -f "$HOME/.termux_authinfo" ] || passwd -S | grep -q "P"; then
+    info "Password sudah diatur"
+else
+    warn "Belum ada password. Setting password diperlukan untuk SSH."
+    echo ""
+    echo "  Masukkan password baru:"
+    if passwd; then
+        info "Password berhasil disimpan"
+    else
+        error "Gagal menyimpan password"
+    fi
+fi
+
+title "4. Informasi Koneksi"
+USERNAME=$(whoami)
+IP=$(ip -o -4 addr show | awk '{print $4}' | cut -d/ -f1 | grep -v 127.0.0.1 | head -n1)
+
+if [ -z "$IP" ]; then
+    IP="(tidak terdeteksi — pastikan WiFi/data aktif)"
+fi
+
+echo "  Username : $USERNAME"
+echo "  IP       : $IP"
+echo "  Port     : 8022"
+echo ""
+echo "  Untuk koneksi dari PC/Mac:"
+echo "  ssh -p 8022 ${USERNAME}@${IP}"
+echo ""
+warn "Pastikan HP dan PC terhubung ke jaringan WiFi YANG SAMA"
+echo ""
+echo "  Jika SSH server belum jalan:"
+echo "  sshd"
+echo ""
+
+echo "----------------------------------------"
+info "Setup selesai!"

package/install.sh

@@ -0,0 +1,44 @@
+#!/data/data/com.termux/files/usr/bin/bash
+#
+# termux-connecting — Installer via curl
+# Usage: curl -fsSL https://raw.githubusercontent.com/Ariska138/termux-connecting/main/install.sh | bash
+
+set -e
+
+REPO="https://github.com/Ariska138/termux-connecting"
+INSTALL_DIR="$HOME/.termux-connecting"
+BIN_DIR="$PREFIX/bin"
+
+echo "━━━ TERMUX CONNECTING — Installer ━━━"
+echo ""
+
+# Cek apakah di Termux
+if [ ! -d "$PREFIX" ]; then
+    echo "[✗] Script ini harus dijalankan di Termux."
+    exit 1
+fi
+
+# Cek & install git
+if ! command -v git; then
+    echo "[*] Git belum terinstall. Install dulu..."
+    pkg install -y git
+fi
+
+# Clone atau pull repo
+if [ -d "$INSTALL_DIR" ]; then
+    echo "[*] Update repo yang sudah ada..."
+    cd "$INSTALL_DIR" && git pull
+else
+    echo "[*] Clone repo..."
+    timeout 120 git clone --depth 1 "$REPO.git" "$INSTALL_DIR"
+fi
+
+# Buat symlink ke PATH
+ln -sf "$INSTALL_DIR/bin/termux-connecting" "$BIN_DIR/termux-connecting"
+chmod +x "$INSTALL_DIR/bin/termux-connecting"
+
+echo ""
+echo "[✓] Installasi selesai!"
+echo ""
+echo "  Jalankan: termux-connecting"
+echo ""

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "termux-connecting",
+  "version": "1.0.0",
+  "description": "CLI setup Termux + koneksi SSH dari PC/Mac dengan Telegram alert",
+  "bin": {
+    "termux-connecting": "./bin/termux-connecting",
+    "termux-connect-pc": "./bin/termux-connect-pc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ariska138/termux-connecting.git"
+  },
+  "keywords": ["termux", "android", "ssh", "setup", "terminal"],
+  "license": "MIT",
+  "author": "Ariska138",
+  "files": ["bin/", "install.sh", "README.md"],
+  "engines": {
+    "node": ">=12"
+  }
+}