Import pipeline

આયાત ફાઇલોના બાઇટમાં ફેરફાર કર્યા વિના ફાઇલોના ફોલ્ડરને કેટલોગ એન્ટ્રીમાં ફેરવે છે. આ પૃષ્ઠ ઉપયોગ માર્ગદર્શિકા માં વર્ણવેલ પ્રવાહની પાછળની પાઇપલાઇન છે.

Scanning

Watched folders platform ના file-system events દ્વારા monitored છે, debounced છે, અને change પર re-scanned છે; scans existing candidate list સામે reconcile કરે છે, ફરી શરૂઆતથી નહીં. Scanner folder ને એક release તરીકે classify કરે છે (audio સીધું અંદર, અથવા CD1/CD2 જેવા disc-shaped subfolders), અથવા collection તરીકે તેમાં recurse કરે છે. Files extension પ્રમાણે audio, artwork અને documents માં classify થાય છે, પછી audio probed થાય છે: મહત્વનો codec એ છે જે FFmpeg bytes માં શોધે છે, file extension નહીં. Partial-download markers ધરાવતા folders download પૂરું થાય ત્યાં સુધી excluded છે.

CUE sheet એક audio image ને track list માં ફેરવે છે. Parser pregaps અને postgaps, per-track performers અને ISRCs, અને single-file images તથા one-file-per-track CUE layouts બંને handle કરે છે. Track boundaries CUE frames (second નો 1/75th) માંથી exact sample positions માં convert થાય છે, જે પછી playback વાપરે તે byte અને sample windows બને છે.

મેટાડેટા ડ્રાફ્ટ્સ

દરેક ઉમેદવાર એક ફેરફાર કરી શકાય તેવી મેટાડેટા ડ્રાફ્ટ અને વૈકલ્પિક ઉત્પત્તિ સંગ્રહે છે. ડ્રાફ્ટ ખાલી હોઈ શકે, સીધી જ ભરેલું, બાહ્ય રિલીઝમાંથી ભરેલું, અથવા સંગ્રહાયેલ ફાઈલ-ટૅગ સ્નેપશોટમાંથી ભરેલું. ઉત્પત્તિ રેકોર્ડો જ્યાં વર્તમાન ડ્રાફ્ટ શરૂ થયેલ છે; પછીના ફેરફારો તેને કાઢી નાખે છે. સીધી પ્રવેશ અને સાફ થયેલ ડ્રાફ્ટ પાસે કોઈ ઉત્પત્તિ નથી.

ટોચની મેટાડેટા સ્લોટ ડ્રાફ્ટ, ઓનલાઇન શોધો બ્રાઉઝર, અથવા ફાઇલ ટૅગ બ્રાઉઝર દર્શાવે છે. બ્રાઉઝર ખોલવું અથવા બંધ કરવું ડ્રાફ્ટને ફરીથી લખે છે નહિં. લાગુ કરો સ્ત્રોતને બદલે છે ડ્રાફ્ટ, તેની ઉત્પત્તિ, અને તેના પસંદ થયેલ સ્ત્રોત કવર એક ડેટાબેઝ ટ્રાન્ઝેક્શનમાં જ્યારે ફાઇલ ભૂમિકાઓ, CUE જોડાણો, ડિસ્ક સોંપણીઓ, અને અન્ય મેપિંગ નિર્ણયો રાખે છે.

ઓનલાઇન શોધો

ઓનલાઇન શોધો એ એકમાત્ર પાથ છે કે જે ઓળખ ચલાવે છે. તે રિપ લોગ અથવા CUE શીટમાંથી ડિસ્ક ID ની ગણતરી કરે છે, OCR સાથે બારકોડ અને કેટેલોગ લખાણને ઓળખે છે, MusicBrainz અને Discogs ને પ્રશ્નો કરે છે, અને પરિણામોને બંધબેસે છે. જડિત ઓડિયો ટેગો ઓનલાઇન-ઓળખ સાક્ષી નથી.

