आयात पाइपलाइन

आयात फ़ाइलों के एक बाइट को बदले बिना फ़ाइलों के फ़ोल्डर को कैटलॉग प्रविष्टि में बदलता है। यह पृष्ठ उपयोग मार्गदर्शिका में बताए गए प्रवाह की पाइपलाइन समझाता है।

स्कैनिंग

निगरानी वाले फोल्डर प्लेटफॉर्म की फाइल-प्रणाली घटनाओं से देखे जाते हैं, बदलावों को थोड़ी देर रोककर मिलाया जाता है, और बदलाव आने पर फिर स्कैन किए जाते हैं; स्कैन मौजूदा उम्मीदवार सूची से मिलान करते हैं, फिर से शुरू नहीं करते। स्कैनर किसी फोल्डर को एक रिलीज मानता है (ऑडियो सीधे भीतर हो, या CD1/CD2 जैसे डिस्क-आकार के सबफोल्डर हों), या संग्रह मानकर उसके भीतर उतरता है। फाइलें एक्सटेंशन से ऑडियो, कला और दस्तावेजों में बांटी जाती हैं, फिर ऑडियो की जांच होती है: मायने उस कोडेक का है जो FFmpeg बाइट में पाता है, फाइल एक्सटेंशन का नहीं। आधे डाउनलोड के चिन्ह वाले फोल्डर डाउनलोड पूरा होने तक बाहर रखे जाते हैं।

CUE sheet एक ऑडियो image को ट्रैक सूची में बदलती है। पार्सर प्रीगैप और पोस्टगैप, हर ट्रैक के कलाकार और ISRC, तथा एक-फाइल image और हर-ट्रैक-एक-फाइल CUE विन्यास, दोनों संभालता है। ट्रैक सीमाएं CUE frames (सेकंड का 1/75 हिस्सा) से ठीक नमूना स्थितियों में बदली जाती हैं, जो बाद में प्लेबैक की बाइट और नमूना खिड़कियां बनती हैं।

मेटाडाटा ड्राफ्ट

प्रत्येक उम्मीदवार एक संपादन योग्य मेटाडाटा ड्राफ्ट और वैकल्पिक उत्पत्ति भंडारित करता है. ड्राफ्ट खाली हो सकता है, सीधे भरा गया, बाहरी रिलीज से भरा गया, या भंडारित फ़ाइल- टैग स्नैपशॉट से भरा गया. उत्पत्ति रिकॉर्ड जहां वर्तमान ड्राफ्ट शुरू हुआ; बाद में संपादन इसे मिटाते नहीं हैं. सीधे प्रविष्टि और एक साफ ड्राफ्ट में कोई उत्पत्ति नहीं है.

शीर्ष मेटाडाटा स्लॉट या तो ड्राफ्ट, ऑनलाइन खोजें ब्राउज़र, या फ़ाइल टैग ब्राउज़र को प्रदर्शित करता है. ब्राउज़र को खोलना या बंद करना ड्राफ्ट को फिर से लिखता नहीं है. लागू करें एक स्रोत को बदलना ड्राफ्ट, इसकी उत्पत्ति, और एक डाटाबेस ट्रांजेक्शन में इसका चयनित स्रोत कवर को बदलता है जबकि फ़ाइल भूमिकाओं, CUE बाइंडिंग्स, डिस्क आबंटन, और अन्य मैपिंग निर्णयों को बनाए रखता है.

ऑनलाइन खोजें

ऑनलाइन खोजें एकमात्र पथ है जो पहचान चलाता है. यह एक रिप लॉग या CUE शीट से एक डिस्क ID की गणना करता है, बारकोड और OCR के साथ कैटलॉग पाठ को पहचानता है, क्वेरी MusicBrainz और Discogs, और परिणामों को मिलाता है. एम्बेडेड ऑडियो टैग ऑनलाइन पहचान सबूत नहीं हैं.

डिफ़ॉल्ट मेटाडेटा स्रोत के तीन मान हैं। कोई नहीं एक खाली ड्राफ्ट बनाता है और मेटाडेटा का कोई काम शुरू नहीं करता। फ़ाइल टैग टैग स्नैपशॉट पढ़कर लागू करता है। ऑनलाइन खोजें ऑनलाइन कार्यप्रवाह खोलता है। ऑनलाइन खोजें का डिफ़ॉल्ट मोड स्वचालित, जो प्रमाण निकालना, प्रदाता क्वेरी और मिलान कतार में लगाता है, या खुद खोजें, जो पहचान शुरू नहीं करता, चुनता है। किसी भी उम्मीदवार के लिए ऑनलाइन खोजें चुना हुआ मोड उपयोग करता है; स्वचालित किसी सक्रिय या पूरी हो चुकी प्रक्रिया को फिर शुरू नहीं करता।

