This project is not covered by Drupal’s security advisory policy.

The Songbook module integrates the https://github.com/intelektron/chordpro-php library into Drupal 🎸.

It provides a content filter to parse ChordPro 6.x format. This way, you can create a professional songbook with few clicks.

Features:

  • Parsing and output of multiple chord notations (French, like Do, Ré, Mi, or German, like H, Fis, or custom ones).
  • Various output formats (HTML, JSON, Monospace), and the possibility to define custom ones.
  • Read ChordPro metadata. You can define song information and organize songs into sections.

Songbook

Installation:

Install the module along with the intelektron/chordpro-php library (please don't confuse it with an older library from @nicolaswurtz). The Composer will install any dependencies automatically.

To start using the module, create a new text format and enable the Parse as a ChordPro song with chords filter. The CKEditor will no longer be available for this field, it will appear as a textarea in the node edit form.

ChordPro format:

The supported syntax is described in the README.md file of the chordpro-php library.

{t:A Song}
{key:C}
[C]This is the [Dm]beautiful [Em]song
I [Dm]wrote in [F/G]Chordpro for[C]mat [Dm/F]

{soc}
[F] [G] [C]This is the refrain
{eoc}

Defining custom formatters and notations:

If you have your own classes extending ChordNotationInterface or FormatterInterface, please see songbook.api.php file for alter hook usage instructions.

AttachmentSize
songbook.png479.09 KB

Project information

Releases