İçe aktarma boru hattı

İçe aktarma, dosyaların bir baytını değiştirmeden bir dosya klasörünü katalog girişine dönüştürür. Bu sayfa, kılavuzu kullanın’de açıklanan akışın ardındaki kanaldır.

Tarama

İzlenen klasörler platformun dosya sistemi olaylarıyla izlenir, olaylar sakinleştirilir ve değişiklikte yeniden taranır; taramalar baştan başlamak yerine mevcut aday listesiyle uzlaştırılır. Tarayıcı bir klasörü tek sürüm olarak sınıflandırır (ses doğrudan içindeyse veya CD1/CD2 gibi disk biçimli alt klasörler varsa) ya da koleksiyon olarak içine iner. Dosyalar uzantıya göre ses, görsel ve belge olarak sınıflandırılır; sonra ses yoklanır: önemli olan codec, dosya uzantısı değil FFmpeg’in baytlarda bulduğudur. Kısmi indirme işaretleri içeren klasörler indirme bitene kadar dışarıda bırakılır.

Bir CUE sayfası tek bir ses imajını parça listesine dönüştürür. Ayrıştırıcı pregap’leri ve postgap’leri, parça başına performers ve ISRC’leri, hem tek dosyalı imajları hem de parça başına tek dosya CUE yerleşimlerini işler. Parça sınırları CUE frame’lerinden (saniyenin 1/75’i) kesin örnek konumlarına dönüştürülür; bunlar daha sonra çalmanın kullandığı bayt ve örnek pencereleri olur.

Meta veri taslakları

Her aday bir düzenlenebilir meta veri taslağı ve seçenek kaynağı depolar. Taslak boş, doğrudan doldurulmuş, dış bir yayından doldurulmuş veya depolanan bir dosya-etiket snapshot’undan doldurulmuş olabilir. Kaynak kayıtları mevcut taslağın başladığı yerdedir; daha sonraki düzenlemeler onu silmez. Doğrudan giriş ve temizlenmiş bir taslak kaynağı yoktur.

Üst meta veri slotu ya taslağı, Çevrimiçi bul tarayıcısını ya da Dosya etiketleri tarayıcısını gösterir. Bir tarayıcıyı açmak veya kapatmak taslağı yeniden yazmaz. Uygula bir kaynağı değiştirmek, dosya rollerini, CUE bağlantılarını, disk görevlendirmelerini ve diğer haritalama kararlarını korurken tek bir veritabanı işleminde taslağı, kaynakını ve seçilen kaynak kapağını değiştirir.

Çevrimiçi bul

Çevrimiçi bul tanımlamayı yürüten tek yoldur. Bir kopyalama log’undan veya CUE sayfasından bir Disc ID hesaplar, OCR ile barkodları ve katalog metnini tanır, MusicBrainz ve Discogs sorgular ve sonuçları eşleştirir. Entegre ses etiketleri çevrimiçi tanımlama kanıtı değildir.

Varsayılan meta veri kaynağı ayarının üç değeri vardır. Yok boş bir taslak oluşturur ve meta veri çalışması başlatmaz. Dosya etiketleri etiket anlık görüntüsünü okur ve uygular. Çevrimiçi bul çevrimiçi iş akışını açar. Varsayılan Çevrimiçi bul modu, kanıt çıkarma, sağlayıcı sorguları ve eşleştirmeyi kuyruğa alan Otomatik ya da tanımlama başlatmayan Elle ara seçeneğini kullanır. Çevrimiçi bul her aday için seçilen modu kullanır; Otomatik etkin veya tamamlanmış bir çalışmayı yeniden başlatmaz.

Dosya etiketleri

