The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

midi-tweak - Tweak MIDI files

SYNOPSIS

  midi-tweak --pitch    --int=NN                      [file ...]
  midi-tweak --volume   { --ratio=N.NN | --value=NN } [file ...]
  midi-tweak --velocity { --ratio=N.NN | --value=NN } [file ...]
  midi-tweak --tempo    { --ratio=N.NN | --value=NN } [file ...]

OPTIONS

One of the following options must be supplied:

--pitch

Changes the pitch with NN intervals. NN may be negative.

This option requires --int to be specified as well.

--volume

Changes the volume of all channels to NN or with ratio N.NN.

This option requires either --value or --ratio to be specified as well.

--velocity

Changes the velocity of all notes to NN or with ratio N.NN.

This option requires either --value or --ratio to be specified as well.

--tempo

Changes the tempo NN (beatsa per minute) or with ratio N.NN.

This option requires either --value or --ratio to be specified as well.

The following options are optional unless required.

--int=NN

The number of intervals (semitones) to transpose. This may be a negative number. A fatal error will be generated when a transposed pitch value would become less than zero, or greater than 127.

--value=NN

Change the selected property to the given value. For volume and velocity the value must be between zero and 127, inclusive. For tempo, the value gives the number of beats per minute.

--ratio=N.NN

Change the selected property with the given ratio. A fatal error will be generated when the new value would be out of range.

--output=dir-or-file

Where the resultant file(s) must be stored. See below.

--help

Print a brief help message and exits.

--ident

Prints program identification.

--verbose

More verbose information.

file

Input file(s). Multiple files are possible. If no input files are given, the program will read standard input. Alternatively, the special file name - can be used to designate standard input.

DESCRIPTION

This program will read each input file, apply the selected MIDI::Tweak function on the contents, and writes the modified file out to disk.

The --output option controls where the modified files are written.

For single-file operation, the specified output option may be omitted, or designate a file or existing directory. If omitted, the modified data will be written to standard output. If specified, the modified data will be written to that file or directory. The special file name - can be used to designate standard output.

For multi-file operation, the output option must designate an existing directory, and the modified files will be written there.

If standard input is processed, the corresponding output file name will be stdin.midi.

AUTHOR

Johan Vromans, <jv@cpan.org>

BUGS

Please report any bugs or feature requests to bug-midi-tweaks at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MIDI-Tweaks. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

This program is part of the MIDI::Tweaks module.

You can find documentation for this module with the perldoc command.

    perldoc MIDI::Tweaks

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Johan Vromans, Squirrel Consultancy. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.