Tillroll · Setup guide

How to set up Tillroll with RevenueCat

To set up Tillroll, open the app, copy the webhook URL and Authorization value it shows, and paste them into a new webhook in RevenueCat (your project → Integrations → Webhooks → Create new webhook). Then press Send test event in RevenueCat: when Tillroll says “Connection works” and your notch shows “RevenueCat connected”, you're done. It takes about two minutes, with no API key and no sign-up.

  • About 2 minutes
  • macOS 14 or later
  • A RevenueCat project
  • Setup is free

Tillroll is in Mac App Store review, so it isn’t available to install yet.Get notified at launch

Install and open Tillroll

Tillroll runs on macOS 14 Sonoma or later and lives in your menu bar. Once it's on the Mac App Store, install it and open it: the Tillroll Setup window opens by itself on first launch. Press Print a sample receipt to see what your notch prints every night, then Continue.

Tillroll Setup window on the Welcome to Tillroll step, with a Print a sample receipt button and a Continue button.
The first step of the setup window.

Copy your webhook URL and Authorization value

The next screen, Where in RevenueCat?, shows where the webhook form is (step 3 below). The one after it, Connect RevenueCat, creates your account on the spot, with no sign-up and no password, and shows the values RevenueCat needs, each with a Copy button: the Webhook URL and the Authorization header value, which starts with Bearer twh_.

The URL is the same for every Tillroll user. The Authorization value is your own secret: it stays masked until you press the eye button, and Tillroll never asks for your RevenueCat API key.

Connect RevenueCat step listing Webhook name Tillroll, Webhook URL, an Authorization header value starting with Bearer twh, Environment Production only and App / Event type All apps / All events, with Copy buttons.
Connect RevenueCat. The Webhook URL is blurred here because this screenshot was taken on a development build.

Add a webhook in RevenueCat

In the RevenueCat dashboard, open your project and click Integrations near the bottom of the left menu. Choose the Webhooks card, press Create new webhook, and fill in the form from top to bottom:

RevenueCat fieldWhat to enter
Webhook nameTillroll
Webhook URLPaste from Tillroll
Authorization header valuePaste from Tillroll (Bearer twh_…)
Environment to send events forProduction only (the default also sends sandbox)
AppAll apps
Event typeAll events

Press Add webhook at the bottom right. Tillroll's own Where in RevenueCat? step shows the same path with screenshots, and its Open RevenueCat button takes you to the dashboard.

Tillroll only receives the sale notifications RevenueCat sends. It can't act for you: it can't touch subscriptions, refunds or your RevenueCat settings, and deleting the webhook in RevenueCat disconnects it at any time.

RevenueCat's webhook docs call the button “Add new configuration”; it opens the same form.

Send a test event

Back in Tillroll, press Continue to reach Test the connection. It says “Waiting for the test event…” and checks every 3 seconds.

In RevenueCat, open the Tillroll webhook in the webhook list (Edit webhook), press Send test event in the Webhook Events section at the bottom, then Send Test Event on the next page. A few seconds later Tillroll says “Connection works” and your notch shows “RevenueCat connected”.

Test the connection step with a green check mark and the words Connection works.
Black notch ding with a green check mark reading RevenueCat connected.
The ding under the notch when the test event arrives.

No webhook yet? Skip for now lets you finish setup anyway; see Try it without RevenueCat.

Name your apps

RevenueCat events carry no app name, so Tillroll guesses one from an app's first sale, usually from its product ID (a product like fitnote.monthly becomes “Fitnote”). In Your apps, type the name you want on the receipt and press Save.

An app joins the list with its first sale, so the list can be empty right after the test event. You can rename apps any time in Settings → App names. Names that match your App Store listing let the ding show the app's icon; otherwise it shows a letter badge.

Your apps step with two editable app name fields, each with a 1 event count and a Save button.
App names are redacted in this screenshot.

Pick your closing time

Finishing touches has three settings. Receipt header is the title on top of your receipt (MY APPS until you change it). Closing time is when the till closes: at 23:59 by default, the day's Z report prints out of the notch by itself, and Close the register in the menu bar prints it whenever you like.

Sound (ding and printer) is off until you turn it on. Paper themes, a daily goal and your time zone wait in Settings → Receipt.

