smfsh - SMF shell
] [ file
- Print libsmf version and exit.
- Load the file.
, an "SMF shell", is an interactive, command-driven
frontend to libsmf, useful for modifying MIDI files by hand. It started its
life as a debugging aid for libsmf.
There are four groups of commands: SMF level, track level, event level, and
SMF level commands display or change properties of smf (i.e. the MIDI file) as a
- save file
- Save a file. If the file name is not given, the last file name is
Note that this will not ask for confirmation.
- load file
- Load a file. If the file name is not given, the last file name is
Instead of using "load", you can pass the file name on the command
- ppqn new-ppqn
- Show (if used without parameter) or change PPQN (Pulses Per Quarter Note,
- format new-format
- Show (if used without parameter) or change format.
- Show tempo map. Tempo map is computed automatically from the SMF contents
- to modify a tempo, just add a Tempo Change event using "add"
- Show total length of the song. Just like the tempo map, file length is
computed from the SMF contents.
Track level commands display or change properties of tracks. SMF may contain one
or more tracks.
- Show the list of tracks in the SMF.
- track track-number
- Show details of a track (if called without parameter), or select track
with a given number - for example in order to display ("events")
the events it contains.
- Create new track.
- trackrm track-number
- Remove the track. If the track number is not given, this will remove the
track currently selected.
Event level commands display or change properties of events. Events are grouped
into tracks. Track may contain any number of events, including zero.
- Show the list of events in the current track.
- event event-number
- Show information about a current event (if used without parameter) or
select the event.
- add time-in-seconds
- Add new event to the currently selected track.
- rm event-number
- Remove the event. If the event number is not given, this will remove the
event currently selected.
There are three commands in the "other" category - "help",
"version", and "exit". Their meaning should be self