DragonFly On-Line Manual Pages

SMFSH(1)                                                              SMFSH(1)

NAME
       smfsh - SMF shell

SYNOPSIS
       smfsh [ -V ] [ file ]

OPTIONS
       -V     Print libsmf version and exit.

       file   Load the file.

DESCRIPTION
       smfsh, 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 others.

SMF LEVEL COMMANDS
       SMF level commands display or change properties of smf (i.e. the MIDI
       file) as a whole.

       save file
              Save a file.  If the file name is not given, the last file name
              is used.

              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 used.

              Instead of using "load", you can pass the file name on the
              command line.

       ppqn new-ppqn
              Show (if used without parameter) or change PPQN (Pulses Per
              Quarter Note, aka Division).

       format new-format
              Show (if used without parameter) or change format.

       tempo  Show tempo map.  Tempo map is computed automatically from the
              SMF contents - to modify a tempo, just add a Tempo Change event
              using "add" command.

       length Show total length of the song.  Just like the tempo map, file
              length is computed from the SMF contents.

TRACK LEVEL COMMANDS
       Track level commands display or change properties of tracks.  SMF may
       contain one or more tracks.

       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.

       trackadd
              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
       Event level commands display or change properties of events.  Events
       are grouped into tracks.  Track may contain any number of events,
       including zero.

       events 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 midi-message-as-hex
              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.

OTHER COMMANDS
       There are three commands in the "other" category - "help", "version",
       and "exit".  Their meaning should be self expanatory.

smfsh 1.3                        21 March 2010                        SMFSH(1)