NAME

Data::iRealPro - Convert iRealBook/iRealPro data

SYNOPSIS

iRealPro iRealPro_exported.html --output formatted.pdf
iRealPro iRealPro_exported.html --output formatted.png
iRealPro iRealPro_exported.html --output raw.json

DESCRIPTION

iRealPro (previously named iReal-B) is a songwriting tool / electronic backup band for iPhone/iPad, Mac OSX and Android that lets you experiment with advanced chord progressions and arrangements quickly and easily. You can use iRealPro for songwriting experiments, as accompaniment when learning new songs or for making backing tracks for your guitar / saxophone / theremin solos.

iRealPro can import songs in one of two textual format formats. The 'irealbook' format is easily readable and straightforward. The official 'irealb' format is proprietary and uses some form of scrambling to hide the contents. iRealPro can export songs in the form of a HTML document that contains the data in big URLs, and some printable formats.

Data::iRealPro provides a set of modules that can be used to read and analyse iRealPro songs in URL format and convert them into something else, like PDF or PNG. A ready-to-use program iRealPro is provided to perform conversions on the command line.

iRealPro web site: http://www.irealpro.com.

REQUIREMENTS

PDF document generation requires PDF::API2. This is considered core functionality.

Image generation requires Imager. This is optional.

The web backend irealpro.cgi and the text converter irpcvt require Template::Tiny.

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 module with the perldoc command.

perldoc Data::iRealPro

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.

For the time being it is not possible to distribute this program as free software, since it uses reverse-engineered algorithms to analyse the iRealPro song data.