İç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 ve kazanan kaynağın ham JSON’u gelecekte yeniden yorumlama için veritabanına arşivlenir.

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 (bir config flag bunu kapatabilir).
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. Kullanıcı cloud-managed seçtiyse yükleme kayıttan sonra depolama geçişi olarak gerçekleşir ve 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 sürüm, içe aktarılan klasör yapısı üzerinden (göreli yollar ve boyutlar, konumdan bağımsız) bir content hash kaydeder. Yeniden taramalar bunu kitaplıktaki klasörleri işaretlemek için kullanır; aynı rip’in yeniden içe aktarmaları da kopyalamak yerine önceki sürümü bulup değiştirir.