Finishing touches step with a Receipt header field, Closing time set to 23:59 and the Sound (ding and printer) switch turned off.

Privacy while you share your screen

In Settings → Alerts, Hide amounts is set to While sharing the screen: amounts turn into $•• while Zoom sharing, OBS, Loom, Screen Studio or Cap is running. Sharing from a browser (Meet) or Teams can't be detected, so choose Always for those.

To hide app names instead, press Hide app names (the eye button) on a printed receipt. Apps then print as APP A, APP B on the receipt and its share card, and the amounts stay.

Tillroll's notch summary in private mode: today's net and gross shown as $•• next to a count of 12 sales.
Private mode on sample data; the app name is redacted.

Connect your other RevenueCat projects

Each RevenueCat project needs its own webhook, and every one of them uses the same two values. Choose Add a RevenueCat project… in the Tillroll menu (or Add a project… in Settings) and repeat steps 3 and 4 in the next project.

Right after a successful test you can also press Connect another project. Every app ends up on one receipt, one counter and one streak.

Connect another RevenueCat project window showing the same webhook name, URL and masked Authorization value, each with a Copy button.

Unlock Tillroll with Lifetime

Setup is free. When you press Finish, Tillroll asks for Tillroll Lifetime: one payment of $4.99 at the launch price, every feature, no subscription. The App Store shows the price in your own currency.

Until you unlock it, dings and receipts are paused and the menu shows Unlock Tillroll — Lifetime. Bought it before? Use Restore purchases in Settings → Purchase.

Try it without RevenueCat

During setup you can print a sample receipt on the first step, and Skip for now on the test step lets you finish without a webhook.

For a fuller tour, open Settings → Demo account and press Create the demo account. Tillroll creates a separate demo account and sends it 30 days of sample sales through its webhook, as RevenueCat would; your real account isn't touched. Then switch Account shown between Real and Demo, or turn on Live sales (every 10–25 s, for 10 min) to watch new sample sales ding in. Opening tillroll://demo?setup=1 does the same as the button.

Before you press Finish, Tillroll works without Lifetime. After that, the demo needs Lifetime too, just like your real sales.

Troubleshooting

The test event never arrives

Check that both values were copied whole; the Authorization value starts with Bearer twh_. Send the test while Tillroll is on Test the connection: a test sent before that step opened doesn't count. RevenueCat lists every delivery under Webhook Events on the webhook's page, and you can retry a failed one there.

The test worked, but real sales don't ding

Sandbox purchases are hidden by default: turn on Settings → Alerts → Show sandbox events, and make sure the webhook's environment includes sandbox. Real sales take a moment: RevenueCat usually sends a webhook 5 to 60 seconds after the purchase, and Tillroll checks for new sales every 30 seconds. If the menu says “Tillroll is locked”, dings wait for Lifetime.

I can't find Webhooks in RevenueCat

RevenueCat includes webhooks in its current Pro plan, which is free up to $2,500 in monthly tracked revenue. Some older legacy plans don't include them; RevenueCat's docs say to move to Pro in that case.

I made a new secret and the dings stopped

Settings → RevenueCat connection → New secret… replaces the old value at once. Paste the new Authorization value into every RevenueCat webhook.

My amounts show as $••

Hide amounts is set to While sharing the screen by default, so amounts hide while Zoom sharing, OBS, Loom, Screen Studio or Cap is running. Change it in Settings → Alerts → Hide amounts.

No receipt printed last night

If your Mac is asleep at closing time, that day's receipt doesn't print by itself (it does if the Mac wakes up before the day is over). Sales aren't lost: they wait on the server and count toward the day they belong to.

My Mac doesn't have a notch

Tillroll works the same on displays without a notch: dings, the peek card and receipts appear in a small pill at the top centre of the screen.

I moved to a new Mac

Your Tillroll account lives in your Mac's Keychain. A new Mac starts with a new, empty account, so paste its values into your RevenueCat webhooks. Get Lifetime back with Restore purchases.

How do I disconnect or delete my data?

Delete the Tillroll webhook in RevenueCat and new sales stop arriving at once. To have your data deleted, email hello@justshipstudio.com with the subject “Delete my Tillroll data”. Details are in the privacy policy.

Still stuck?

Email hello@justshipstudio.com. The maker reads every message; your macOS version and a screenshot help a lot. More answers are on the support page.