NAME

irealcvt - parse and convert iRealPro data

SYNOPSIS

irealcvt [options] file [...]

 Options:

    --output=XXX        Desired output file name.
                        File name extension controls the output type.
    --select=NN         Select a single song from a playlist.
    --list              Prints the titles of the songs from a playlist.
    --split             Splits the songs from a playlist into individual
                        HTML files. Use --dir to control where the
                        files will be written.
    --dir=XXX           Specifies the result directory for --split.
    --npp=[hand|standard]       Near pixel-perfect output.
    --transpose=[+-]NN  -x      Transpose up/down semitones.
    --[no]toc           Produces [suppresses] the table of contents.

Miscellaneous options:

    --help  -h          this message
    --man               full documentation
    --ident             show identification
    --verbose           verbose information

DESCRIPTION

This program will read the given input file(s) and parse them. The input files are assumed to contain valid iRealPro data as exported by the iRealPro app on Android and iOS.

If Multiple input files are given, their contents will be combined into a single playlist, named after the first playlist or, if the first file contains a single song, the title of this song.

Finally, the resultant playlist is converted. Several conversions are possible:

PDF

Produces a single PDF document containing a nicely formatted version of the songs.

PNG

Produces one or more PNG files, one for each song. The contents of the PNG is visually identical to the PDF.

Optionally, a 'near pixel perfect' PNG may be produced that is near pixel perfect identical to the images generated by the iRealPro app. See the --npp option for details.

See also "NPP IMAGING".

JSON

This is basically a low-level representation of the contents of the songs.

TEXT

This is a textual, editable representation of the contents of the songs. It may be edited and used as input to this program for further processing.

HTML

A single HTML document very similar to the documents exported by the iRealPro app itself.

Optionally, a playlist can be split (see --split) into a series of HTML documents each containing one song. The documents are named after the song title and can be stored in a separate directory (see --dir).

OPTIONS

--output=XXX

Specifies the desired output file name.

The file name extension controls the output type.

--select=NN

Selects a single song from a playlist.

--list

Prints the titles of the songs from a playlist.

Output defaults to standard output.

--split

Splits the songs from a playlist into individual HTML files. Use --dir to control where the files will be written.

Note: --output is ignored.

--dir=XXX

With --split, specifies the directory where the individual HTML files will be written.

--npp=variant

With PNG output, produces near pixel-perfect iRealPro output.

variant must be 'hand' (for the hand-written style) or 'standard'.

Add a minus at the end of the variant to select to get minor chords with an 'm' instead of the default '-'.

See also "NPP IMAGING".

--transpose=[+-]NN -x

Transposes up/down semitones.

Currently implemented for PDF and PNG output only.

--[no]toc

With PDF output, produces or suppresses the table of contents.

By default, A ToC is automatically generated if a playlist contains more than one song.

--help

Prints a brief help message and exits.

--man

Prints the manual page and exits.

--ident

Prints program identification.

--verbose

Provides more verbose information.

file

The input file(s) to process.

NPP IMAGING

To enable pixel perfect images some proprietary files from the iRealPro app are required. For copyright reasons, these files cannot be included with this program. I'm working on a solution.

AUTHOR

Johan Vromans, <jv at cpan.org>

BUGS

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

SUPPORT

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

    perldoc irealcvt

ACKNOWLEDGEMENTS

Massimo Biolcati of Technimo LLC, for writing iRealPro.

The iRealPro community, for contributing many, many songs.

COPYRIGHT & LICENSE

Copyright 2013,2016 Johan Vromans, all rights reserved.

Clone me at GitHub