Dosya etiketleri yeni keşfedilen bir aday için varsayılan olarak ayarlanmış olmadıkça, entegre ses etiketlerini ve CUE meta verilerini tembelce okur. Önizleme, adayın tarama üretimi, dosya-düzenleme revizyonu ve gözlemlenen ses dosyalarıyla damgalanmış bir snapshot depolar. Uygula onu değiştirerek tam olarak o snapshot’tan taslağı değiştirir. İthalat aynı snapshot’u kullanır ve damgası veya gözlemleri değiştiğinde kütüphane yazmadan önce başarısız olur; farklı bir cevap okumaz.

Doğrudan giriş meta veri I/O yapmaz. Boş taslağın serbest bırakma ve izleme alanları derhal düzenlenebilir ve gerekli alanlar ve haritalar doğrulandıktan sonra ithal edilebilir olur. Aday listesi eksik kaynakları bir hata veya dikkat talebi olarak değerlendirmez.

Kaynaklar

MusicBrainz anonim olarak, saniyede bir istek temposuyla sorgulanır. Discogs, kullanıcının keyring’deki kişisel token’ıyla kimlik doğrular; hız sınırları içinde aralıklı gönderilir ve yeniden denenir. Reddedilen token bu şekilde bildirilir, böylece UI aramaları sessizce başarısız kılmak yerine işaretleyebilir. Yanıtlar oturum başına önbelleğe alınır. Bir yayın seçildiğinde, bae’nin belgelerinden kullandığı şeyler — albüm ve baskı bilgileri, katkılar ve eserlerle birlikte tam parça listesi, kapak seçenekleri ve diğer kataloglarda nasıl anıldığı — bir kez veritabanına çıkarılır; ham JSON saklanmaz.

Kayıt

Bir içe aktarmayı onaylamak sırayla şunları çalıştırır:

1. Decode verification: her parça baştan sona çözülür; bütünüyle çözülemeyen rip, herhangi bir şey yazılmadan önce içe aktarmayı başarısız kılar.
2. Ses düzeyi analizi: bütünleşik ses düzeyi ve gerçek tepe, aynı çözme geçişinde parça başına ve albüm başına ölçülür; replay-gain kullanımı için saklanır.
3. Cover selection: seçilen görsel (uzak, klasör görüntüsü veya gömülü) görüntüleme küçük resmine yeniden çizilir; klasörden geldiyse özgünü sürümün dosyaları arasında tutulur.
4. Atomik yazma: sürüm, parçalar, katkılar, kimlikler, biçimler, kesitler, dosyalar ve kapak tek işlemde kaydedilir. Yarı içe aktarılmış durum yoktur.

Sürüm, kullanıcının dosyalarına yerinde başvurarak kaydedilir. Bulut içe aktarmasında coven yazmadan önce her dosyayı okur ve karmasını alır; aynı yazma her dosyayı coven’de hazırlar, her satırı kendi dosyasına yönlendirir ve yüklemesini kuyruğa koyar. Yerel içe aktarma ise her dosyanın yolunu, boyutunu ve değişiklik zamanını bu aygıtta kaydeder; baytları ancak sürüm daha sonra buluta taşınırsa okunur. Her iki durumda da dosyaların özgün baytları baştan sona doğruluk kaynağı olarak kalır; kullanıcının bae’e verdiği hiçbir şey silinmez veya değiştirilmez.

Rip’leri tanıma

Her içe aktarma, yeni rastgele kimliği ve kendi parça ve dosya satırları olan bir sürüm oluşturur. Her cihaz, içe aktarmalarının her birinin okuduğu dosyaların sıralanmış göreli yollarının, boyutlarının ve değişiklik zamanlarının SHA-256 değerini local_release_origin içinde kaydeder; bu kayıt hiçbir zaman eşitlenmez. Bu cihazın karmasını kaydettiği bir klasör, nereye taşınırsa taşınsın tamamlanan içe aktarmalar sekmesindedir ve satırı ondan içe aktarılan tek sürümü gösterir. Aynı dosyaları o cihazda yeniden içe aktarmak başarısız olur ve tamamlanan içe aktarmalar sekmesi yeniden içe aktarma işlemi sunmaz.