custom_flutter_chord 1.2.2 copy "custom_flutter_chord: ^1.2.2" to clipboard
custom_flutter_chord: ^1.2.2 copied to clipboard

Lyrics Chord parser and renderer for Flutter. It also comes with transpose and auto-scroll features.

1.2.2 #

  • License change: the package is now proprietary software of GOVERNOR LTD (previously MIT). Access, use, copying, modification and distribution require explicit prior written authorization obtained through the official channels (contact@governor.ltd). See LICENSE for the full terms.
  • Docs: README rewritten — licensing notice, updated feature list and an implementation section that reflects the current behaviour (transposition → MinorModechordNotation pipeline, keyRoot degrees and the relative/parallel minor modes); the previous text still described the pre-1.2.0 minor conversion.
  • Docs: example/README.md replaced by real documentation of the demo app.
  • Changelog history prior to 1.0.0 removed.
  • Example: drop the unnecessary src/chord_transposer.dart import (unnecessary_import); ChordNotation comes from the library barrel.
  • No changes to the library API or behaviour.

1.2.1 #

  • Fix: onTapChord now returns the chord after the active minor conversion (same value shown in the lyrics), so the tapped chord matches the rendered one. Previously, with MinorMode.parallel, tapping a chord passed the un-converted chord (e.g. rendered "Ab" but tapped "A"). Conversion is centralised in convertedChordText, used by both the renderer and the tap.

1.2.0 #

  • Add MinorMode (none / relative / parallel) and the minorMode parameter to LyricsRenderer, replacing the old minorScale behaviour with two correct minor-key conversions applied on top of transposeIncrement:
    • relative: relative minor — chords are left untouched; only the degree reference (number/roman) re-centres a minor third below the major tonic.
    • parallel: parallel minor — each diatonic chord of the major key is mapped to the natural-minor field (I→i, ii→ii°, iii→♭III, IV→iv, V→v, vi→♭VI, vii°→♭VII). Extensions and slash chords are preserved; flat degrees are spelled with flats; chromatic chords are kept unchanged.
  • Export ChordNotation, ChordScale and MinorMode from the library barrel.
  • minorScale is kept for backwards compatibility (minorMode takes precedence).

1.1.0 #

  • Add keyRoot to LyricsRenderer: when set, the number and roman notations render chords as functional degrees relative to the song key (e.g. in G: G→1/I, C→4/IV, Em→6/vi) instead of the absolute C = 1/I mapping. Degrees stay invariant under transposeIncrement.
  • Roman degrees are now quality-aware (uppercase major, lowercase minor, ° diminished, + augmented) and slash chords convert both root and bass.
  • Backwards compatible: with keyRoot null the previous absolute mapping is kept.

1.0.2 #

  • Fix chord overlapping when they are too close to each other.
  • Add [•] as a visual separator for trailing chords to improve readability.

1.0.0 #

  • Add visual separator for trailing chords to improve readability.
  • The separator [•] is automatically inserted between chords at the end of a line or in chord-only lines.
  • Add support for multiple chord notations (german, traditionalGerman, french, portuguese, roman, number).
  • Fix and improve transposition to minor scale.
9
likes
150
points
211
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Lyrics Chord parser and renderer for Flutter. It also comes with transpose and auto-scroll features.

Repository (GitHub)

License

unknown (license)

Dependencies

flutter

More

Packages that depend on custom_flutter_chord