फ़ाइल टैग

फ़ाइल टैग अंतर्निर्मित ऑडियो टैग और CUE मेटाडाटा को लाज़ीली पढ़ता है जब तक कि यह नए खोजे गए उम्मीदवार के लिए विन्यस्त डिफ़ॉल्ट न हो. पूर्वावलोकन उम्मीदवार के स्कैन जनरेशन, फ़ाइल-संपादन संशोधन, और अवलोकन ऑडियो फ़ाइलों के साथ स्टैम्प्ड एक स्नैपशॉट को भंडारित करता है. लागू करें इसे बदलकर उस सटीक स्नैपशॉट से ड्राफ्ट को बदलता है. आयात एक ही स्नैपशॉट का उपयोग करता है और लाइब्रेरी लिखने से पहले असफल होता है यदि इसका स्टैम्प या अवलोकन बदल जाता है; यह एक अलग जवाब नहीं पढ़ता है.

प्रत्यक्ष प्रविष्टि कोई मेटाडाटा I/O नहीं करता है. रिक्त ड्राफ्ट के रिलीज और ट्रैक क्षेत्र तुरंत संपादन योग्य हैं, और यह आयात योग्य बन जाता है जब आवश्यक क्षेत्र और मैपिंग वैध हो जाते हैं. उम्मीदवार सूची त्रुटि या ध्यान के लिए अनुरोध के रूप में गुम स्रोत को नहीं समझता है.

स्रोत

MusicBrainz से बिना पहचान बताए, हर सेकंड एक अनुरोध की सख्त गति से पूछा जाता है। Discogs कुंजी-भंडार से उपयोगकर्ता के निजी टोकन से प्रमाणित करता है, अपनी दर-सीमा के भीतर रुक-रुककर और फिर कोशिश करके चलता है, और टोकन अस्वीकार हो तो उसे वैसा ही बताया जाता है ताकि UI शांत खोज-विफलता के बजाय उसे दिखा सके। उत्तर हर सत्र में कैश होते हैं, और जो स्रोत चुना जाता है उसका raw JSON बाद में फिर समझने के लिए डेटाबेस में रखा जाता है।

कमिट

आयात की पुष्टि करने पर क्रम से ये काम होते हैं:

1. डिकोड सत्यापन: हर ट्रैक शुरू से अंत तक डिकोड होता है; जो rip पूरी तरह डिकोड नहीं हो सकता, कुछ भी लिखे जाने से पहले आयात विफल करता है (config flag इसे बंद कर सकता है)।
2. ध्वनि-स्तर विश्लेषण: उसी डिकोड दौर में हर ट्रैक और हर एल्बम के लिए समेकित ध्वनि-स्तर और वास्तविक शिखर मापे जाते हैं, और replay-gain उपयोग के लिए रखे जाते हैं।
3. कवर चयन: चुनी गई कला (दूरस्थ, फोल्डर image, या embedded) display thumbnail में फिर बनाई जाती है; मूल कला रिलीज की फाइलों में रखी जाती है, अगर वह फोल्डर से आई थी।
4. एक-लेनदेन लेखन: रिलीज, ट्रैक, credits, identities, फ़ॉर्मैट, segments, फाइलें और कवर एक ही transaction में कमिट होते हैं। आधी आयातित अवस्था नहीं बनती।

रिलीज उपयोगकर्ता की फाइलों को उनकी जगह पर संदर्भित करते हुए दर्ज होती है। अगर उपयोगकर्ता ने क्लाउड-प्रबंधित चुना है, तो अपलोड कमिट के बाद संग्रहण बदलाव के रूप में होता है, और फाइलों के मूल बाइट पूरे समय सत्य का स्रोत रहते हैं; उपयोगकर्ता ने bae को जो दिया है वह कभी मिटाया या बदला नहीं जाता।

rips पहचानना

हर रिलीज अपने आयातित फोल्डर की संरचना (सापेक्ष पथ और आकार, स्थान से स्वतंत्र) पर content hash दर्ज करती है। फिर स्कैन उसी से फोल्डर को लाइब्रेरी में पहले से मौजूद चिन्हित करते हैं, और उसी rip के दोबारा आयात उसे दोहराने के बजाय पिछली रिलीज ढूंढकर बदलते हैं।