App-Music-ChordPro
view release on metacpan or search on metacpan
- A brand new ChordPro GUI makes it a pleasure to create nice songbooks.
It has been completely redesigned using feedback from Nick Berendsen's macOS version.
The new GUI is identical on Linux, Windows and macOS.
It comes with a built-in PDF previewer.
It can create songbooks from folders of songs.
!Other improvements
- Centered chords (top, bottom, below) are now evenly spread over multiple lines.
- (Wx) Remove ChordPro preset.
- (macos) Use _NSGetExecutablePath() to get the correct script location.
- Sync config files between git and MANIFEST.
- (Paths) Allow absolute filenames in findres.
- (Makefile) Add Ref::Util dependency.
- Progress reporting. Options `progress_callback` and -I. Also
enabled with --verbose.
- New meta: page.class (first, title, default) and page.side (left, right).
- Distinct page classes for even pages; filler class for alignment pages.
- Add "omit" property for delegated images.
- Allow 'mi' as short for 'min' chord quality.
- Make properties parsing in directives more robust.
- (ChordPro) Include ABC if generating for MSPro.
- Allow %{} substitutions in grid sections.
- Add labelfont, labelsize and labelcolour directives.
- (Experimental) Chord changes.
!Bug Fixes
- Several image fixes related to issue #428.
- (Wx) Fix problem with incorrect resource path after CHORDPRO_LIB change.
- (Config) Eliminate warning on undefined config entry.
- Fix problem with vertical spacing of {chord}.
- Fix issue #411, #428, #429, #443, #447, #471, #473, #482.
- Fix forum issue 2546.
- (Wx, MSWindows only) Use Edge for WebView (PDF view). Requires custom wxWidgets build.
- Change handling of NC (issue #441).
- Fix invalid font names for Courier/Mono Italic (should be Oblique).
6.060 2024-08-24
!Highlights
- Configuration files are now [Really Relaxed JSON](https://metacpan.org/pod/JSON::Relaxed#REALLY-RELAXED-EXTENSIONS) files.
These are much easier to write and maintain than JSON.
Don't worry, everything is still backward compatible with the
older JSON and slightly relaxed JSON formats. And ChordPro can
[convert your config files](https://www.chordpro.org/chordpro/using-chordpro/#convert-config) for you.
- Nick Berendsen kindly offered to create a native GUI for macOS.
It looks great and behaves nicely in the way macOS applications should
behave. And it doesn't have the restrictions on opening and saving
of files that the 'classic' GUI suffers from.
Thanks Nick!
- ChordPro bundles free replacement fonts to be used instead of
the corefonts. No configs or settings needed.
!Functionality
- (PDF, page sort) Use sorttitle for page sorting.
- Images: Ignore align with x percentage. Issue warning.
- Detection of attributes in labels now requires quoting.
- Handle \u escapes for surrogates and extended chars (\u{...}).
- 'chordpro -A -A -A' will produce runtime info in JSON.
- Add '--convert-config' to convert config to new style.
- Add href property for images.
- New metadata: chordpro, chordpro.version and chordpro.songsource.
- Upgrade JSON::Relaxed to 0.096.
- Upgrade SVGPDF to 0.087. Enables transparent SVG images.
- Add independent horizontal and vertical scaling for images.
Requires Text::Layout 0.037_002.
- Upgrade Text::Layout to 0.038.
- Allow fret -1 in {define}, and 'x' in json config for consistency.
- Allow pdf.fonts.foo: bar (short for pdf.fonts.foo { description: bar }).
- Allow label="..." for {chorus} and {grid}.
- Add align property for diagram display.
!Bug fixes
- Fix/update docker build.
- Add missing shortcodes sog and eog (start/end of grid).
- Fix paper anchored images being restricted to page size instead
of paper size.
- Fix problem that blocked pdf documents from being processed as songs.
- Fixed problems with labels and embedded newlines.
- Fixed newline issues in TextBlocks.
- Fix issue #353, #367, #371, #372, #384, #388, #399, #410.
- Fix spread image handling.
- Fix diagrams.sorted.
- Fix handling of "display"/"format" in config chords.
- Fix problem that text in a TextBlock did not reset to flush left.
- Fix problem TextBlock textstyle did not copy the background colour.
- Fix colours of keyboard diagrams wrt. theme.
- Fix rootless chords with transcode.
- Fix problem with /~ in grid.
- Upgrade to abc2svg fca05cd348 to fix problem with grid widths.
- Fix problem with TextBlock not correctly using desired spacing.
- Fixed --print-{default,final,delta}-config.
!Internal
- New function to deal with property settings for the config.
- Move pp files to separate MANIFEST so they do not clobber the CPAN.
6.050.10 2024-04-06
- Upgrade PDF::API2 to 2.045.
6.050.9 2024-04-05
- Allow very relaxed JSON format for config files.
- Run with CHORDPRO_JSON_RELAXED=1 in case of emergency.
- Make times/serif and helvetica/sans soft aliases so they can
be redefined individually.
- Remove Verdana and Georgia from the list of core fonts. They're not.
- Fix problem with image aligning (see forum 2179).
- Prevent some SVG diagnostics.
6.050.8 2024-03-21
- Use bublath donated a page reordering feature. See
https://chordpro.org/chordpro/chordpro-configuration-pdf/#page-reordering
- Improve error message for open failures.
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](https://www.chordpro.org/chordpro/directives-props_chorus_legacy/).
- 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](https://groups.io/g/ChordPro/message/1846)
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.
6.020 2023-07-21
- !ChordPro functionality
- New directive diagrams obsoletes grid/no_grid with more possibilities,
Based on a suggestion and concept implementation from Jörg Bublath.
- Images without directory can be looked up in CHORDPRO_LIB.
- Turn pseudo-chords like | and spaces into annotations.
- !BugFixes
- Fix a number of problems with define/copy/copyall.
- Fix issue #293.
- !Internal
- Bump minimal perl version to 5.26 and add Object::Pad to dependencies.
- Change namespace App::Music::ChordPro to ChordPro.
- Put VERSION on single line for stupid tools.
- Upgrade ChordPro::Chords::Appearance to class.
- Enhance Parser to use signatures to catch call errors.
- Enhance Config to use signatures to catch call errors.
- Enhance Chords to use signatures to catch call errors.
- Enhance Utils to use signatures to catch call errors.
6.010 2023-06-05
- !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).
6.000 2022-12-28
- !ChordPro functionality
- Chord finger settings can be suppressed with pdf.diagrams.fingers.
- (Experimental) Add line selection to preprocessor.
- Remove * for user defined chords.
- !BugFixes
- Fix issue 259.
- Fix issue 260 (chords not being handled correctly in comments).
- Fix issue 260 (suppress diagrams and grids when lyrics-only).
- Fix issue 261 (truesf not functional beyond chord root).
5.990 2022-11-03
- !BugFixes
- Fix erroneous error message when pdf.formats.default.title (cs) is [].
- Fix compatibility problems with PDF::Builder.
- Fix page labels for PDF::API2 >= 2.041.
- Eliminate potential splice warning with pagealign-songs.
- Fix resize preferences window.
- Fix problem with copied chords not being registered as agnostic.
5.989 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 apostrophe (prime) by friendly quote.
- Fix crash when auto-adding an unknown chord.
- Only print user chords when diagrams.show=user.
- Add (derived) meta item _key to reflect the actual song key,
taking capo setting into account.
- Allow {comment} without background colour.
- Make {comment_box} box the same colour as its text.
- Warn if multiple {capo} settings.
- Fix problem that chords in grids were not transposed.
- Add value "auto" for pdf.labels.width to automatically reserve
margin space when labels are used.
- Fix problem that titles-directive-ignore was ignored.
- (PDF) Fix problem that toc entries were not clickable.
- Fix issue #41 - Error in transposition of a recalled chorus.
- Fix issue #42 - Defining Chords Fails for Songbooks.
Song chord definitions were lost in multi-song songbooks except
for the last (or only) song.
- Fix schema validation for configs.
0.94 2018-01-23
- Allow \ { } and | to be escaped with \ in replacement strings.
- Fix problem that in-song chords caused CANNOT HAPPEN error.
- Add --filelist option to read song file names from files.
- Fix inconsistent handling of --lyrics-only in backends.
- Add html to list of recognized output types (even though
experimental). Note that the HTML backend is not yet included.
- Fix Chord/Chordii regression: Base frets in chord diagrams
should be arabic numbers, not roman.
- Pass unknown directives through to backends.
- Fix labels handling for ChordPro output.
- Fix problem that bass notes in chords were not transposed.
0.930.1
- (pp/windows) Add PDF::API2::Bundle to make sure all PDF::API2
and TTF::Font modules are included.
0.93 2017-12-07
- Fix transposition of chord diagrams.
0.92 2017-12-07
- Add configurable sort methods for table of contents.
Config option: toc.order, values "page" or "alpha".
Default is "page".
Config option: toc.title, default "Table of Contents".
Supersedes pdf.formats.default.toc-title.
- Fix JSON problem with loading UTF8 config files.
- Fix the need for a bogus file argument when dumping chords.
- Experimental support for indenting and margin labels.
- Obsolete pdf.diagramscolumn in favour of pdf.diagrams.show.
This can be top, bottom, right of the first page, and below,
following the last song line.
- Provide song source for unknown chords message.
- Handle UTF-8 encoded filenames correctly.
- Implement in-line printing of chords, config:
settings.inline-chords.
Add style 'inline'.
- Fix problem with font restore after {textfont} cs.
- Fix problem that trailing empty lines were discarded.
- Fix final line discard if input is not newline terminated.
- Fix issue#31 (textsize directive with percentage raises error).
- Fix problem where first empty line was inadvertently ignored.
0.910.1 2017-11-09
- Add style 'modern3'.
0.91 2017-11-09
- Add printing of bars in chord diagrams.
- Allow PDF config "fontdir" to take an array of paths. Also,
allow the path elements to be a colon-(Windows: semicolon)-separated
list of paths.
- Add PDF config "diagramscolumn". This will have the song chord
diagrams printed on the first page, in a side column.
Experimental.
- Fix problem with misnumbered fingers in non-builtin chords.
- Fix problem with restoring defaults for {textsize} and friends.
0.90 2017-10-17
- Fix dependencies in Makefile.PL.
- Do not mark config defined chords as being user defined.
- Fix some problems with '{chord}' chords.
0.89 2017-09-22
- Add {transpose} directive.
- Transpositions and metadata substitutions are now handled at
parse time.
- Update built-in documentation.
- Upgrade WxChordPro to 0.89.
- Fix problem with locating manual page.
- Normalize CHANGES according to CPAN:Changes::Spec.
0.88 2017-09-11
- Put the Table of Contents (if any) at the beginning.
- Fix a bug that caused no TOC to be produced with multiple song
input.
- Add --csv command line option to request writing the CSV.
- Add --cover command line option to prepend cover pages.
- Improve JSON config validation.
0.87 2017-09-04
- Fix problem where songlines without chords yielded empty lines
in the ChordPro backend after transposition.
- Allow "-" as filename for standard input.
- Handle Byte Order Mark in input files.
- (ChordPro) Do not use {meta} for known meta keys.
- (Windows) Handle version number setting in iss file.
0.860.1 2017-08-18
- Fix test failures with PDF::Builder 3.004, issue
https://rt.cpan.org/Ticket/Display.html?id=122815 .
0.86 2017-08-16
- Fix problems with disappearing page titles.
( run in 2.176 seconds using v1.01-cache-2.11-cpan-0d23b851a93 )