118 lines
24 KiB
Plaintext
118 lines
24 KiB
Plaintext
|
+
|
|||
|
|
é·Òj= ã ó® € R t ^ RIt/ R^ bR^bR^bR^bR^bR^bR^bR ^ bR
|
|||
|
|
^
|
|||
|
|
bR ^ bR ^ bR
|
|||
|
|
^
|
|||
|
|
bR^bR^bR^bR^bR^b/ R^bR^bR^bR^bR^ bR^ bR^ bR^ bR^!bR ^"bR ^#bR ^$bR ^&bR ^'bR!^(bR"^(bR#^)bC/ R$^*bR%^+bR&^,bR'^-bR(^.bR)^/bR*^0bR+^1bR,^2bR-^3bR.^4bR/^5bR0^=bR1^<bR2^9bR3^:bR4^AbC/ R5^BbR6^CbR7^DbR8^GbR9^EbR:^FbR;^FbR<^IbR=^HbR>^JbR?^LbR@^MbRA^NbRB^ObRC^ObRD^PbRE^QbC/ RF^RbRG^SbRH^TbRI^UbRJ^VbRK^WbRL^XbRM^YbRN^ZbRO^[bRP^\bRQ^]bRR^cbRS^bbRT^hbRU^ibRV^kbCRW^rRX^bRY^c/Ct/ RZ^#bR[^$bR\^#bR]^%bR^^&bR_^'bR`^*bRa^,bRb^.bRc^-bRd^/bRe^2bRf^1bRg^3bRh^4bRi^6bRj^8bRk^5Rl^'Rm^F/Ct]P / Rn^$bRo^#bRp^&bRq^'bRr^*bRs^*bRt^,bRu^.bRv^-bRw^-bRx^/bRy^2bRz^1bR{^3bR|^4bR}^6bR~^8bR^%Rm^F/C4 R€tR�tR‚ tRƒ tR„ t R… t
|
|||
|
|
! R† R‡4 t ! Rˆ R‰4 t ! RŠ R‹4 t
|
|||
|
|
RŒ tRŽR� ltR# )�uL
|
|||
|
|
midikit — a dependency-free Standard MIDI File (SMF) writer + reader.
|
|||
|
|
|
|||
|
|
Pure Python stdlib. Written for retro game audio work: DOS/OPL-flavoured
|
|||
|
|
Sound Blaster tunes, N64-era ambient, chiptune. Everything a 1993 sound
|
|||
|
|
card would choke on is optional; everything it handled is here.
|
|||
|
|
|
|||
|
|
Why not midiutil/mido? Because this library has to run on any box with a
|
|||
|
|
Python and no network. Zero imports beyond struct.
|
|||
|
|
|
|||
|
|
Quick start:
|
|||
|
|
|
|||
|
|
from midikit import MidiFile, Track, MPQN
|
|||
|
|
|
|||
|
|
mf = MidiFile(tpq=480)
|
|||
|
|
t = Track("Lead")
|
|||
|
|
t.program(0, 81) # channel 0 -> Square Lead (GM 81)
|
|||
|
|
t.note(0, 62, 480, 100) # ch, pitch, duration, velocity
|
|||
|
|
mf.add_track(t)
|
|||
|
|
mf.add_tempo_track([MPQN(0, 500000)]) # 120 BPM
|
|||
|
|
mf.write("tune.mid")
|
|||
|
|
|
|||
|
|
Author: Kevin Hermes (kevinhermes.retroweb.dev)
|
|||
|
|
License: do what you like, credit appreciated.
|
|||
|
|
Nzacoustic grandzbright acousticzelectric piano 1zelectric piano 2Ú harpsichordÚclavinetÚcelestaÚ glockenspielz music boxÚ
|
|||
|
|
vibraphoneÚmarimbaÚ xylophonez
|
|||
|
|
tubular bellsz
|
|||
|
|
drawbar organzpercussive organz
|
|||
|
|
rock organz church organzacoustic nylonzacoustic steelz
|
|||
|
|
electric jazzzclean electriczmuted electricÚ overdriveÚ
|
|||
|
|
distortionz
|
|||
|
|
acoustic basszelectric bass fingerzelectric bass pickÚfretlessz slap bass 1z synth bass 1z synth bass 2z chorus bassÚviolinÚviolaÚcelloÚ
|
|||
|
|
contrabassztremolo stringszpizzicato stringszorchestral harpÚtimpanizstring ensemble 1zstring ensemble 2zsynth strings 1zsynth strings 2z
|
|||
|
|
choir aahsz
|
|||
|
|
voice oohsz
|
|||
|
|
synth trumpetÚhornÚtromboneÚtubaz soprano saxzalto saxz tenor saxz baritone saxÚclarinetÚoboez english hornÚbassoonÚfluteÚpiccoloÚrecorderz pan flutez blown bottleÚ
|
|||
|
|
shakuhachiÚwhistleÚocarinaz square leadz
|
|||
|
|
sawtooth leadz
|
|||
|
|
calliope leadz
|
|||
|
|
chiff leadz charang leadz
|
|||
|
|
voice leadz fifths leadz bass+leadz new age padzwarm padz
|
|||
|
|
polysynth padzspace voice padz glass padz sweep padzfx: rainzfx: soundtrackÚsitarÚbanjoÚkotoz calypso drumÚcrystalÚ
|
|||
|
|
atmospherezacoustic bass drumz bass drum 1z bass drum 2z
|
|||
|
|
side stickzacoustic snarezelectric snarez
|
|||
|
|
closed hi-hatz pedal hi-hatz open hi-hatzlow tomzmid tomzhigh tomz crash cymbalz ride cymbalz china cymbalÚ
|
|||
|
|
tambourineÚcowbellz ride bellÚclapÚshakerÚbass1Úbass2ÚsnareÚesnrÚhatÚ closedhatÚpedalhatÚopenhatÚlotomÚlowtomÚmidtomÚhightomÚcrashÚrideÚchinaÚtambÚcowÚstickç g À_@c óê € V ^ 8 d \ R4 h\ V ^, .4 pV ^, p V ' d+ VP V ^, ^€, 4 V ^, p K2 \ \ V4 4 # )z1Encode an int as a MIDI variable-length quantity.z delta times cannot be negative)Ú
|
|||
|
|
ValueErrorÚ bytearrayÚappendÚbytesÚreversed)ÚnÚouts & Ú+/root/midi-playlist/tests/../lib/midikit.pyÚvlqrB b s^ € àˆ1„uÜÐ9Ó:Ð:Ü
|
|||
|
|
�Q˜•X�JÓ
|
|||
|
|
€C؈!…G€Aß
|
|||
|
|
Ø �
|
|||
|
|
‰
|
|||
|
|
�A˜•H Õ$Ô%Ø ˆa�ŠÜ ”˜#“ Ó Ð ó c ó¶ € ^ p W, pV^,
|
|||
|
|
pV^, V^, , pV^€, ' g W!3# V\ V 4 8¼ g KM \ R4 h)z4Decode a VLQ at data[pos]; returns (value, new_pos).z
|
|||
|
|
truncated VLQ)Úlenr: )ÚdataÚposÚvalueÚbs && rA Ú parse_vlqrJ n sT € à
|
|||
|
|
€EØ
|
|||
|
|
Ø �IˆØ ˆq�ˆØ˜!• D¥Õ)ˆØ�4�xŒxØ�:Ð Ø ”#�d“)Ö Ü ˜_Ó-Ð -rC c ó* € V P 4 p ^pV\ V 4 8 d5 W, P 4 ' g W, R8X g V^,
|
|||
|
|
pKD V ^ , P 4 V ^V \ WR 4 rCpR^ R^R^R^R^R^ R ^ /V, pWSP R
|
|||
|
|
4 ^VP R 4 , , ,
|
|||
|
|
pWSP R 4 ^VP R
|
|||
|
|
4 , , , pV^, ^ , V, # )z1'A4', 'C#5', 'Bb3' -> MIDI note number. A4 == 69.Ú-NÚCÚDÚEÚFÚGÚAÚBÚ#ÚsrI Úf)ÚstriprE ÚisdigitÚupperÚintÚcount)ÚnameÚiÚletterÚ
|
|||
|
|
accidentalÚoctaveÚbases & rA Únoterb { sê € à �:‰:‹<€DØ €AØ
|
|||
|
|
Œc�$‹iŒ- ¥§ ¡ ×!2Ò!2°dµgÀ´nØ ˆQ�ŠØ!% a¥§ ¡ £ °$°q¸°)¼SÀÀbÀ»]˜€FØ ��C˜˜C C¨¨C°°C¸¸CÀÐ DÀVÕ L€DØ× Ñ ˜SÓ ! A¨
|
|||
|
|
×(8Ñ(8¸Ó(=Õ$=Õ =Õ=€DØ× Ñ ˜SÓ ! A¨
|
|||
|
|
×(8Ñ(8¸Ó(=Õ$=Õ =Õ=€DØ �Q�J˜"Õ ˜tÕ #Ð#rC c ód € . ROpW^ , , \ V ^ , ^,
|
|||
|
|
4 , # )z%MIDI note number -> 'C#5' style name.) rM zC#rN zD#rO rP zF#rQ zG#rR zA#rS )Ústr)ÚpÚnamess & rA Ú note_namerg ˆ s% € â M€EØ �R•�=œ3˜q B�w¨�{Ó+Õ +Ð+rC c óD a € ] tR t^Žt o RtRtR t]R 4 tR t Rt
|
|||
|
|
V t R# )ÚMPQNz?A tempo change: microseconds per quarter note at absolute tick.c ó € Wn W n R # ©N©ÚtickÚmpqn)Úselfrm rn s &&&rA Ú__init__Ú
|
|||
|
|
MPQN.__init__’ s € ØŒ ØŽ rC c óF € V ! V\ \ R V, 4 4 4 # ©i ‡“)rZ Úround)Úclsrm Úbpms &&&rA Úfrom_bpmÚ
|
|||
|
|
MPQN.from_bpm– s € á�4œœU :°Õ#3Ó 4Ó5Ó6Ð6rC c ó( € R V P , # rs )rn ©ro s &rA rv ÚMPQN.bpmš s € ؘDŸI™IÕ%Ð%rC )rn rm Nrl ) Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__firstlineno__Ú__doc__Ú __slots__rp Ú classmethodrw rv Ú__static_attributes__Ú__classdictcell__©Ú
|
|||
|
|
__classdict__s @rA ri ri Ž s0 ø‡ € ÙIØ €Iòð ñ7ó ð7÷&ð &rC ri c ó¢ a € ] tR t^žt o RtRR ltR tRR ltRR ltRR lt RR lt
|
|||
|
|
RR lt RR
|
|||
|
|
lt RR lt
|
|||
|
|
RR ltR
|
|||
|
|
tR tR tR tR tRtV tR# )ÚTracku A musical track: notes, controllers, pitch bends, meta, in absolute ticks.
|
|||
|
|
|
|||
|
|
All events are stored with absolute tick positions and sorted on write,
|
|||
|
|
so you can compose out of order — melody first, then bass, then fix
|
|||
|
|
velocities — without worrying about delta-time bookkeeping.
|
|||
|
|
Nc ó, € Wn W n . V n R # rk )r\ ÚchannelÚevents)ro r\ rŠ s &&&rA rp ÚTrack.__init__¦ s € ØŒ Ø Œ ؈Ž rC c ó@ € V P P WV34 R # rk )r‹ r< )ro rm ÚorderÚpayloads &&&&rA Ú_addÚ
|
|||
|
|
Track._add¬ s € Ø � ‰ ×јD¨Ð1Ö2rC c ó € Vf
|
|||
|
|
V P MTpV P V^\ ^�V, V^, \ ^\ V4 4 ^, .4 4 V P W, ^ \ ^€V, V^, ^ .4 4 V # )zJNote on at tick, off at tick+duration. Overlap-safe (running-status-free).)rŠ r� r= ÚmaxrZ )ro rm ÚpitchÚdurationÚvelocityrŠ Úchs &&&&&& rA rb Ú
|
|||
|
|
Track.note° sq € à $š_ˆT�\Š\°'ˆØ � ‰ �$˜œ5 $¨¥)¨U°T\¼3¸qÄ#ÀhÃ-Ó;PÐSWÕ;WÐ!XÓYÔZØ � ‰ �$•/ 1¤e¨T°BY¸À½ ÀaÐ,HÓ&IÔJ؈ rC c óD € V F w r4rVV P W4WVV4 K V # )z0seq of (tick, pitch, duration, velocity) tuples.)rb )ro ÚseqrŠ Útre ÚdÚvs &&& rA ÚnotesÚ Track.notes· s% € ã ‰JˆA�!Ø �I‰I�a˜A 'Ö *ñ àˆ rC c óä € Vf
|
|||
|
|
V P MTp\ V\ 4 ' d \ VP 4 , pV P V^ \
|
|||
|
|
^ÀV, V^, .4 4 V # rk )rŠ Ú
|
|||
|
|
isinstancerd ÚGMÚlowerr� r= )ro rm ÚpatchrŠ r— s &&&& rA ÚprogramÚ
|
|||
|
|
Track.program½ sU € Ø $š_ˆT�\Š\°'ˆÜ �eœS× !Ò !Ü�u—{‘{“}Õ%ˆEØ � ‰ �$˜œ5 $¨¥)¨U°T\Ð!:Ó;Ô<؈ rC c
|
|||
|
|
ó’ € Vf
|
|||
|
|
V P MTpV P V^ \ ^°V, V^, V^, .4 4 V # rk )rŠ r� r= )ro rm Ú
|
|||
|
|
controllerrH rŠ r— s &&&&& rA ÚccÚTrack.ccÄ s? € Ø $š_ˆT�\Š\°'ˆØ � ‰ �$˜œ5 $¨¥)¨Z¸$Õ->ÀÈÅ Ð!MÓNÔO؈ rC c
|
|||
|
|
óì € Vf
|
|||
|
|
V P MTp\ R\ R\ V4 4 4 R, pV P V^ \ ^àV, V^, V^, ^, .4 4 V # )z value -8192..8191 (0 = centre).é éÿ i àÿÿ)rŠ r“ ÚminrZ r� r= )ro rm rH rŠ r— r� s &&&& rA Ú
|
|||
|
|
pitch_bendÚTrack.pitch_bendÉ s^ € à $š_ˆT�\Š\°'ˆÜ �”s˜4¤ U£Ó,Ó -°Õ 4ˆØ � ‰ �$˜œ5 $¨¥)¨Q°X¸¸Q½À$µÐ!GÓHÔI؈ rC c ó€ € \ R\ RW$, 4 4 pV P V\ VR, 4 V4 # )zBBend to a semitone offset (assumes pitch-bend range = range_semi).ç ð?r g ð¿)r“ r® r¯ rZ )ro rm Ú semitonesrŠ Ú
|
|||
|
|
range_semiÚfracs &&&&& rA Úbend_toÚ
|
|||
|
|
Track.bend_toÐ s4 € ä�4œ˜S )Õ"8Ó9Ó:ˆØ�‰˜t¤S¨°Ó%5°wÓ?Ð?rC c ó( € V P V^ V4 # ©é )r¯ )ro rm rŠ s &&&rA Ú
|
|||
|
|
bend_resetÚTrack.bend_resetÕ s € Ø�‰˜t Q¨Ó0Ð0rC c
|
|||
|
|
ó‚ € V P V^ \ ^ÿV.4 \ \ V4 4 , V, 4 V # r¹ )r� r= rB rE )ro rm Ú type_byterF s &&&&rA ÚmetaÚ
|
|||
|
|
Track.metaÙ s3 € Ø � ‰ �$˜œ5 $¨ Ð!2Ó3´c¼#¸d»)³nÕDÀtÕKÔL؈ rC c óF € V P V^VP R4 4 # )é úlatin-1©r¿ Úencode©ro rm rU s &&&rA ÚtextÚ
|
|||
|
|
Track.textÝ ó € Ø�y‰y˜˜t Q§X¡X¨iÓ%8Ó9Ð9rC c óF € V P V^VP R4 4 # )é rà rÄ rÆ s &&&rA ÚmarkerÚ Track.markerà rÉ rC c ó( € V P 4 ^cR3# )éc s ÿ/ )Ú _max_tickrz s &rA Ú_endÚ
|
|||
|
|
Track._endä s € Ø—‘Ó " oÐ6Ð6rC c ó> € \ R V P 4 ^ R7 # )c 3 ó, " € T F
|
|||
|
|
w p q!x € K R # 5irk © )Ú.0r› Ú_s & rA Ú <genexpr>Ú"Track._max_tick.<locals>.<genexpr>è s é € Ð1¡[™'˜!˜Q ”A£[ùs ‚)Údefault)r“ r‹ rz s &rA rÐ ÚTrack._max_tickç s € ÜÑ1 T§[¢[Ó1¸1Ô=Ð=rC c ó0 € \ V P V P 4 ., R R7 p\ 4 pV P ' dh V\ ^ 4 \
|
|||
|
|
^ÿ^.4 , \ \ V P 4 4 , V P P R4 , ,
|
|||
|
|
p^ pV F' w rEpV\ WC,
|
|||
|
|
4 V, ,
|
|||
|
|
pTpK) R\ P ! R\ V4 4 , \
|
|||
|
|
V4 , # )c ó& € V ^ , V ^, 3# r¹ rÕ )Úes &rA Ú<lambda>Ú Track.build.<locals>.<lambda>ë s € ÀAÀaÅDÈ!ÈAÍ$Á<rC ©Úkeyrà ó MTrkú>I) Úsortedr‹ rÑ r; r\ rB r= rE rÅ ÚstructÚpack)ro r‹ r@ Úlastrm Ú_orderr� s & rA ÚbuildÚ Track.buildê sÇ € ܘŸ ™ t§y¡y£{ mÕ3Ñ9OÔPˆÜ‹kˆØ �9�9ˆ9Ø ”3�q“6œE 4¨ ,Ó /Õ/´#´c¸$¿)¹)³nÓ2EÕEÈÏ É ×HXÑHXÐYbÓHcÕcÕ cˆC؈Û%+Ñ !ˆD˜'Ø ”3�t•{Ó# gÕ-Õ -ˆCØŠDñ &,𠜟š T¬3¨s«8Ó4Õ4´u¸S³zÕAÐArC )rŠ r‹ r\ )Nrº )éd Nrk )Né )rC )r| r} r~ r r€ rp r� rb rž r¥ r© r¯ r¶ r» r¿ rÇ rÌ rÑ rÐ rê rƒ r„ r… s @rA rˆ rˆ ž s] ø‡ € ñôò 3ôôô ôô
|
|||
|
|
ô@ô
|
|||
|
|
1ôò:ò:ò7ò>÷ Bð BrC rˆ c óP a € ] tR t^öt o RtR
|
|||
|
|
R ltR tR tR R ltR t R t
|
|||
|
|
Rt V t R # ) ÚMidiFilezŠFormat 1 multi-track SMF. A conductor track is added automatically
|
|||
|
|
from the tempo map so tempo/key/time live in their own track (GM-safe).c óJ € Wn . V n . V n R V n R V n R # rk )ÚtpqÚtracksÚtemposÚkey_sigÚtime_sig)ro rñ s &&rA rp ÚMidiFile.__init__ú s# € ،؈Œ ؈Œ ؈Œ Ø ˆŽ
|
|||
|
|
rC c ó< € V P P V4 V# rk )rò r< )ro Útracks &&rA Ú add_trackÚMidiFile.add_track s € Ø � ‰ ×ј5Ô!؈ rC c ó& € \ V4 V n R# )z=Set the tempo map; build() renders it into a Conductor track.N)Úlistró )ro ró s &&rA Úadd_tempo_trackÚMidiFile.add_tempo_track s
|