ડિફૉલ્ટ મેટાડેટા સ્રોતમાં ત્રણ મૂલ્યો છે. કોઈ નહીં ખાલી ડ્રાફ્ટ બનાવે છે અને કોઈ મેટાડેટા કામ શરૂ કરતું નથી. ફાઇલ ટૅગ ટૅગ સ્નેપશોટ વાંચીને લાગુ કરે છે. ઓનલાઇન શોધો ઓનલાઇન કાર્યપ્રવાહ ખોલે છે. ઓનલાઇન શોધોનો ડિફૉલ્ટ મોડ આપોઆપ, જે સાક્ષી કાઢવાનું, પ્રદાતા પ્રશ્નો અને મેળાપને કતારમાં મૂકે છે, અથવા જાતે શોધો, જે ઓળખ શરૂ કરતું નથી, પસંદ કરે છે. કોઈપણ ઉમેદવાર માટે ઓનલાઇન શોધો પસંદ કરેલો મોડ વાપરે છે; આપોઆપ સક્રિય અથવા પૂર્ણ થયેલું કામ ફરી શરૂ કરતું નથી.

ફાઇલ ટૅગ

ફાઇલ ટૅગ જડિત ઓડિયો ટેગો અને CUE મેટાડેટાને ધીમે ધીમે વાંચે છે, જો તે નવી રીતે શોધાયેલ ઉમેદવાર માટે રૂપરેખાંકિત મૂળભૂત ન હોય તો. પૂર્વદર્શન ઉમેદવારના સ્કેન ઉત્પન્ન, ફાઈલ-સંપાદક પુનરાવર્તન, અને અવલોકન થયેલ ઓડિયો ફાઈલો સાથે સ્ટેમ્પ થયેલ સ્નેપશોટ સંગ્રહે છે. લાગુ કરો તેને બદલીને તે ચોક્કસ સ્નેપશોટમાંથી ડ્રાફ્ટને બદલે છે. આયાત એ જ સ્નેપશોટનો વપરાશ કરે છે અને લાઈબ્રેરી લખે તે પહેલાં નિષ્ફળ જાય છે જો તેની સ્ટેમ્પ અથવા અવલોકન બદલાઈ જાય; તે અલગ જવાબ વાંચી શકતું નથી.

સીધો પ્રવેશ કોઈ મેટાડેટા I/O ચલાવી શકતો નથી. ખાલી ડ્રાફ્ટના રિલીઝ અને ટ્રેક ક્ષેત્રોમાં તરત જ ફેરફાર કરી શકાય છે, અને તે આયાત કરી શકાય છે જ્યારે જરૂરી ક્ષેત્રો અને નકશાઓ માન્ય કરે છે. ઉમેદવાર યાદી ભૂલ અથવા ધ્યાન માટેની વિનંતી તરીકે ગુમ થયેલ ઉત્પત્તિને સંભાળી શકતી નથી.

Sources

MusicBrainz strict one-request-per-second pace સાથે anonymously queried છે. Discogs user ના keyring માંથી personal token સાથે authenticate કરે છે, તેના rate limits અંદર paced અને retried છે, અને rejected token તે તરીકે reported થાય છે જેથી UI તેને flag કરી શકે, searches શાંતિથી fail નહીં થાય. Responses per session cached છે, અને જે source wins કરે તેનું raw JSON future re-interpretation માટે database માં archived છે.

Commit

Import confirm કરવાથી, ક્રમમાં:

1. Decode verification: દરેક track end to end decoded થાય છે; સંપૂર્ણ decode ન થઈ શકે તે rip કશું write થાય પહેલાં import fail કરે છે (config flag આ disable કરી શકે છે).
2. Loudness analysis: integrated loudness અને true peak એ જ decode pass દરમિયાન per track અને per album માપાય છે, replay-gain use માટે stored.
3. Cover selection: પસંદ કરેલું art (remote, folder image, અથવા embedded) display thumbnail માં re-render થાય છે; original release ની files વચ્ચે રાખવામાં આવે છે જો તે folder માંથી આવ્યું હોય.
4. Atomic write: release, tracks, credits, identities, formats, segments, files, અને cover એક transaction માં commit થાય છે. Half-imported state નથી.

Release user ની files ને in place reference કરીને lands થાય છે. User એ cloud-managed પસંદ કર્યું હોય તો upload commit પછી storage transition તરીકે થાય છે, અને files ના original bytes આખો સમય source of truth રહે છે; user એ bae ને આપેલું કશું delete અથવા alter થતું નથી.

Rips ઓળખવા

દરેક release તેના imported folder ની structure (relative paths અને sizes, location-independent) ઉપર content hash record કરે છે. Re-scans તે વાપરી folders ને already in library તરીકે mark કરે છે, અને એ જ rip ના re-imports duplicate કરતાં prior release શોધી replace કરે છે.