ChordPro 6.050

ChordPro 6.050 has been released

Highlights

• Customize the tables of content by providing a template. The template is processed as a song before the tables and can be used to set title, subtitle, columns, maybe even an introduction text. Since the template it iself a song, it can be associated with its own config file for unlimited customization. Read more...
• New delegated environment: textblock. The text between start_of_textblock and end_of_textblock is formatted normally, but the result is an image that can be placed anywhere. Several attributes are available to control the appearance of the text, e.g. centered and flush right. Read more...
• Delegate type may now also be 'omit' to omit the content of the section, and 'none' to treat the section a generic. Read more...

Functionality

• (Experimental) Add environment textblock.
• (Experimental) Add ToC templates.
• Wrap toc lines.
• (PDF) Allow strwidth and strheight to return both values at once.
• (Config) allow delegate types 'none' and 'omit'; remove 'omit' attribute.

Bug fixes

• Fix issue #265.
• Fix spread indent with labels.
• Fix issue #343.

Social and support

User community for feedback and help.
Please use the issue tracker for bugs reports.

ChordPro 6.042

ChordPro 6.042 has been released!

This is mainly a bug fix release, fixing some bugs before they catch you. See the 6.040 release notes for all new 6.04 features.

Important

To trace future problems, the ChordPro 'about' information is included in the PDF. This should not reveal sensitive information, but in case this bothers you, you can disable this by setting debug.runtimeinfo to 0 in the config.

Bug fixes

• Post-release typo fixes.
• (Stringdiagram) Fix font size of base fret numeral (issue 337).
• (Stringdiagram) Fix fret number colours.
• Fix handling of XDG_CONFIG_HOME.
• Fix 'spread' images.
• Fix problem finding notes:german et al.
• (MMA) Fix test fail with perl >= 5.39.6.

ChordPro 6.040

ChordPro 6.040 has been released!

Highlights

• Images can be placed everywhere. They can be placed relative to the paper, the page, the column, and the lyrics.
• Images can be embedded in text (lyrics) lines, either as part of the text similar to a glyph, or somewhere else on the page relative to a particular place in the text. The latter is most interesting for annotations.
• Delegates are images too. Annotate your lyrics with SVG images and musical notes using ABC or Lilypond.
• Chord and keyboard diagrams are images too. And you can use string and keyboard diagrams simultaneously.
• Resources like configs, tasks and images are now more logically searched using resource libraries.

ChordPro functionality

• Rework paths handling for consistent resource handling; eliminate App::Packager.
• Inline images.
• {image} can have label and align properties.
• {define}d chords overrules suppress list.
• (ABC) Use QuickJS XS (JavaScript::QuickJS) as preferred.
• (ABC) ABC embedding no longer uses nodeJS (npx).
• (ABC) Make split work (and enable by default).
• (ABC) Images are left aligned by default.
• (Lilypond) Images are left aligned by default.
• Improve runtime info.
• Suppress songs that do not have content.
• Suppress table of content entry for a song w/ {ns toc=no}.
• (PDF) Image scale strategy change for spread images.
• (PDF/Writer) Add generalized add_object for objects and images.
• (PDF) Prevent case problems when looking up fonts for SVG.
• (PDF) Add aliases for web standard fonts like serif, sans, ...
• (PDF) Ignore leading empty and ignores (was: leading empty only).
• (Windows) ChordPro now installs as a 64-bit application in \Program Files instead of \Program Files (x86). You are adsvised to remove the old 32bits install first.

Bug fixes

• Prevent warning when parsing {key} and trancode to nashville/roman.
• Fix chord inversion (issue 321).
• Fix comment lines disturbing a consecutive series of {chord}s.
• Fix typo in Wx Preferencesdialog, causing it to crash.
• Fix problem with PDF/SVG caching fonts.
• Fix comment labels for delegates (issue 329.3).
• (Wx) Filter configs on prp ans json.
• Fix memorize/recall/transpose issue 333.
• Fix issue 334.

Internal

• (ABC) ABC embedding use tohtml instead of toxhtml.
• (PDF) Enhance assets (wip), labels; move grid to separate module.
• Experimental ##include facility.

Social and support

User community for feedback and help.
Please use the issue tracker for bugs reports.

ChordPro 6.030

ChordPro 6.030 has been released!

Highlights

• ABC and Lilypond embedding now use SVG (vector graphics) instead of pixmap images. This is very crisp at all sizes, and greatly reduces the size of the resultant PDF document.
  No additional tools are required for embedding, except the abc2svg and lilypond tools. The installer kits for MS Windows and MacOS already include the abc2svg tool.
• The ChordPro GUI (wxchordpro) has been extended with a Tasks menu that can be used to quickly select presets for a specific task. For example, to produce a PDF with only lyrics, or with keyboard diagrams instead of string diagrams. User presets can be added by placing small config files in a tasks folder under the CHORDPRO_LIB.

ChordPro functionality

• Directives and config to change the chorus appearance.
• Add support for SVG images. Allow pdf.fonts.XXX as fonts in SVG.
• Handle ABC and Lilypond embedding via SVG images. No more need for ImageMagick. Add 'staffsep' option for ABC embedding.
• Add 'omit' to delegates config.
• Infer chord inversions for keyboard.
• Use SVGPDF text callback to substitute missing flat/sharp glyphs.
• Trap missing font sizes (should not happen).

