Dorcci CLI

The ultimate terminal player, ASCII audio visualizer, synced lyrics, and system fetch engine for underground Persian artist Dorcci.

🚀 Quick Start (1-Click Run)

You can run dorcci-cli on any operating system (Windows, macOS, Linux) without downloading or cloning any files.

All you need is Node.js installed on your computer.

Step 1: Install Node.js

If you don't already have Node.js installed, download it from the official website: 👉 Download Node.js (It takes 1 minute to install. Use the recommended LTS version).

Step 2: Run Dorcci CLI

Open your Terminal (macOS/Linux) or Command Prompt/PowerShell (Windows), and simply type:

npx dorcci-cli

That's it! NPM will automatically fetch the latest version and run it instantly.

💻 Commands

If you want to run specific commands directly:

• npx dorcci-cli list - Browse the entire 30-track discography, search songs, view lyrics, and stream audio directly in the terminal.
• npx dorcci-cli fetch - Print a beautiful ASCII Neofetch-style system info card with Dorcci branding.
• npx dorcci-cli quote - Print a randomized iconic lyric/quote from Dorcci's catalog.
• npx dorcci-cli vibe - Jump straight into a random song and vibe.

(Pro Tip: If you want to use the commands without typing npx every time, install it globally using npm install -g dorcci-cli and then just type dorcci list).

🛠️ Features

• 30 Verified Tracks: The complete discography, including Broken, Ghatle Amd, Memphis, Pile, and more.
• Synced Lyrics: Watch the lyrics play in Finglish (Persian English) and translated English in real-time.
• Audio Streaming: Seamlessly streams MP3s from the cloud straight to your terminal.
• Cross-Platform: Works on Linux, Mac, and Windows natively.

🎵 Audio Requirements

This tool relies on your system's built-in audio players. It will work automatically on macOS (using afplay) and most Linux distros (using mplayer, mpg123, or aplay). On Windows, it uses a background script or mplayer if installed.

Created by Sam