▲reactivite
/packages/docs/courses/cli/skillpool/promaster/contact
all docs

$ npm view @ubuligan/cli-player

CLI

@ubuligan/cli-player

Matrix-style terminal music player — scans your drives for music and plays it through mpv, all from an Ink TUI.

npm versiondownloads
npm github
$ npm install @ubuligan/cli-player

By Javid Salimov#

█  █  ████   █  █  █      █████   ████   ███   █   █
█  █  █   █  █  █  █        █    █      █   █  ██  █
█  █  ████   █  █  █        █    █  ██  █████  █ █ █
█  █  █   █  █  █  █        █    █   █  █   █  █  ██
█  █  █   █  █  █  █        █    █   █  █   █  █   █
 ██   ████    ██   █████  █████   ████  █   █  █   █

Matrix-style terminal music player. Ink (React for CLI) ilə qurulub. Bütün disklərinizdəki musiqini tapır, keşləyir, terminaldan idarə etməyə imkan verir.

Xüsusiyyətlər#

  • Bütün qoşulmuş disklərdə musiqi fayllarını rekursiv skan edir (.mp3 .flac .wav .ogg .m4a .aac .wma .opus)
  • Nəticələr ~/.cli-player/index.json-da keşlənir — sonrakı açılışlar sürətli olur
  • Səhifələnmiş (paginated) trek siyahısı, canlı axtarış
  • Play / Pause / Resume / Stop / Next / Prev
  • Volume up/down
  • Shuffle
  • Playlist yaratmaq, saxlamaq, yükləmək, silmək
  • Matrix-style yaşıl UI, animasiyalı "rain" effekti

Tələblər#

  • Node.js ≥ 18
  • mpv PATH-da quraşdırılmış olmalıdır (audio backend):
    • Windows: scoop install mpv və ya choco install mpv
    • macOS: brew install mpv
    • Linux: sudo apt install mpv (və ya paket meneceriniz)

Quraşdırma#

Publish olunduqdan sonra:

npm install -g cli-player
cli-player

Lokal inkişaf üçün:

git clone <repo>
cd cli-player
npm install
npm run dev

Skriptlər#

KomandaNə edir
npm run devtsx ilə birbaşa run (TypeScript, build lazım deyil)
npm run builddist/-ə compile edir (tsc)
npm startcompile olunmuş versiyanı run edir (node dist/index.js)
npm run typechecktip yoxlaması, build etmədən

CLI seçim: cli-player --clear-cache — keşlənmiş fayl indeksini sıfırlayıb yenidən tam skan edir.

Klaviatura idarəetməsi#

DüyməƏməliyyat
↑ ↓Siyahıda naviqasiya
← →Səhifə arası
EnterSeçilmiş trekı çal
SpacePause / Resume
n / pNext / Previous
+ / -Volume up / down
sShuffle aç/bağla
aSeçilmiş trekı cari playlist-ə əlavə et
Ctrl+SCari playlist-i adla saxla
TabKitabxana ↔ Playlistlər ekranı
/Axtarış
rYenidən skan et
qÇıxış

Memarlıq#

Ətraflı memarlıq qeydləri plan.md və CLAUDE.md fayllarında.

Qısaca: src/core/ — UI-dan asılı olmayan biznes məntiqi (scanner, mpv IPC, playlist, keş). src/state/usePlayerStore.ts — React Context vasitəsilə core-u UI-a bağlayır. src/components/ — Ink UI. Audio backend AudioEngine interfeysi arxasında gizlədilib (src/core/audioEngine.ts), hazırkı implementasiya MpvEngine.

Nəşr etmək (npm publish)#

npm run build
npm login
npm publish

package.json-da name sahəsini npm-də mövcud olmayan unikal ada dəyişdirməyi unutmayın.

Bilinən məhdudiyyətlər#

  • mpv PATH-da olmalıdır, əks halda proqram aydın xəta mesajı göstərir.
  • İlk açılışda tam disk skanı vaxt apara bilər; nəticə keşlənir.
  • İnteraktiv terminal (TTY) tələb olunur — pipe/redirect edilmiş şəraitdə işləmir.
  • home
  • packages
  • skillpool
  • docs
  • cli
▲reactivite

// The fastest way to scaffold production-ready React apps. Built by developers, for developers.

$ npm create reactivite@latest

resources/

  • └─ documentation
  • └─ packages
  • └─ cli
  • └─ courses
  • └─ markdown
  • └─ diff
  • └─ run
  • └─ radio
  • └─ tv
  • └─ games
  • └─ about
  • └─ contact

community/

  • └─ github

© 2026 reactivite — all rights reserved