Breaking changes

• The image scale strategy was changed to be more intuitive. See this forum message for details.

Experimental

• A primitive but effective docker based web app.

BugFixes

• Fix issue #297.
• Fix issue #298.
• Fix issue message/1780.
• Fix issue #300.
• Fix issue #301.
• Fix issue #309.
• Fix issue #311.

Social and support

User community for feedback and help.
Please use the issue tracker for bugs reports.

ChordPro 6.020

ChordPro 6.020 has been released!

This release is the successor of 6.010 and fixes a number of problems with chord markup and the new define properties (copy, copyall, display and format). See https://www.chordpro.org/chordpro/directives-define/ for details.

New in this release is the possibility to anchor images to the page, column or lyrics line. See https://www.chordpro.org/chordpro/directives-image/ for details.

Get it from Github ( https://github.com/ChordPro/chordpro/releases/tag/R6.020 )

For full information, see https://www.chordpro.org/chordpro/chordpro-reference-relnotes/ .

Note: If you use the internal file structure of the installed ChordPro kit: the path lib/App/Music/ChordPro has been renamed lib/ChordPro. Likewise, the perl modules no longer have an App::Music:: prefix in their names.

ChordPro 6.010

Released: 2023-06-05

Note that 6.010 is really 6.01.0. It is the first release after 6.000.

ChordPro functionality

• Allow line continuation for input lines using a backslash.
• Allow define chord "|" in config.
• Allow graceful handling of rootless chords.
• Allow simple markup in chords. Yes, this includes grid chords.
• Add flags for preprocessor pattern replacements.
• Allow image scale as a percentage.
• Experimental: Absolute placement for images.
• Experimental: Diagram control in {define}.
• Remove diagrams.auto from config.

BugFixes

• Add Pod::Usage to required modules. Some distros seem to have removed it from the core.
• Add jpeg library to MacOS kit.
• Add some missing files for docs building.
• Fix root relocation when transcoding to a movable system.
• Fix missing parser in {define XX} without frets etc.
• Fix forum 1696 (chord recall with trans{code,pose}).
• Fix issue #269 (problem with page labels).
• Fix issue #270 (PDF outlines issues, 'letter' setting).
• Fix issue #273 (PDF CreationDate string is not conformant, but PDF::API2 2.042+ rejects conformant strings).

Social and support

User community for feedback and help.

ChordPro 6.000

Final 6.000 release.

See https://www.chordpro.org/chordpro/chordpro6-relnotes/ for full information.

ChordPro 5.990

Mostly small bugfixes.

ChordPro 5.989

ChordPro 5.989

Released: 2022-10-21

ChordPro functionality

• Verify configs (and fix if possible).
• Enhance ToC sorting, unlimited keys, numeric and reverse sorting.
• Warn if X: is missing in ABC content.
• Add volta for grid.
• Add display for {define}.
• Replace TAB characters by a single space on input.
• Support building installer with MacOS homebrew perl.
• Allow empty chord defines (just the name) to make the chord known.
• Allow front-matter and back-matter in the config and filelist.
• (Experimental) Allow PDF filenames in the filelist.
• (Experimental) Allow multiple chords in a grid cell.

Miscellaneous

• Luke Pinner contributed a nice search feature for our doc pages.

BugFixes

• Fix problem that toc columns overlapped lefter columns.
• Fix some problems with {define}.
• Fix some more problems with {define}.
• Fix automatic replacement of apostroph (prime) by friendly quote.
• Fix crash when auto-adding an unknown chord.
• Only print user chords when diagrams.show=user.
• Make base optional in json chords (part of fix 234).
• Modern3 style now has keyboard diagrams at the right. See issue 236.
• (PDF) Print chorus tag if there's no chorus to rechorus.
• Fix regression with pagealign = 2.
• Fix issue 222.
• Fix issue 223.
• Fix issue 224.
• Fix issue 226.
• Fix issue 234.
• Fix issue 237.
• Fix issue 239.
• Fix issue 250.
• Fix issue 251.
• Fix issue 253.
• Fix issue 255.

Social and support

User community for feedback and help.

Follow us on Twitter to stay informed about new releases and updates.

ChordPro 5.988

Mostly small improvements and bugfixes.

ChordPro functionality

• Automatically use real sharps and flats in chord names. Fallback to the ChordProSymbols font if the font doesn't have the appropriate symbols.
• Add settings.truesf (default: false) to enable/disable this.
• Allow settings.* to be used in %{} substitutions.
• Add meta chords and numchords (list/number of chords used).
• Add config pdf.spacing.diagramchords.
• Allow meta values for directive selectors.
• Re-enable agnostic chord lookup.
• (Wx)(MacOS) Improve prefences dialog.
• Several ABC fixes/improvements.
• (PDF) Add support for background document.
• Markdown export (EXPERIMENTAL). Thanks to Johannes Rumpf.
• LaTeX export (EXPERIMENTAL). Thanks to Johannes Rumpf.

BugFixes

• Fix issue #208.
• (Wx) Fix sharps/flats mixup in PreferencesDialog.

Social and support

User community for feedback and help.

Follow us on Twitter to stay informed about new releases and updates.