SongsterrToPdf

SongsterrToPdf is a .NET 10 console tool that downloads Songsterr track JSON and exports PDF tablature.

For the PDF path, it uses Songsterr's own browser renderer, captures the hydrated SVG rows, and writes them into a clean browser-generated PDF.

Requirements

• .NET 10 SDK
• Google Chrome installed locally

Build

dotnet restore
dotnet build

Usage

Generate JSON files only:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27"

Generate PDFs as well:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27" --pdf

Generate portrait PDFs:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27" --pdf --portrait

Write output to a custom directory:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27" --pdf -o ./output

Show the Chrome window while exporting:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27" --pdf --no-headless

Enable verbose logging:

dotnet run -- "https://www.songsterr.com/a/wsa/metallica-enter-sandman-tab-s27" --pdf -v

Options

• -o, --output <dir>: output directory
• --pdf: generate PDF files beside the downloaded JSON
• --portrait: generate portrait PDFs
• --landscape: generate landscape PDFs, default
• --no-headless: show the browser window
• -v, --verbose: verbose logs
• -h, --help: show help

Output

The tool writes:

• one metadata.json
• one normalized JSON file per track
• one PDF per track when --pdf is enabled

Example:

artist_song/
├── metadata.json
├── 00_lead_guitar_distortion_guitar.json
├── 00_lead_guitar_distortion_guitar.pdf
├── 01_rhythm_guitar_electric_guitar_clean.json
└── 01_rhythm_guitar_electric_guitar_clean.pdf

Notes

• Chrome is used both to discover Songsterr track JSON and to capture Songsterr's rendered SVG rows for the PDF export.
• PDF output supports both landscape and portrait orientation.
• This is intended for personal use. Respect Songsterr's terms and the underlying rights for the tab content.