Going live
Your customers' PCs, the two questions they answer, and a plan for your website.
Each PC that prints needs the Taprel app, and your website needs a plan.
1Install the app on each PC
Send your customers the same download as yours: the latest release, the file ending in _x64-setup.exe. It installs for the Windows user with no admin rights, starts with the computer, runs in the tray and updates itself.
Then, on the app’s Printers page, check each printer’s type and paper. See Printers.
2The two questions
The first time your website prints, the person at the computer answers two questions, once:
| Who asks | The question |
|---|---|
The browser, on a real website (never on localhost) |
“Access other apps and services on this device” |
| The Taprel app, in a small window in the middle of the screen | “Allow this website to print?” |
They come with the first request, or with connect(), so you can call connect() at a moment that makes sense, like when the customer opens your printing settings. Show them what to click:
import { browserPermissionTexts } from "@taprel/sdk";
import { printer } from "./printer";
printer.onStatusChange((status, error) => {
if (status === "waiting-for-browser") show(browserPermissionTexts.beforeQuestion);
else if (status === "waiting-for-agent") show('Answer "Allow this website to print?" on your screen.');
else if (error?.code === "BROWSER_BLOCKED") show(browserPermissionTexts.afterBlock);
else show(error?.message ?? "");
});
import { PrintHelp } from "@taprel/react";
export function PrinterHelp() {
return <PrintHelp />;
}
<script setup lang="ts">
import { PrintHelp } from "@taprel/vue";
</script>
<template>
<PrintHelp />
</template>
PrintHelp shows the right words while a question waits or when something is wrong, and nothing when all is well. In Brave, ask your customers to set Remember my decision to forever, or Brave asks again on the next visit.
3Put your domain on a plan
Create your Taprel account and add your domain on the Domains page. That starts a 14-day trial with no card, and its subdomains print too. Subscribe on the Billing page before it ends, or printing stops.
| Plan | Monthly | Yearly | Includes |
|---|---|---|---|
| Starter | $9 | $90 | 1 domain, 5 computers |
| Pro | $29 | $290 | Unlimited domains, 50 computers |
On your own computer, localhost is free with no account, up to 50 print jobs a day. A new domain or plan works within a minute.
More
Plans and billing
- An account gets one trial, and a domain only ever gets one. A domain that already had a trial can still be added, with no free days.
- A yearly plan costs the same as ten months, with the same limits.
- Prices are in US dollars. Paddle takes the payment, and adds or includes tax depending on your country. Change plan, update your card or cancel on the Billing page.
- The Taprel app itself is free: a plan is for printing from websites.
- A computer counts when it first prints for a domain on your account. Removing it on the Computers page frees its place.
- Need more than 50 computers? Email us. Your price stays the same as long as you stay subscribed.
For an agency
The account is whoever pays: you, for your customers’ websites, or a business, for its own. One account can hold all your customers’ domains, and their PCs count as its computers. A trial and Starter cover one domain, so for several customers, choose Pro.
How domains are matched
- A listed domain also covers its subdomains, so
shop.comcoversa.shop.com. Fororder.cafe.example, listcafe.exampleororder.cafe.example. - The scheme and port don’t count.
- Public endings like
vercel.appcan’t be listed. List your own address on them instead, likeone.vercel.app.
Local addresses, and more than 50 jobs on localhost
Addresses like 192.168.1.10, and localhost past the free limit, need the computer linked to an account on its trial or a paid plan, because they don’t say whose they are.
- In the Taprel app, open Settings, go to Taprel account and click Show code.
- Type the code on your account’s Computers page. It lasts 15 minutes.
Printing starts within a minute. When the trial ends with no plan, these addresses stop printing until you choose one.
If someone says no
- Block, in the browser, gives
BROWSER_BLOCKED. The package stops trying.browserPermissionTexts.afterBlocksays how to change it. - Don’t allow, in the app, gives
ORIGIN_NOT_ALLOWED, and the app remembers it. Removing the website on the app’s Websites page lets it ask again. - Closing the app’s window, or not answering within 2 minutes, refuses this time only, with the same
ORIGIN_NOT_ALLOWED. The next request asks again, with no reload needed.
The app treats each exact address as its own website, so http:// and https://, or another port, ask again.
If your site has a Content-Security-Policy
Add ws://127.0.0.1:21873 to connect-src, or you get the CONTENT_SECURITY_POLICY error.
When a payment fails, or our server can’t be reached
- A failed payment, an ended plan or too many computers starts 14 days of warnings. Printing goes on, and we email you. After that, printing stops with
LICENSE_REQUIRED. - If our server can’t be reached, the app keeps using its last answer for up to 30 days. With no usable answer, a job gets
LICENSE_UNAVAILABLE, and trying again later can work.
About the app
- Updates: it looks for a new version 30 seconds after it starts, then every 6 hours, and installs it when no job is printing.
- What it keeps: its settings, the websites it allowed or refused, and the last 200 jobs, on its Activity page.
- Its guide shows again from Show the welcome guide in Settings.
- Uninstall: in Windows’ Settings, open Apps, find Taprel and choose Uninstall.
What the app sends us
To check the licence, the app sends the website’s address, a random computer ID, its version, and daily job and failure counts per website, and our server sees its IP address. It never sends what you print.