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

NAME

Data::iRealPro - Convert iRealBook/iRealPro data

SYNOPSIS

  irealcvt iRealPro_exported.html --output formatted.pdf
  irealcvt iRealPro_exported.html --output formatted.png
  irealcvt iRealPro_exported.html --output song.mma
  irealcvt iRealPro_exported.html --output raw.json
  irealcvt iRealPro_exported.html --output editable.txt
  irealcvt iRealPro_exported.html --output importable.html
  irealcvt iRealPro_exported.html --generate Forum --output forumpost.txt
  irealcvt iRealPro_exported.html --list

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.

MusicXML input is possible if the module XML::LibXML is available.

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 irealcvt is provided to perform conversions on the command line.

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

A NOTE ABOUT WRITTEN KEY AND PLAYING KEY

In iRealPro you can write a song in a specific key, and play it in a different key. The formatter backends PDF and PNG will show the song in the key it was played, just like iRealPro when it is playing your song.

The JSON and Text reflect the raw data of the song and will show the song in the key it was written, just like iRealPro when you are editing the song.

REQUIREMENTS

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

Image generation requires Imager. This is optional.

The web backend irealpro.cgi requires Template::Tiny.

AUTHOR

Johan Vromans, <jv at cpan.org>

SUPPORT

The development of this module is hosted on GitHub, repository https://github.com/sciurius/perl-Data-iRealPro.

Please report any bugs or feature requests to the GitHub issue tracker, https://github.com/sciurius/perl-Data-iRealPro/issues.

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,2019 Johan Vromans, all rights reserved.

Clone me at GitHub