Off grid MIDI editor with following goals:
- Not a DAW: MIDI is the input, MIDI is exported (I would like it to be but will not have enough time for that).
- Do not care (much) about measures. Primarily aimed at piano real time recordings without explicit tempo/bars.
- A feature absent in other midi editors I could get my hands on (both commercial and free ones): removing a piece of MIDI recording as one can remove a time fragment from PCM recording. For some odd reason DAW authors insist on handling MIDI recordings differently from PCM sound recordings. In some editors this is doable but cumbersome at best.
- Playing/editing very long (up to about 25K of playable events) files. Those files are usually recordings of real performances (e.g. from a MIDI keyboard).
- Comfortable workflow with keyboard.
- Allows making fine adjustments of notes and tempo.
- Unlimited undo/redo. Never loose session data. Non destructive edits, do not override original files.
- Flight recorder (always-on MIDI recording).
I'd love this to be in one of commercial or open-source DAWs and pay money for that, but I do not see it happening.
Somewhat usable, no documentation yet (e.g. hot-keys, launching need to be described). The code still needs major revamps.
In case you get "No package 'freetype2' found" on Linux
apt install libxft-dev.
ALSA wrapper dependency
apt install libasound2-dev.
As an VST synth plugin you can use amsynth, for example.
I personally use Pianoteq, but that is a commercial product.
- Location history navigation (e.g. go to a bookmark that was visited recently), with Alt + LeftArrow / RightArrow
- Adjust tempo for a selection.
- Time marks on stave ("minute:second" from the beginning).
- Minimize use of unwrap. The biggest contention currently is event data shared between engine and stave. Maybe can do this with async or sending update commands to the engine thread (e.g. can just swap to new track copy in the engine's events source after edits).
- Multi-track UI (for snippets, flight recorder, and copy/paste buffer). Can show only one at a time, though. Use tabs?
- Copy/cut/paste notes and time ranges (should also be supported between tracks).
- (refactoring) Reduce number of range types (preferring util::Range?)
- Zoom to fit whole composition.
- (refactoring) Organize commands (keep hotkeys/actions in a collection or registry). This should make the handle_commands easier to read and enable to have a generated cheatsheet/help UI.
- Flight recorder (always record what is coming from the MIDI controller into a separate file or track).
- (improvement) Ensure changes are visible even when zoomed out (the events may be too small to be visible as is).
- (improvement) When start playing send current CC values (will help damper to take effect immediately, not on next change).
- Remove VST2 dependency. Using MIDI sequencer port instead.
- Highlight undo/redo changes (implemented for notes, need also to emphasise CC values).
- Visual hint for out-of-view selected notes. Scroll to the earliest of the selected notes on an action, if none of them are currently visible.
- Optimize undo history 2: save only minimal diff instead of the whole track.
- Show (scroll to) changing objects before undo/redo. Should scroll some changes into view before animation on an undo/redo command if none are currently visible.
- Reduce diff disk usage.
- Consider TransportTime to be signed (see also StaveTime). There are too many conversions forth and back.
- Persist bookmarks in project.
- Have a separate edit-position and play-start cursors (time bookmarks), so it is easier to jump back and listen to the modified version.
- Optimize undo history: avoid O(N) algos; batch fast similar commands (e.g. tail or note shifts) saving at most 2-3 snapshots a second per streak; do not save a new snapshot when there are no changes.
- Automatically create an undo snapshot on every edit command.
- Select none/clear selection command
- Editing sustain events.
- Note input (with mouse).
- Note selection.
- Simple undo/redo.
- Time selection.
- Configuration file (VST plugin path and MIDI input configuration).
- Transport controls (play/pause, rewind, pause).
- Support sustain pedal (as a note?).
- Play time cursor.
- Scale stave time (horizontally) with mouse wheel.
- Share project's note data between stave pane and engine.
- See how to use a hot key for an action.
- A UI window with simple text message.
- Load/decode a MIDI file.
- Load a MIDI->PCM plugin (https://github.com/RustAudio/vst-rs/blob/master/examples/simple_host.rs).
- Play MIDI.
- Show MIDI pane.
- Piano roll.
- Paint notes.
Also, some big scary problems
- May need to use midi events directly (instead of intermediate internal representation). E.g.
track::from_midi_eventsmay not be necessary. In particular tail shifts will become simpler. This will require- To handle ignored/unused events along with notes and sustain.
- Midi events have starting times relative to previous ones. May need some indexing mechanism (e.g. a range tree) that would help to find absolute timings of the midi events, and connect beginnings and endings of notes. MIDI allows overlapping notes index should be able to handle that.
- Optimize rendering drawing only visible items, may also need some index. In the simplest casevisible notes can be determined when zoom changes, and then re-use the visible set.
- Optimize engine to reduce CPU usage - may need to switch to some async framework (
tokio).
Have to explore following options for the further development
- Use Tokio for scheduling instead of explicitly spinning in a thread.
- Ideally, the editor should be a part of some open source DAW. I found one that is written in Rust, MeadowlarkDAW. It is open source but not a collaborative project (as stated in its README).
Unless stated otherwise
- Integer-typed times are in microseconds.
- Ranges assumed to be half open, excluding end (upper bound) value.
SMD - Standard MIDI File.
Rodio and other libraries use interleaved stream format: 1st sample of each channel, then 2nd sample of each channel, and so on (ch1s1, ch2s1, ...., ch1s2, ch2s2, ....). This seems to be a convention but is not documented anywhere for some reason.
Diagnostic commands
amidi --list-devicesaseqdump --listaseqdump --port='24:0'
MIDI CC controller ids list