Turns .chordpro files into formatted HTML chord charts and renders them to PDF.
Turn something like this...
...into something like this!
To use this application, you will need the current LTS version of Node.js.
- Clone or download and unzip the source code.
- Open your terminal or command prompt and change to the source code folder.
- Install dependencies
npm installThe charter application can be installed as a command-line interface (CLI) app that can be used anywhere in your terminal or command prompt.
npm install -g .This will install the chord-charter CLI app.
You can use this application to view .chordpro files as HTML in the browser and convert them to PDF. A sample ChordPro file is included in the source code.
Converting a single ChordPro file to PDF. By default, the .pdf file will be saved in the same folder as the ChordPro file.
chord-charter -f path/to/chartfile.chordproSpecifying the output file.
chord-charter -f path/to/chartfile.chordpro -o path/to/chordchart.pdfConverting a folder of chordpro files at once. The folder will be scanned for any files ending with a .chordpro or .cho extension.
chord-charter -f path/to/chartfiles -o path/to/savepdfs| Option | Description |
|---|---|
--help |
Show help |
--version |
Show version number |
-f, --source |
Path to file or folder of chordpro files to convert |
-o, --out |
Path to destination file. If none specified, the file will be saved in the same path as the chordpro file. |
--temp |
Specify path to the temp folder for generating intermediate files. |
--html |
Save as HTML instead of PDF |
--columns |
Use two-column format (doesn't work well with all charts) |
Put your .chordpro files in the charts folder and run in your terminal:
npm run startHTML files will be generated in the build folder, and PDF files can be found in the pdf folder.
Put your .chordpro files in the charts folder and run the following in your terminal.
npm run serveIn your browser, navigate to http://localhost:3000.
While running, any changes made to .chordpro files will be detected and the HTML is rebuilt. Refresh the browser page to see any changes.
Note: To stop the local web server, go to the terminal window and press
CTRL+C.
There is an option to use wkhtmltopdf to perform the final conversion from HTML to PDF. To us it, it must first be installed on your system and in your search path. For macOS, you can install this with Homebrew using the following.
Note: As of this writing, wkhtmltopdf does not support CSS columns, so a two-column chord chart format will not work.
brew cask install wkhtmltopdfWith wkHtmltoPDF installed, use the following npm command to convert all chord files in the charts folder and save them to the pdf folder.
npm run wk