⚡ Yamdut CLI — The Autonomous Terminal Power Tools

Crafted with ❤️ by Yamraj (Kartik)
High-performance terminal environment featuring a native terminal music player with auto-queue, 320kbps audio grabber, instant port-killing, zero-config public tunneling, client-side zero-knowledge encrypted drops, and media extraction.

🚀 Quick Start (Zero Installation Needed!)

Run Yamdut instantly anywhere using npx:

# Start interactive shell
npx yamdut

# Stream music in terminal with auto-queue:
npx yamdut play "Arijit Singh Kesariya"

# Download 320kbps master audio track:
npx yamdut mp3 "Choo Lo The Local Train"

# Kill hanging ports:
npx yamdut kill 3000

# Expose localhost to public HTTPS:
npx yamdut live 5000

# Encrypted self-destruct file sharing:
npx yamdut drop secret.zip

# Download & decrypt Yamdut Drops:
npx yamdut get "<url>"

Or install it globally:

npm install -g yamdut
yamdut

⚡ Superpowers & Features

1. 🎵 yamdut play <song> (Terminal Music Radio & Auto-Queue)

Play millions of high-definition songs directly inside your terminal:

yamdut play "Arijit Singh Kesariya"
# or
yamdut play "lofi hip hop beats"

• Searches millions of tracks and streams 320kbps high-fidelity audio.
• Auto-Queue: Automatically transitions to the next song when a track ends.
• Interactive controls: Press [s] to skip to the next song, [q] to quit.

2. 🎧 yamdut mp3 <song> (320kbps Audio Downloader)

Download original 320kbps audio files directly into your current directory:

yamdut mp3 "Choo Lo The Local Train"

• Direct CDN stream downloader with crystal clear sound quality.
• Automatically formats and names the file (Song - Artist.m4a).

3. 💀 yamdut kill <port> (Port & Ghost Process Reaper)

Instant cross-platform process termination for hanging ports:

yamdut kill 3000

• Scans network table for any process holding the port.
• Identifies process name (e.g. node.exe, python, java).
• Terminates it with extreme prejudice and frees the port in under 1 second.

4. 🌐 yamdut live <port> (Instant Public HTTPS Tunnel)

Expose any local web server to the public internet with zero setup:

yamdut live 5000

• Zero account, zero token, zero configuration needed.
• Generates a secure, public https://... link with TLS termination.
• Perfect for mobile testing, webhooks, or sharing prototypes with friends.

5. 📦 yamdut drop <file> (Zero-Knowledge Self-Destruct File Sharing)

Share confidential files with strict client-side encryption:

yamdut drop my-confidential-document.pdf

• Encrypted locally with AES-256-GCM before leaving your machine.
• Generates a secret self-destructing link (#key=...).
• The server never sees the plaintext or the decryption key.
• Automatically expires in 60 minutes.

6. 🎬 yamdut get <url> (Universal Downloader & Decryptor)

Download media streams or decrypt Yamdut drop links:

# Decrypt a Yamdut Drop link
yamdut get "https://tmpfiles.org/...#key=..."

# Download remote video/audio/files
yamdut get "https://example.com/video.mp4"

📜 License

MIT © Yamraj (Kartik)