forked from michthom/MIDI-to-CNC
-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.txt
141 lines (106 loc) · 9.84 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
--------------------------------------------------
Convert with GUI:
..................
How to use:
Run Convert_with_GUI.py
Some windows will appear and ask you your machine type, what midi file to convert and what location/name your gcode file should have
The verbose option will print the whole midi parsing process
There seems to be a bug that makes the input windows appear behind other windows. So if nothing happens, try minimizing some stuff...
IMPORTANT: For some reason you can't have spaces in your path and filename otherwise it trhows an error...
For example C:/.../Test folder/... will not work. But C:/.../Test_folder/... will be ok.
Same with filenames like "test midi.mid" that will not work while "test_midi.mid" will.
(Also the code behind I wrote is ugly, using python to start a windows commandline that starts a python script feels wrong.)
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------------------------------------------
Mid2CNC:
..............
THIS PROGRAM COMES WITH NO WARRANTY
PLEASE KEEP AN EYE ON YOUR MACHINE AS THE
GENERATED CODE MAY BRING YOUR BUILD PLATFORM OFF LIMITS
usage: mid2cnc.py [-h] [-infile [INFILE]] [-channels N [N ...]]
[-outfile [OUTFILE]]
[-machine {cupcake,custom,shapercube,thingomatic,ultimaker}]
[-units {imperial,metric}] [-ppu XXX.XX YYY.YY ZZZ.ZZ]
[-safemin XXX.XX YYY.YY ZZZ.ZZ]
[-safemax XXX.XX YYY.YY ZZZ.ZZ] [-prefix [PRE_FILE]]
[-postfix [POST_FILE]] [-axes XYZ] [-verbose]
Utility to process a Standard MIDI File (*.SMF/*.mid) to "play" it on up to 3
axes of a CNC machine.
optional arguments:
-h, --help show this help message and exit
Input settings:
-infile [INFILE], --infile [INFILE]
the input MIDI filename (default: ./input.mid)
-channels N [N ...], --channels N [N ...]
list of MIDI channels you want to scan for event data
(default: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,
13, 14, 15])
-outfile [OUTFILE], --outfile [OUTFILE]
the output Gcode filename (default: ./output.gcode)
Machine settings:
-machine {cupcake,custom,shapercube,thingomatic,ultimaker}, --machine {cupcake,custom,shapercube,thingomatic,ultimaker}
sets everything up appropriately for predefined
machines, or flags use of custom settings. (default:
cupcake)
Customised settings:
-units {imperial,metric}, --units {imperial,metric}
set the measurement and feed rate units to your
preferred scheme. (default: metric)
-ppu XXX.XX YYY.YY ZZZ.ZZ, --ppu XXX.XX YYY.YY ZZZ.ZZ
set arbitrary pulses-per-unit (ppu) for each of the X,
Y and Z axes (default: None)
-safemin XXX.XX YYY.YY ZZZ.ZZ, --safemin XXX.XX YYY.YY ZZZ.ZZ
set minimum edge of the safe envelope for each of the
X, Y and Z axes (default: None)
-safemax XXX.XX YYY.YY ZZZ.ZZ, --safemax XXX.XX YYY.YY ZZZ.ZZ
set maximum edge of the safe envelope for each of the
X, Y and Z axes (default: None)
-prefix [PRE_FILE], --prefix [PRE_FILE]
A file containing Gcode to set your machine to a known
state before the MIDI is played e.g. homing the axes
if supported or required. (default: None)
-postfix [POST_FILE], --postfix [POST_FILE]
A file containing Gcode to return your machine to a
known state after the MIDI is played e.g. homing the
axes if supported or required. (default: None)
Output settings:
-axes XYZ, --axes XYZ
ordered list of the axes you wish to "play" the MIDI
data on. e.g. "X", "ZY", "YZX" (default: XYZ)
-verbose, --verbose print verbose output to the terminal (default: False)
=====
Please join our Mailinglist at:
http://groups.google.com/group/makerbotmusic
and post your working tunes to the MakerBot Wiki:
http://wiki.makerbot.com/makerbot-music
====
Have fun and set all axes to MUSICCCCC!
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
---------------------------------------------------------------------------------------------
Midiparser (info on how to optimize midi files for best results)
............
mid2cnc - a MIDI to CNC G-code converter
This script reads in a standard or General MIDI file and calculates the feedrates and vectors that will yield the correct note frequencies (up to 3-note polyphony) on a CNC mill's axis motors.
Usage:
Set desired input/output file name, machine limits, and steps per inch (steps per rotation * leadscrew threads per inch) in mid2cnc.py. 200 steps per rotation and 6 or 10 threads per inch are probably the most common configurations. If in doubt, check the manual and/or your build logs.
Choose which MIDI channels to import
Ensure your machine is configured to the same steps per inch as the script.
If your machine controller performs smooth acceleration for linear moves, turn this off (set acceleration to infinity or other suitably large number)
* * * * * * * * *
WARNING: Limits are checked only between notes. Typical songs have at least one MIDI event regularly enough that this is not a problem, however it is possible for a single, uninterrupted note/chord to exceed the limits/safety and crash your machine. Doublecheck the ACTUAL output (X,Y,Z) and that your limit switches are in good working order.
WARNING: You use this program at your own risk. There may be bugs, errors, poor documentation leading to user error, and any other factors that could cause undesirable operation of your machine or damage to your machine. You should inspect the input and output files carefully to ensure the resulting file does not exceed the limits of your mill. Remember, your mill is designed for milling and not playing music, and the motions necessary to produce wicked tunes with it (e.g. infinite acceleration / rapid changes of direction) are probably not good for your machine in the long run.
* * * * * * * * *
Now that that is out of the way...
This is written for 3 axis, XYZ machines. If the input MIDI specifies more than 3 notes played simultaneously, three will be chosen arbitrarily. The results may not sound good. For best results, pick off unwanted notes in a MIDI editor before exporting. In a pinch, you can ignore entire tracks/instruments by removing them from the list at the start of the script.
Remember, MIDI stores music as a sequence of events, in the form of the event codes themselves and the delta time since the last event. This script computes chords/vectors as they exist at each unique delta time. Such events include minor or useless (to you) stuff such as changes to key pressure, lyrics display, tempo shifts, and drums / other events on ignored channels. Thus, any time ANY new channel event occurs (splitting up the event deltas), the motion vector gets split up too, resulting in a new line of gcode, an unpleasant pause of the machine between these lines, and possible frequency inaccuracies for short moves. Even if none of the notes being played have actually changed. So it is in your best interest to remove the drum tracks and any other unwanted/unplayable notes in a MIDI editor before converting. Ignoring the channel is not the same as removing the drums outright, since they will still be in the file and splitting up the deltas for notes you want.
If you have a fancy machine with pneumatic tool change or clickable relays for functions which can be controlled via gcode, you *could* implement the percussion as well. This is left as an exercise to the reader, but look at the first loop at the top of the file, which builds the table of 'interesting' events from the MIDI parser, and the second loop which goes through this list chronologically and determines which notes are active at each new delta.
Some notes / things I have discovered:
About half of all MIDIs pulled off the internets (published 1997, or whenever) are broken (bytes identifying the length of structures in the file don't match the actual structure lengths), causing the parser to crash with an error about a subscript out of range. Try opening in a good MIDI editor and re-saving. (While you're in there, delete those drum tracks as well...)
MIDIs for popular songs pulled from the Internet very often set or clear the same note multiple times in a row - possibly due to mistrust of the controller, or more likely (for multiple note-on) changes to key pressure. mid2cnc will warn about this, since it seems like an error (e.g. "tried to turn off note that wasn't on!"), but if the results sound OK you can safely ignore them.
This script currently only supports regular MIDI timing, not absolute / SMPTE / etc. These are indicated with a negative(!) tempo. I haven't found any files that use these yet, so I don't know what happens if one is encountered. Expect bad things to happen.
In addition to turning off notes using the appropriately-named Note Off command, some MIDI controllers turn off by sending a duplicate Note On command with the volume set to 0. Both methods are valid according to the MIDI specs(?), and will have the desired effect in mid2cnc.py.
G-Code is not universally standardized; different controllers support slightly different dialects. It should work on most well-known controller software such as EMC2 and TurboCNC. This program assumes:
* Machine pauses (G04 Pxxxx) are in seconds or fractions thereof (some controllers might use milliseconds)
* Comments are specified between ( and )
* Ten decimal places' precision for numeric values