Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Songbook

No security coverage Under active development 9 sites

This module allows you to create a songbook by parsing songs written in the ChordPro format. It supports various chord notations and output formats, and can read metadata for organizing your songs.

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.

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.

Drupal 10–11

Ask your assistant about Songbook

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

  • filter Drupal core

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
4
Tracked since
Jan 2024
Latest release
2 years ago
Releases (12 mo)
0
Maintenance
Dormant

Release Timeline

Releases

Version Type Core PHP Release date
1.0.2 Stable 10–11 May 20, 2024
1.0.1 Stable 10 Jan 17, 2024
1.0.0 Stable 10 Jan 16, 2024
1.0.x-dev Dev 10–11 Jan 16, 2024