How the royalties tool works

The short version

Every distributor, PRO, and collection society lets you export a statement (a CSV or TSV file). You drop that file into git-royal, we read its columns, add up your earnings, and roll everything into one dashboard. No API connections, no account credentials — just the export you can already download today.

Adding a statement

1. In your distributor/PRO/MLC/SoundExchange account, export or download your statement as a CSV or TSV file.
2. In git-royal, go to Dashboard → Royalties, pick the source, and choose the file.
3. git-royal reads the columns and shows you what it found. Review the mapping, adjust anything if needed, and click Import.
4. Your earnings roll up into totals — by source, by platform, and by track.

How we read your columns

Every provider names things differently — “Earnings (USD),” “Net Sales,” “Royalty,” and so on — and some ship comma files while others ship tab-separated files. So instead of forcing one format, git-royal figures it out:

• We detect whether the file is comma- or tab-separated automatically.
• We send only the column headers and a few sample rows to an AI service that identifies which column is your earnings, which is the track title, and so on.
• You see that mapping and can correct any field before importing — you're always in control of what counts as what.
• Then git-royal does the math itself — the AI only names the columns; it never sees your whole file and never adds up your numbers. That keeps your totals accurate and trustworthy.

What we keep

We store the earnings data we parse from your statement — amounts, track names, platforms, periods — so we can show your dashboard. That data is private to your account.

Privacy & your responsibility

To read column layouts, we share your statement's headers and a small sample of rows with our AI provider (Anthropic), which does not use this data to train its models. We do not send your entire file for this step.

The royalties tool is for information only — it is not financial, accounting, or tax advice, and the figures are estimates based entirely on the files you upload. You are responsible for having the right to upload your statements and for verifying the totals against your official statements. See our Terms and Privacy Policy.

FAQ

Do I have to connect my accounts?

No. There's nothing to connect — you just upload the export file you can already download.

Which providers work?

Any that let you export a CSV or TSV — distributors (DistroKid, TuneCore, CD Baby…), PROs (ASCAP, BMI…), the MLC, and SoundExchange. Because we read columns dynamically, new or changed formats generally still work.

Will the totals be exact?

We add up exactly what's in your file. If a column is mapped wrong, fix it in the review step and the totals update instantly. Always cross-check against your official statement.