Johan Vromans
and 1 contributors


Data::iRealPro - Convert iRealBook/iRealPro data


  irealcvt iRealPro_exported.html --output formatted.pdf
  irealcvt iRealPro_exported.html --output formatted.png
  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 --list


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:


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.


Johan Vromans, <jv at>


Please report any bugs or feature requests to bug-music-irealpro at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


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

    perldoc Data::iRealPro


Massimo Biolcati of Technimo LLC, for writing iRealPro.

The iRealPro community, for contributing many, many songs.


Copyright 2013,2017 Johan Vromans, all rights reserved.

Clone me at GitHub