ChordPro::A2Crd(3pm)

💖 ChordPro::A2Crd 💖

okay bestie, grab your iced coffee because we're talking about ChordPro::A2Crd from the User Contributed Perl Documentation, and honestly? it's giving sheet-music-glow-up. ✨

---

🌸 NAME 🌸

ChordPro::A2Crd — the little icon that converts lyrics and chords into ChordPro. no cap, that's the whole job and she does it. 💅

---

✨ SYNOPSIS ✨

here's how the cool kids could run it:

perl -MA2Crd -e run -- [ options ] [ file ... ]

(But no one does that.) 😭 we said what we said.

when the associated chordpro program has been installed correctly (periodt, correctly), you do this instead:

chordpro --a2crd [ options ] [ file ... ]

---

🦋 DESCRIPTION 🦋

so this program, bestie, we call it a2crd, and what she does is: she reads a text file with the lyrics of one or many songs, plus chord information written visually above the lyrics. this is often referred to as crd data. then a2crd generates equivalent ChordPro output. iconic behavior. 💖

and here's a typical a2crd input so you can see the vibe:

    Title: Swing Low Sweet Chariot

          D          G    D
    Swing low, sweet chariot,
                           A7
    Comin' for to carry me home.
          D7         G    D
    Swing low, sweet chariot,
                      A7       D
    Comin' for to carry me home.

      D                       G          D
    I looked over Jordan, and what did I see,
                           A7
    Comin' for to carry me home.
      D              G            D
    A band of angels comin' after me,
                      A7       D
    Comin' for to carry me home.

heads up babes 💀 — the output from the conversion will generally need some additional editing to be useful as input to ChordPro. it's a vibe, not a finished masterpiece. 🎀

also important: a2crd is just a wrapper around ChordPro::A2Crd, which does all of the actual work. she's the face, ChordPro::A2Crd is the talent. 👑

and like, chordpro itself? she will read one or more text files containing the lyrics of one or many songs plus chord information, and then generate a photo-ready, professional looking, impress-your-friends sheet-music suitable for printing on your nearest printer. literally main character energy. 🖨️💅

for the record: chordpro is a rewrite of the Chordii program. the glow-up is real. 🌈

want more tea about the ChordPro file format? go look at <https://www.chordpro.org>. iykyk. 🌐

---

🎀 COMMAND LINE OPTIONS 🎀

• --output=FILE (short: -o) — names the output file where the results get written to. the default is standard output. 🍓
• --version (short: -V) — prints the program version and exits. bye bestie, that's all you get. 👋
• --help (short: -h) — prints a help message. and that's it — no other output is produced. ✨
• --manual — prints the manual page. also no other output is produced. (we love a girl who's laser-focused. 💅)
• --ident — shows the program name and version. like a name tag but for software. 🎀
• --verbose — provides more verbose information of what is going on. she will tell you everything. no secrets. 🦋

---

👑 AUTHOR 👑

Johan Vromans "<jv at CPAN dot org >" 💜

---

🌸 SUPPORT 🌸

A2Crd is part of ChordPro (the program). development is hosted on GitHub, repository: <https://github.com/ChordPro/chordpro>. 🧚

please report any bugs or feature requests to the GitHub issue tracker: <https://github.com/ChordPro/chordpro/issues>. do it, bestie, the maintainers wanna hear from you. 🫶

and there's a user community discussing ChordPro right here: <https://groups.google.com/forum/#!forum/chordpro>. come hang out, it's a whole vibe. 🌈

---

💜 LICENSE 💜

Copyright (C) 2010,2018 Johan Vromans,

this program is free software. you can redistribute it and/or modify it under the terms of the Artistic License 2.0. slay. 🎀

this program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. read that twice, bestie, we're not playing. 😭

---

and that's the tea ☕ — this page is from perl v5.40.1, dated 2026-05-03, and it's ChordPro::A2Crd(3pm) from the User Contributed Perl Documentation. stay iconic, go convert some songs, mwah 💋✨