M@cPDddlZddlmZddlmZddlmZmZmZddl m Z ddl m Z e e Zd Zd'd Zd Zej$d d e ddZGddZGddeZGddZGddeZdZdZdZdZdZdZdZ d Z!d!Z"d"Z#d#Z$dZ%dZ&d$Z'd%Z(d&Z)y)(N)log10) Mp3Exception) bytes2bin bytes2decbin2dec) getLogger) __version__c6|dz }|dzdk7ry|dz dz}|dk(rtjdy|dz dz}|d k(rtjd y|d z d z}|d vrtjdy|dz dz}|dk(rtjdyy)zWDetermine if ``header`` (an integer, 4 bytes compared) is a valid mp3 frame header.iFrzinvalid mpeg versionrzinvalid mpeg layer )rrzinvalid mpeg bitrate zinvalid mpeg sample rateT)logdebug)headersyncversionlayerbitrate sample_rates 3/usr/lib/python3/dist-packages/eyed3/mp3/headers.py isValidHeaderr s bLD f} |s"G!| () r\S E z &'|s"G( ()R<3&Kc ,- cddfd }|||\}}|9t|}t|rt|||gS||||zdz\}}|9y)aLocate the first mp3 header in file stream ``fp`` starting a offset ``start_pos`` (defaults to 0). Returned is a 3-tuple containing the offset where the header was found, the header as an integer, and the header as 4 bytes. If no header is found header_int will equal 0. c` |dz dk\r ||dz dk(ry||dzdk(S#t$rYywxYw)zCheck for unicode BOMrrTF) IndexError)bufferposs risBOMzfindHeader..isBOM;sJ Qw!|#'?c)#'?c) )  s! ! --cjd}|j||j|}|rd}d|cxkr|kr]nnZ|jd|}|dk(rnB||s&|||dz}t|dk(rt ||z|gS|dz }d|cxkr|krXn|t|z }|j|}|ry)Ni rr)NN)seekreadfindlentuple)_fp_poschunk_szdatar$hr%s r find_synczfindHeader..find_syncEs xx!Cs%X%ii-"9T3'Sq)A1v{$dSj!_55qs%X% CI D88H%D"rrNNNr)rrr.)fp start_posr4sync_pos header_bytesrr%s @r findHeaderr;4sr2'r95Hl  <(  (FL9: :!*2y8/Ca/G!H,   rc|jdk\r|rt|j}nd}tt||jt|j z S)aXComputes the number of seconds per mp3 frame. It can be used to compute overall playtime and bitrate. The mp3 layer and sample rate from ``mp3_header`` are used to compute the number of seconds (fractional float point value) per mp3 frame. Be sure to set ``vbr`` True when dealing with VBR, otherwise playtimes may be incorrect.@r)r_mp3VersionKeyfloatSAMPLES_PER_FRAME_TABLEr sample_freq) mp3_headervbrrows r timePerFramerEhsZS SZ//0 )#.z/?/?@ A *(( ) *+rz0.9a2z1.0zUse timePerFrame instead) deprecated_in removed_incurrent_versiondetailsc | t|dSy)NF)rE)rBs rcompute_time_per_framerKwsJ..rceZdZdZddZdZy) Mp3Headerz Header container for MP3 frames.Ncd|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ d|_ |r|j|yyN)rrerror_protectionbit_raterApadding private_bit copyrightoriginalemphasismodemode_extension frame_lengthdecode)self header_datas r__init__zMp3Header.__init__sx  $     #   KK $ rc t|s td|dz dz}gd||_|j tdd|dz dzz |_|jdk(r td|d z d z |_|d z d z|_|d z d z|_|dz d z|_|d z d z|_|dz dz}t|t|j|_ |js td|dz dz}t|jd k(r|jd k(rd}nt|jd k(r|jd k(rd }nt|jd k(r|jdk(rd }nt|jd k(r|jd k(rd}n]t|jd k(r!|jd k(s|jdk(rd}n$td|j|jfzt|||_|j td|dz}|dk(r t|_n0|d k(r t"|_n|d k(r t$|_ntd|z|dz dz}|dk(r t&|_n-|d k(r t*|_n|d k(r t,|_n t.|_|dz dz|_|jd k(rH|j(}|j} | dvr|t.k7r td| dvr|t.k(r td|jdz} |j} |j } |jd k(r,|j dz} td| z| z | zdz|_n(|j d z} td| z| z | z|_t4j7dt9|jzt4j7dd|jzzt4j7dt9|jzt4j7d t9|jzt4j7d!|j(zt4j7d"t9|j0zt4j7d#t9|jzt4j7d$t9|jzt4j7d%t9|jzt4j7d&t9|j zt4j7d't9|j zt4j7d(t9|j zt4j7d)t9|j2zy)*NzInvalid MPEG headerrr)@Nr=g?zIllegal MPEG versionr)rzIllegal MPEG layerr r rrzIllegal MPEG sampling frequencyrrrz5Mp3 version %f and layer %d is an invalid combinationzInvalid bit ratezIllegal mp3 emphasis value: %d) 08Pz-Invalid mode/bitrate combination for layer II)@zMPEG audio version: zMPEG audio layer: IzMPEG sampling frequency: zMPEG bit rate: zMPEG channel mode: zMPEG channel mode extension: zMPEG CRC error protection: zMPEG original: zMPEG copyright: zMPEG private bit: zMPEG padding: zMPEG emphasis: zMPEG frame length: )rrrrrPrRrSrTrUSAMPLE_FREQ_TABLEr>rAintBIT_RATE_TABLErQ EMPHASIS_NONErV EMPHASIS_5015 EMPHASIS_CCIT MODE_STEREOrWMODE_JOINT_STEREOMODE_DUAL_CHANNEL_STEREO MODE_MONOrXrYrrstr) r[rr sample_bits bit_rate_row bit_rate_colemph mode_bitsmbrsfps rrZzMp3Header.decodesV$45 5R<3&,W5 << 56 66R<3./ ::?34 4&,r\S$8 8! s* "aK3. A+,1+ |s* k *>$,,+G H @A A" + t||  !djjAoL  ! # aL  ! # aL  ! # aL  ! #q)-qL -04 djj/I JK K&|4\B == 12 2| 19)DM QY)DM QY)DM?$FG Gq[C' >#DI !^)DI !^0DI!DI%{c1 ::? AB&&AN"$())**Y"$())]]T !    LL ::? q A #rBw"n%9Q$> ?D  q A #cBh"_$9 :D  (3t||+<<= &# *:;< -D4D4D0EEF #c$--&889 '$))34 1C8K8K4LLM /#d6K6K2LLM #c$--&889 $s4>>'::; &T-=-=)>>? "S%667 #c$--&889 '#d.?.?*@@ArrO__name__ __module__ __qualname____doc__r]rZrrrMrM~s*%*qBrrMceZdZdZdZy) VbriHeaderc d|_d|_y)NT)rCrr[s rr]zVbriHeader.__init__ s rcd}|||dz}|dk7rytjd|z|dz }tt|||dz|_|dz }tt|||dz|_|dz }tt|||dz|_|dz }tt|||dz|_|dz }tt|||dz|_|dz }y)N$r)VBRIFzVBRI header detected @ %xrT) rrr rrdelayquality num_bytes num_frames)r[frameoffsetheads rrZzVbriHeader.decodesVFQJ' 6> -89! yvfqj)ABC ! YuVFQJ'?@A ! yvfqj)ABC !  5 +C!DE! !)E&!,D"EF! rN)rrrr]rZrrrrr s rrceZdZdZdZdZy) XingHeaderz,Header class for the Xing header extensions.ctt|_t|_dgdz|_t|_y)Nrd)ro numFramesnumBytestocvbrScalers rr]zXingHeader.__init__1s* 39 rc|ddz dz}|ddz dz}|r |dk7rd}n d}n |dk7rd}nd}|||dz}|dk(xrd xsd |_|d vry tjd ||fz|dz }tt |||dz}|dz }tjd ||fz|t zrHtt |||dz|_|dz }tjd||j fz|tzrHtt |||dz|_|dz }tjd||jfz|tzr+|||dz|_ |dz }tjd|zntjd|z|tzrM|dk(rHtt |||dz|_ |dz }tjd||jfzy )Nrrrbr r)XingTF)rsInfoz%s header detected @ %xz%s header flags: 0x%xz%s numFrames: %dz%s numBytes: %drz%s TOC (100 bytes): PRESENTz%s TOC (100 bytes): NOT PRESENTz%s vbrScale: %d) rCrrr r FRAMES_FLAGr BYTES_FLAGrTOC_FLAGrVBR_SCALE_FLAGr)r[rrrWr$r headFlagss rrZzXingHeader.decode;s 8q=C'aA $ qyqySq!GO-6 ) ) +tSk9: qIeCa&89:  q )T9,==> { "$YuSq/A%BCDN 1HC II(D$..+AA B z !#IeCa.@$ABDM 1HC II'4*?? @ x Ss+DH 3JC II3d: ; II7$> ? ~ %$'/#IeCa.@$ABDM 1HC II'4*?? @rNrrrrrr.s68rrc *eZdZdZgdZdddddZidd d d d d ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,Zd-d.d/d0Zd-d1d2d3d4d5Zd6d7d8d9d:Z d;dd?d@dAdBdCZ dDdEdFdGdHdIZ d dJdKdLdMdNdOdPdQdHdR Z fdSZ dWdTZdUZdVZxZS)X LameHeadera Mp3 Info tag (AKA LAME Tag) Lame (and some other encoders) write a tag containing various bits of info about the options used at encode time. If available, the following are parsed and stored in the LameHeader dict: * encoder_version: short encoder version [str] * tag_revision: revision number of the tag [int] * vbr_method: VBR method used for encoding [str] * lowpass_filter: lowpass filter frequency in Hz [int] * replaygain: if available, radio and audiofile gain (see below) [dict] * encoding_flags: encoding flags used [list] * nogap: location of gaps when --nogap was used [list] * ath_type: ATH type [int] * bitrate: bitrate and type (Constant, Target, Minimum) [tuple] * encoder_delay: samples added at the start of the mp3 [int] * encoder_padding: samples added at the end of the mp3 [int] * noise_shaping: noise shaping method [int] * stereo_mode: stereo mode used [str] * unwise_settings: whether unwise settings were used [boolean] * sample_freq: source sample frequency [str] * mp3_gain: mp3 gain adjustment (rarely used) [float] * preset: preset used [str] * surround_info: surround information [str] * music_length: length in bytes of original mp3 [int] * music_crc: CRC-16 of the mp3 music data [int] * infotag_crc: CRC-16 of the info tag [int] Prior to ~3.90, Lame simply stored the encoder version in the first frame. If the infotag_crc is invalid, then we try to read this version string. A simple way to tell if the LAME Tag is complete is to check for the infotag_crc key. Replay Gain data is only available since Lame version 3.94b. If set, the replaygain dict has the following structure: .. code-block:: peak_amplitude: peak signal amplitude [float] radio: name: name of the gain adjustment [str] adjustment: gain adjustment [float] originator: originator of the gain adjustment [str] audiofile: [same as radio] Note that as of 3.95.1, Lame uses 89dB as a reference level instead of the 83dB that is specified in the Replay Gain spec. This is not automatically compensated for. You can do something like this if you want: .. code-block:: import eyeD3 af = eyeD3.mp3.Mp3AudioFile('/path/to/some.mp3') lamever = af.lameTag['encoder_version'] name, ver = lamever[:4], lamever[4:] gain = af.lameTag['replaygain']['radio']['adjustment'] if name == 'LAME' and eyeD3.mp3.lamevercmp(ver, '3.95') > 0: gain -= 6 Radio and Audiofile Replay Gain are often referred to as Track and Album gain, respectively. See https://replaygain.hydrogenaudio.org/ for further details on Replay Gain. See http://gabriel.mp3-tech.org/mp3infotag.html for the gory details of the LAME Tag. (riiriiiiiAiiiiAiiii@ii i iAiiii@i iii@ ii iiAiiiiAiiii@iii@iiiiAiiii@iiiiAiiiiAiiii@ii0i1iAi3iii@2i6iii@7ii5i4iAi<iii@=ii?>iAii:i;iAi9iii@8i(iii@)ii+i*iAii.i/iAi-iii@,ii$i%iAi'iii@&i"iii@#ii!i iAii`iaiAiciii@bifiii@giieidiAiliii@miioiniAiijikiAiiiii@hixiii@yii{iziAii~iiA}iii@|iitiuiAiwiii@viriii@siiqipiAiPiii@QiiSiRiAiiViWiAiUiii@Tii\i]iAi_iii@^iZiii@[iiYiXiAiiHiIiAiKiii@JiNiii@OiiMiLiAiDiii@EiiGiFiAiiBiCiAiAiii@@rrr)ra) NSPSYTUNE NSSAFEJOINT NOGAP_NEXT NOGAP_PREVrUnknowniV9iV8iV7iV6iV5iV4iV3iV2iV1iV0rkr3mixistandardiextremeiinsaneiz standard/fastiz extreme/fastmediumz medium/fast)iizNot setRadio Audiofile)rrrz Set by artistz Set by userzSet automaticallyzSet by simple RMS average)rrrrrz <= 32 kHzz44.1 kHzz48 kHzz> 48 kHz)rrrrMonoStereoDualJointForceAuto Intensity Undefined)rrrrr)rbNonez DPL encodingz DPL2 encodingzAmbisonic encodingReserved)rrrrrazConstant BitratezAverage Bitratez!Variable Bitrate method1 (old/rh)zVariable Bitrate method2 (mtrh)zVariable Bitrate method3 (mt)zVariable Bitrate method4zConstant Bitrate (2 pass)zAverage Bitrate (2 pass)) rrrrr)rrbrar`rcDt||j|y)zSRead the LAME info tag. frame should be the first frame of an mp3. N)superr]rZ)r[r __class__s rr]zLameHeader.__init__)s  Erc|Dcgc]}t|gc}D]&}|jt||dzz |dz z }(|Scc}w)z+Compute a CRC-16 checksum on a data stream.ra)bytes _crc16_tableord)r[r2valbcs r_crc16zLameHeader._crc160sT&*+%*+ HA##CFcDj$9:cQhGC H ,sAc j |jd}tjd|t t |dd}|j |dd|k7rtjdntjd t|||dzjd |d <tjd |d z|dz }t t |||d zdd |d<t t |||d zd d}|jj|d|d<tjd|dztjd|dz|d z }t t |||d zdz|d<tjd|dz|d z }i}t t |||dzd z}|dkDr;|tdz}dt|z}||d<tjd||fz|dz }dD] }t t |||dzdd} t t |||dzdd} t t |||dzdd } t t |||dzd dd!z } | r| d"z} |d } | ddd#k(rt| ddd$dkDr| dz} | r`|jj| d} |j j| d} | | | d%||<tjd&| d'| d(| d)|dz }|r||d*<t t |||d zdd}|j#|\|d+<|d,<t t |||d zdd|d-<tjd.d/j%|d+z|d,r*tjd0d1j%|d,ztjd2|d-z|d z }d3}d4|dvrd5}n d6|dvrd7}t t |||d z|f|d8<tjd9|d:|d8d|d z }t t |||dzdd;|d<<t t |||dzd;d|d=<tjd>|d<ztjd?|d=z|dz }t t |||d zdd}t t |||d zdd}t t |||d zdd}t t |||d zdd|d@<|j&j|d|dA<t)||dB<|j*j|d|dC<tjdD|dAztjdE|dBztjdF|dCztjdG|d@z|d z }t |||d zd} t t |||d zd d}| r|d"z}||dH<|dIz}tjdJ|dH|fz|d z }t t |||dzdd }t t |||dzd d}|t-dKdLvrF|d8ddMk\r(||f|d8<tjd9|d:|d8dd4|dvrdN|z}n"dO|z}n|j.j||}|j0j|||dP<||dQ<tjdR|dPztjdS|dQz|dz }t t |||dz|dT<tjdU|dTz|dz }t t |||dz|dV<tjdW|dVz|dz }||dX<tjdY|dXz|dz }y#t$rYywxYw#t2$rtjdZYywxYw)[zDecode the LAME info tag.sLAMENz Lame info tag found at position zLame tag CRC check failedzLame tag CRC OKr`latin1encoder_versionzLame Encoder Version: %srr tag_revisionr vbr_methodzLame info tag version: %szLame VBR method: %srlowpass_filterz Lame Lowpass filter value: %s Hzr)ripeak_amplitudez+Lame Peak signal amplitude: %.8f (%+.1f dB))radio audiofilerrrbrg$@r(LAMEz3.95)name adjustment originatorzLame z Replay Gain: z dB () replaygainencoding_flagsnogapath_typezLame Encoding flags: %s zLame No gap: %sz and zLame ATH type: %sConstantAverageTargetVariableMinimumrzLame Bitrate (z): r encoder_delayencoder_paddingzLame Encoder delay: %s samplesz Lame Encoder padding: %s samples noise_shapingrAunwise_settings stereo_modez Lame Source Sample Frequency: %szLame Unwise settings used: %szLame Stereo mode: %szLame Noise Shaping: %smp3_gaing?zLame MP3 Gain: %s (%+.1f dB)raiArzABR %szCBR %s surround_infopresetzLame Surround Info: %szLame Preset: %s music_lengthzLame Music Length: %s bytes music_crczLame Music CRC: %04X infotag_crczLame Info Tag CRC: %04Xz.Truncated LAME info header, values incomplete.)index ValueErrorrrr rrwarningrxrstrip VBR_METHODSgetr?r lamevercmpREPLAYGAIN_NAMEREPLAYGAIN_ORIGINATOR_parse_encflagsjoinSAMPLE_FREQUENCIESbool STEREO_MODESrangePRESETS SURROUND_INFOr")r[rr$lamecrcrrpeakdbgaintyperorigsignadjlameverencflagsbtyperArrgainsurroundrs rrZzLameHeader.decode6s  ++g&C 4SE:;)E#cN34 ;;uTc{ #w . KK3 4 II' (Y J&)%C!G*<*C*C*Ex&PD" # II048I3JJ K 1HC$+9U3sQw5G+H!+L#MD  5S1W+=!>qr!BCJ!%!1!1!5!5j)!LD  II1D4HH I II+d<.@@ A 1HC&-'0s371C'D&FHK&LD! " II8+,- . 1HCJ9U3sQw%789Q>Daxg&%+%/3 +, G*%& 1HC3 ys37);,@Jx(II#S$01q+ ,%/\"ys37);"?"CDK%ic#'0B&CAa&HIO!)E#cAg,>"?!"DEK$+IeCa6H,I!",M$ND !"&"9"9"="=k>G#ID &*?&;D" #"&"3"3"7"7 Y"OD  II84 ;NN O II5=N8OO P II,tM/BB C II.o1FF G 1HCU3sQw/03D9U3sQw%78<=D #D B II4Z8H"7MM N 1HCys37);?Fq#& ?1%,'-uoDOII$d9oa&8:;\ 22%.F%.F))&&9$($6$6$:$:8X$ND !#DN II.o1FF G II'$x.8 9 1HC$+9U3sQw5G+H#ID II3d>6JJ K 1HC!( %C!G2D(E FD  II,tK/@@ A 1HC#*D  II/$}2EE F 1HCG   H J KKH I Js$`]<` ` ``21`2cpgg}}|s||fS||jdzr|jd||jdzr|jd|jd}|jd}|||zzr=|jd||zr|jd||zr|jd ||fS) zParse encoder flags. Returns a tuple containing lists of encoder flags and nogap data in human readable format. rz --nspsytunerz --nssafejointrrz--nogapbeforeafter) ENCODER_FLAGSappend)r[flags encoder_flagsrNEXTPREVs rr zLameHeader._parse_encflagss "2u  %' ' 4%%k2 2   / 4%%m4 4   1!!,/!!,/ D4K   +t| X&t| W%e##rr6)rrrrrr rrrr r rrr]rrZr  __classcell__)rs@rrrvsAJ FLF M  4 4   4   4  4 4 4 4 4 4 G J I  H!" O#$ N%&  )G.   O     & (             L      M    , * ( # $ #  K iJV$rrcd}|jd}|jd}|dd|ddk(ry||dd|dd}|r|S|jddd\}}|jddd\}}dg}|dk(r|d k\s |dk(r|d k\r|jd |d|vry |d|vry |dd k(ry |dd k(ry ||d|dS)a<Compare LAME version strings. alpha and beta versions are considered older. Versions with sub minor parts or end with 'r' are considered newer. :param x: The first version to compare. :param y: The second version to compare. :returns: Return negative if xy. c||kD||kz SrOr)ars rcmpzlamevercmp..cmpsA!a%  rrNrr).r396rrr(r)ljustsplitr!) xyr*retxmajxminymajyminminpartss rrrs!  A  A!u"1~ aeQrU C  bq!JD$bq!JD$uH   $#+$$,txtxts{ts{ qtQqT?r))iDi"Vi+)ii]i.)rrrr5))rrrrr)rcrcrcrcra)@rd(rdr )`rerdre)r9rer9rc)rfr9rfr:)rr;rfr;rd)rgpr;r?re)rhr=r?r=r9)i r>r=rlrf)rirr>r>r;)i`rgrr?)rjrhrgrr=)irirhrgrl)irjrirhr>)NNNNN))NrjrANrjrAi@rBrz50/15 msz CCIT J.17rz Joint stereozDual channel stereorr)rach|dk(rd}nt|dz }d|cxkrdksntd||S)zRMap mp3 version float to a data structure index. 1 -> 0, 2 -> 1, 2.5 -> 2 r_rrrzInvalid mp3 version key value: )ror)rkeys rr>r>VsA#~'A+ =q=:3%@AA Jrr6)* deprecationmathrrutils.binfuncsrrr utils.logr __about__r rrrr;rE deprecatedrKrMobjectrrdictrrrnrpr@rqrrrsrtrurvrwrrrrr>rrrrNs::!#%P1h +g%Q\ :</</ HBHBV""JEEPD$D$N %R) 2&     "0     r