Tidal

tidal-cli

Hakkında

tidal-cli, Tidal API v2'yi tek bir komut satırı aracına dönüştürür. Kataloğu arayın, çalma listelerini yönetin, sanatçıları keşfedin, parçaları çalın ve kitaplığınızı yönetin — hepsi bir tarayıcı açmadan. Her komut --json çıktısını destekler, bu da onu OpenClaw aracılığıyla LLM ajan otomasyonunun bel kemiği haline getirir.

Özellikler

• Arama — sanatçılar, albümler, parçalar, videolar, çalma listeleri ve otomatik tamamlama önerileri
• Sanatçılar — bilgi, en iyi parçalar, diskografi, benzer sanatçılar, radyo
• Albümler — detaylar, barkod sorgulama
• Parçalar — bilgi, benzer parçalar, ISRC sorgulama, radyo
• Çalma Listeleri — tam CRUD, parça ekleme/çıkarma, yeniden sıralama, tüm albümleri ekleme
• Kitaplık — sanatçılar, albümler, parçalar, videolar, çalma listeleri için favoriler
• Oynatma — akış bilgisi, doğrudan URL'ler, DASH ile yerel oynatma
• Öneriler — kişiselleştirilmiş karışımlar (Günlük, Keşif, Yeni Çıkanlar, Çevrimdışı) ve karışım öğelerine detaylı inceleme
• Geçmiş — yakın zamanda eklenen parçalar, albümler, sanatçılar; arama geçmişi (listeleme, silme, temizleme)
• Sonraya Kaydet — ana kitaplığınızdan ayrı bir kuyrukta öğeleri yer imlerine ekleyin
• Paylaşım — parçalar ve albümler için genel paylaşım bağlantıları oluşturun
• JSON çıktısı — betikleme ve ajan kullanımı için her komutta

Kurulum

npm install -g @lucaperret/tidal-cli

Gereksinimler

• Node.js >= 20
• Bir Tidal hesabı

Hızlı Başlangıç

# Sign in once — opens your browser
tidal-cli auth

# Search for a track
tidal-cli search track "Around the World"

# Get artist details
tidal-cli artist info 8992

# Play a track
tidal-cli playback play 5756235

Kullanım

Arama

tidal-cli search artist "Gorillaz"
tidal-cli search album "Mezzanine"
tidal-cli search track "Teardrop"
tidal-cli search video "Stylo"
tidal-cli search playlist "Electronic"
tidal-cli search suggest "daft punk"
tidal-cli search editorial "indie rock"

Sanatçı

tidal-cli artist info <id>
tidal-cli artist tracks <id>
tidal-cli artist albums <id>
tidal-cli artist similar <id>
tidal-cli artist radio <id>

Albüm ve Parça

tidal-cli album info <id>
tidal-cli album barcode <ean>
tidal-cli track info <id>
tidal-cli track similar <id>
tidal-cli track isrc <isrc>
tidal-cli track radio <id>

Çalma Listeleri

tidal-cli playlist list
tidal-cli playlist create --name "Late Night Electronic"
tidal-cli playlist add-track --playlist-id <id> --track-id <id>
tidal-cli playlist add-album --playlist-id <id> --album-id <id>
tidal-cli playlist remove-track --playlist-id <id> --track-id <id>
tidal-cli playlist move-track --playlist-id <id> --track-id <id> --before <itemId>
tidal-cli playlist rename --playlist-id <id> --name "New Name"
tidal-cli playlist set-description --playlist-id <id> --desc "Updated description"
tidal-cli playlist delete --playlist-id <id>

Kitaplık

tidal-cli library add --track-id <id>
tidal-cli library add --artist-id <id>
tidal-cli library add --album-id <id>
tidal-cli library add --video-id <id>
tidal-cli library remove --track-id <id>
tidal-cli library favorite-playlists
tidal-cli library add-playlist --playlist-id <id>
tidal-cli library remove-playlist --playlist-id <id>

Keşif ve Geçmiş

tidal-cli recommend                              # all mix categories
tidal-cli recommend --type daily                 # daily | discovery | new-release | offline
tidal-cli mix items <mix-id> --type daily        # tracks inside a specific mix
tidal-cli history tracks
tidal-cli history albums
tidal-cli history artists
tidal-cli search history                         # your recent searches
tidal-cli search history-delete <entry-id>
tidal-cli search history-clear
tidal-cli user profile

Sonraya Kaydet ve Paylaşım

tidal-cli saved list
tidal-cli saved add --type tracks --id <id>      # tracks | albums | artists | playlists | videos
tidal-cli saved remove --type albums --id <id>
tidal-cli share track <id>                       # creates a public share link
tidal-cli share album <id>

Oynatma

tidal-cli playback play <id>
tidal-cli playback play <id> --quality LOSSLESS
tidal-cli playback info <id>
tidal-cli playback url <id>

Kalite seçenekleri: LOW, HIGH, LOSSLESS, HI_RES.

JSON Çıktısı

Herhangi bir alt komuttan önce --json ekleyin:

tidal-cli --json search track "Around the World"
tidal-cli --json playlist list
tidal-cli --json artist similar 8992

MCP Sunucusu (Claude Entegrasyonu)

tidal-cli, Claude Desktop, Smithery ve MCP uyumlu tüm istemciler için uzak bir MCP sunucusu olarak kullanılabilir.

Claude Desktop'ta Bağlanın:

1. Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle
2. Girin: https://tidal-cli.lucaperret.ch/api/mcp
3. "Bağlan"a tıklayın → Tidal'a giriş yapın → tamam

OAuth kimlik doğrulaması, güvenlik açıklamaları ve 3 bilgi istemi şablonu ile 40 araç.

Ajan Otomasyonu

tidal-cli ayrıca ClawHub üzerinde bir OpenClaw becerisi olarak mevcuttur. Yapay zeka ajanınız için yükleyin:

clawhub install tidal-cli

tidal-cli auth işleminden sonra, ajanlar otomatik yenilenen belirteçlerle etkileşimsiz olarak komut çalıştırabilir.

Yapay zeka ajanınız için örnek bilgi istemleri

• "Daft Punk'ın Discovery albümündeki en iyi parçalarla bir çalma listesi oluştur"
• "Massive Attack'e benzer sanatçılar bul ve en iyi parçalarını kitaplığıma ekle"
• "Çalma listelerim neler? Yeni LCD Soundsystem albümünü ilkine ekle"
• "Bana Boards of Canada'dan bir şeyler çal"
• "The Strokes, Arctic Monkeys ve Interpol ile bir 2000'ler indie rock çalma listesi oluştur"

Betikleme desenleri

# Search then act
TRACK=$(tidal-cli --json search track "Around the World" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

# Discovery: artist → similar → top tracks → playlist
ARTIST=$(tidal-cli --json search artist "Boards of Canada" | jq -r '.[0].id')
SIMILAR=$(tidal-cli --json artist similar "$ARTIST" | jq -r '.[0].id')
TRACK=$(tidal-cli --json artist tracks "$SIMILAR" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

Geliştirme

git clone https://github.com/lucaperret/tidal-cli.git
cd tidal-cli
npm install
npm run build
npm test

Testleri Çalıştırma

npm test           # run once
npm run test:watch # watch mode

Arama, çalma listeleri, sanatçılar, parçalar, albümler, kitaplık, öneriler, karışımlar, sonraya kaydetme, paylaşım, arama geçmişi, kimlik doğrulama ve oturumu kapsayan 143 test.

Lisans

tidal-cli MIT Lisansı altında lisanslanmıştır. Ayrıntılar için LICENSE dosyasına bakın.