RIVET
Track time. Invoice. Done.
Rivet is an app for time tracking and invoicing — for freelancers, tradespeople and small offices who write their own hours and issue their own invoices.
The core in three words: Work → Click → Riveted. You work, you capture the time with one click, and when you invoice it the entry becomes riveted — fixed, unchangeable, billed. Everything not yet riveted is open, and open time is what you invoice, in whole or in part.
This manual follows the order in which you put Rivet to work: set up, master data, track time, invoice, special topics.
1Basic concepts
Eight words that come up again and again in the rest of this manual.
| Term | Meaning |
|---|---|
| Company | Your own company, the sender of the invoices. Rivet can keep several; everything below it — customers, projects, pins, invoices — belongs to exactly one company. The active one is named at the bottom of the sidebar. |
| Customer | A client. Has a short name (for the app and the menu bar) and an invoice name (for the PDF), address, tax rate, payment term, rounding and defaults for new projects. |
| Project | A job for a customer. Carries the hourly rate, colour, symbol, note and the pins that apply there. Time is always recorded against a project. |
| Pin | An activity — “Meeting”, “Travel”, “Consulting”. |
| Time entry | A span from start to end on a project, with a pin or free text. Created by the timer or entered by hand. |
| Open | A time entry that has not been invoiced yet. |
| Riveted | Invoiced. The entry is locked: no editing, no deleting. It only becomes open again if you void the invoice and explicitly release the entries while doing so (chapter 10). |
| Billable | Whether an entry may go on an invoice. Inherited from the pin, frozen at start, switchable on the entry. |
1.1The hierarchy is strict
Customer → Project → Time entry. There is no time entry without a project and no project without a customer. This chain is the reason an invoice always knows where every minute came from.
1.2Pins exist on three levels
- Catalogue pin — company-wide, under “Pins” in the sidebar.
- Project pin — a copy inside the project, which may be adjusted there.
- Frozen at the entry — when the timer starts, title, rate and billable flag are copied onto the entry.
That is why changing a rate later never changes an entry that has already been recorded.
1.3Rounding
Times are stored to the second. Rounding happens only when invoicing: once per project and calendar day, onto the grid, 15 minutes by default.
Three entries of 5 minutes on the same day in the same project make 15 minutes, not 45. A rounding of 0 means to the minute.
2The first launch
On the very first launch — no company present — the setup assistant opens. Without a company there is no way into the app; on a first launch it cannot be cancelled.
It has two phases, visible in the progress rail at the top.
2.1Understanding — three pages, reading only
| Page | Content |
|---|---|
| How Rivet works | Customer → project → time, open versus riveted |
| Time tracking | Timer, pins, rounding |
| With you everywhere | Mac, iPhone, iPad, Watch, menu bar |
2.2Setting up — six steps
- My Company (required). Company name (required), street, postcode, city, country, email, website, tax number/VAT ID, bank details, payment term in days (empty = 14), invoice prefix (e.g. “INV-”), next invoice number, digits to pad with zeros. The “Results in:” line shows what comes out of it — for example
INV-0001. On the steppers the arrows sit to the left of the number so they do not wander while you adjust it. - Currency & invoice texts. Currency symbol (€, CHF, …), tax label, label for the tax number, small-business note, payment-term prefix, sentence for “payable immediately”. Everything is pre-filled; empty fields fall back to the German defaults.
- Invoice layout. Choose one of the bundled templates. Adjusting comes later in the layout editor (chapter 11).
- Pin catalogue. The first activities: title, symbol, colour, billing by the hour or as a flat rate (then the amount per entry is required), billable yes/no. “Skip” is possible.
- First customer. Skipping is possible.
- First project. Skipping is possible.
At the end: “Start RIVET”. On the Mac the main window appears and stays open.
2.3The second company
If you create a second company later (company switcher → “New company”, Pro only), the same assistant opens — without the information pages and with “Cancel”. Cancelling clears everything away again, even if a customer had already been created.
3The interface
Sidebar on the left, content on the right.
| Section | What it holds |
|---|---|
| Time tracking | Day view with metrics, timer and entries |
| Projects | Project tree (by customer or by year) and tiles |
| Shared projects | Team: “Shared with me” and “Shared by me” |
| Customers | Customer list or tile grid |
| Pins | The company-wide pin catalogue |
| Invoices | Invoice browser: year → month → invoice |
| My Company | Company details, invoice details, metrics |
| App settings | iPhone and iPad only — on the Mac: Rivet → Settings, ⌘, |
Next to the app name sits the badge PRO when Pro is active. At the very bottom, the company switcher (“ClockWork · Switch company”).
3.1List or tiles
Customers, projects and pins can be switched between list and tile grid with the button in the toolbar. The choice is remembered per device.
What a tile shows at a glance:
- Customer tile — logo, short name, city, the customer's projects as rows with symbol and colour (at most three, then “+N”), default pins at the bottom.
- Project tile — symbol, name, customer, metrics (hours, open, revenue … depending on the setting), pin chips, timer button.
- Pin tile — symbol and title, note, the projects the pin is active in, rate or “not billable” at the bottom.
3.2Context menu
Right-click or long press: “Edit”, “Bring forward” and “Send backward” for the order, “Delete” on pins, “Share” on projects.
3.3Colours
Customer, project and pin can each carry a highlight colour. It tints rows, tiles, avatars and chips throughout the app. Without a colour of its own the default applies: project blue, pin turquoise.
3.4Dialogues
All confirmations look the same — dark dialogue, primary button on the right. Wherever something is irreversible you are asked, and the question names numbers (“3 time entries, 2 pins”). Where there is nothing to decide, there is no question.
4My Company
Sidebar → My Company. Three cards.
4.1Company details
Company name, address (street, postcode, city, country, email, website), tax number or VAT ID, bank details, logo (choose an image, set the size for the invoice header).
Plus the commercial defaults:
- Small-business rule under German § 19 VAT Act: no VAT, statutory note on the invoice. Applies company-wide and beats every customer rate.
- Default tax rate — pre-filled for new customers.
- Default hourly rate, payment term in days, rounding in minutes (0 = to the minute, 15 = default).
The Save button is only active once something has changed. Unreadable input — letters in the payment term — snaps back to the last valid value.
4.2Invoice details
Invoice prefix, next invoice number (never below the last one issued), digits (can only be increased, at most 7). If invoices already exist, a note points out the visible jump, for example INV-41 → INV-0042. The “Results in: …” line shows the outcome live.
Behind “Configure” — its own window on the Mac, a sheet on iOS — sit the currency and the five invoice texts: currency, tax label, tax-number label, small-business note, payment-term prefix, payable-immediately sentence. The invoice language belongs here too (chapter 9.5).
“Open layout editor” leads to the layout editor (chapter 11).
4.3Metrics
Active customers and projects (archived ones counted separately), recorded hours, revenue, open amount — with the same rounding as the invoice.
5Customers
Creating: Customers → “Add customer” (+ in the toolbar or in the empty state). Short name and invoice name are required.
5.1The customer form
| Card | Fields |
|---|---|
| Customer | Short name, invoice name, symbol or image (a photo is cropped square), colour |
| Address | Street, postcode, city, country, email, website |
| Billing | Tax rate in % (pre-filled with the company value; 0 is a valid rate), the customer's tax number (pure master data), payment term in days (empty = inherit the company value, 0 = payable immediately), rounding in minutes (empty = company value, named in the footnote), invoice template, invoice language |
| Defaults for new projects | Hourly rate and default pins (“Manage”) |
New projects take the defaults as a starting point. A later change on the customer does not change existing projects.
5.2Changing the tax rate with open entries
Rivet asks whether the open entries should take the new rate (“Apply to open entries too”) or only future ones (“For new time only”). Invoiced entries always stay untouched. With no open time there is no question.
5.3Customer detail
Metrics, the customer's projects, the customer's invoices (the browser then shows only this one), “Edit”, “Archive customer”, backup export as .riv.
5.4Order
In the list by dragging, in the tile grid via the context menu “Bring forward” and “Send backward”. Survives a restart.
6Projects
Creating: from the customer (“Add project”) or under Projects with +. The name is required; the customer is pre-filled when you come from the customer.
6.1The project form
Name, customer (reassigning is possible — the tile shows the new customer immediately), hourly rate (pre-filled from the customer), symbol or image, colour, note, visible metrics (which values the tile shows: hours, open, revenue, entries …).
Changing the hourly rate with existing entries: Rivet asks whether existing open entries should take the new rate. If you decline, the old rates stay frozen.
6.2The project tree
Switch between “Sort by customer” and “Sort by year”. Groups can be expanded and collapsed. A new group — new customer, new year — appears expanded; groups you collapsed by hand stay collapsed.
6.3The project detail view
- Master-data card: customer, rate, note, colour
- Timer tile: start and stop right here, with the project pre-filled
- Metrics — 2 × 2 on iPhone, one row on Mac and iPad
- The project's pins with “Manage” (chapter 7)
- Toolbar: “Edit”, “Share” (chapter 13), “Archive”
Archiving with an open amount: the confirmation names it. Fully invoiced projects are archived without a question.
7Pins (activities)
7.1The catalogue
Sidebar → Pins → “Add pin”.
| Card | Fields |
|---|---|
| Pin | Title, default note, symbol (SF Symbol; “Change” opens the symbol browser with search), colour |
| Suggested values | Invoice text (empty = “same as title”), billing by the hour (hourly rate) or flat rate (amount per entry, required), billable |
These values are a template: they are copied when the pin is taken into a project. Below the form it says in how many projects the pin has been adopted.
Changing a catalogue pin: when saving, Rivet asks whether project pins that still carry the old value unchanged should follow. Only those are changed — a rate adjusted individually in a project stays.
Deleting a catalogue pin (context menu or “Delete” in the form): the confirmation names the dependencies — customers with this default pin, projects that have adopted it. The project pins remain; they are copies.
7.2Pins in the project
Project detail → “Manage pins”:
- “Take from catalogue” — select individual catalogue pins. Only the selection lands in the project, never the whole catalogue automatically.
- “Add pin” — a project-owned pin without catalogue origin.
- Edit project pin — title, invoice text, rate or flat amount, billable, own colour. An own colour beats the catalogue colour; an empty colour means “inherit from the catalogue”.
- Order by dragging or via the context menu.
7.3Pins on the time entry
When the timer starts, the pin is copied into the entry: name, rate, invoice text, billable flag. If the pin is renamed or repriced later, the entry stays as it was.
Only the colour is resolved live — a recoloured pin recolours old entries too.
Project without pins: the timer dialogue offers a free text field instead of the pin selection; the detail view shows “No pins yet”.
8Time tracking
8.1The day view
Four metric tiles at the top — entries, total, revenue, open — for the selected day. Below them the timer tile (empty or with a running timer) and the list of entries.
You change the date with the arrows or the date field. A day without entries shows an explanatory empty state.
Below the list are three buttons: “Prepare as invoice” (needs a selection belonging to exactly one customer), “Export” (chapter 18.4 — needs nothing) and “New timer”. On the iPhone they sit in the bottom bar, the export there as an icon only.
8.2Starting a timer
Seven ways, one timer: “New timer” in the day view, a project's timer tile, the menu-bar popover (Mac), the global hotkey (Mac), the bottom bar (iPhone), the watch.
The timer dialogue:
- Choose the customer — expand the “Not selected” slot. With shared projects the “Shared” group sits below.
- Choose the project.
- Choose a pin (chips) or type free text. Without input the entry is called “Without pin”.
- “Start timer”.
Or: tick “Enter time manually” → fill in start and end → “Save”. An end before the start is rejected.
If a timer is already running in this company, Rivet asks: “Timer already running”. “Stop & start” closes the old one and starts the new one, “Cancel” lets the old one run. There is never more than one timer per company.
A sound plays at the start (can be switched off, chapter 20).
8.3Stopping a timer
Stop button in the timer tile, in the popover, in the bottom bar, on the watch or through the hotkey dialogue. The entry appears with start and end time in the list, and the stop sound plays.
If the timer has meanwhile been stopped on another device, Rivet says so — instead of quietly creating a second entry.
Emergency stop. If a timer runs longer than the configured maximum (8, 10, 12, 16, 24 hours or off; per device, chapter 20), it is trimmed to that limit automatically — not to “now” — with a message. A timer forgotten overnight does not become a 40-hour entry.
8.4Editing entries
Select an entry → inspector (on the right or as a panel): label, start, end, note, billable, correct the hourly rate. Changes appear in the list and tiles immediately.
If start or end was changed by hand, the row carries the orange badge TIME EDITED — only for time changes, not for rate corrections.
- Multiple selection: mark several entries; the summary bar shows the count and total duration.
- Deleting: open entries can be deleted, the tiles update immediately.
- Locked entries (RIVETED): no editing, no deleting. The message explains why. An entry cannot be unlocked by hand — only voiding its invoice reopens it, and only when you are explicitly asked (chapter 10).
- Team entries: time an employee recorded on a shared project carries a badge with a person symbol and a name (chapter 13).
8.5Understanding rounding
The list shows raw times. Tiles, metrics and invoice round once per project and day onto the company's grid — or the customer's, if one is set there.
Every view except the list shows the same number as the invoice. If tile and list look different to you, this is exactly why.
9Creating invoices
Entry point: customer → “Prepare as invoice”. Also from the project detail view and from “Invoices”.
9.1The invoice editor
- Select services. All open, billable entries of the customer, grouped by project. Tick everything or only part of it — partial invoices are the normal case. Non-billable entries do not appear at all.
- Add a flat-rate line. Free text and amount, counted in the total.
- “Group” (menu above the preview): individually, by pin, by day, by week, by month, by project. Changes only the presentation, never the total — rounding happens before it.
- Check the header. Invoice number, date, service period and due date. The number is the one that lands on the PDF.
- “Preview”. Look at the finished PDF: line items, totals, company details.
- “Issue invoice”. Save dialogue for the PDF.
9.2After issuing
- The chosen entries are riveted and carry the badge in the list.
- The invoice sits in the archive with frozen company details, customer details, line items, layout, currency, tax texts and language.
- The next invoice number has increased by one.
9.3Taxes
- The tax rate of each entry is the customer's rate at the moment of the start, frozen. Two rates in one invoice are shown separately.
- The company's small-business rule: no VAT, but the statutory note instead.
- A tax rate of 0 is a real rate, not a missing value.
9.4Due date, external work, number format
Due date = invoice date + the customer's payment term (empty = company value, 0 = payable immediately).
External work: if the invoice contains time from employees, your own and other people's time appear as separate line items, and below the net total it says “of which external work” — a share, not a surcharge.
The number format is German (1.234,56 €). The currency symbol comes from “My Company”. In the line-item list quantities appear as hours:minutes (0:15 h, not 0.25 hrs) and dates in short form as 13.09.26; the invoice date and service period in the header stay written out.
9.5The invoice language
The printed PDF follows the customer, not the language you use Rivet in. A German customer gets a German invoice even if your Mac is set to English.
The chain is: customer → company → German.
- Per customer: customer form → Invoice language. “Same as company” is the default.
- Per company: My Company → Invoice details → “Configure” → Invoice language.
Only languages the app actually ships are offered. Currency, tax label and the small-business note are not translated — you type those yourself, and they stay exactly as entered.
Like everything else about a document, the language is frozen with the invoice: an archived invoice keeps the language it was issued in.
10Invoice browser and archive
Sidebar → Invoices: year → month → invoice, with counters. Opened from a customer, the browser shows only that customer's invoices.
Invoice detail: company details, customer, line items, totals — exactly as at the time of issuing. Later changes to the customer, company, rounding, tax texts or layout do not apply retroactively.
Re-export: save as a PDF again from the detail view. The PDF is identical in content to the original, even after layout changes — the layout is frozen in the archive.
The e-invoice is inside the PDF. Every PDF Rivet produces also carries the invoice in machine-readable form — in the EN 16931 format, embedded according to ZUGFeRD (also known as Factur-X). For the recipient it is an ordinary PDF; their accounting software finds the file factur-x.xml inside it and reads it without retyping. This is the form that becomes mandatory for domestic invoices to businesses on 1 January 2028, and on 1 January 2027 already for businesses with more than €800,000 in prior-year turnover. Small businesses under § 19 UStG and small-amount invoices remain exempt.
For a PDF to do that it has to conform to PDF/A-3. Rivet produces that form itself, without third-party tools, and checks it against veraPDF — the same tool public authorities validate with.
E-invoice (XML): in the invoice detail under “Export e-invoice”. The same invoice once more as a separate file, for recipients who ask for exactly that (some portals accept only the bare XML). Its content is the same file that sits inside the PDF.
The PDF is unaffected — there is still a sheet, plus a file. Both carry the same figures: the amount due in the file is the same to the cent as the total on the sheet. A void carries the document type “credit note” and positive amounts in the file; there the direction is in the type, not in the sign. On the sheet the negative figures remain.
If a detail the standard requires is missing, the list appears instead of the button: which field is missing and where to find it. The PDF then contains no e-invoice either — it is still produced, as an ordinary PDF. An invoice always comes out. Most often it is the country — it is not printed on a domestic invoice, but in an e-invoice it is mandatory, for you and for the customer. With reverse charge the customer's VAT ID is needed as well (§ 14a UStG).
Invoices to public authorities: XRechnung. Cities, government offices, schools and other public bodies require a stricter form of the same invoice — the German XRechnung standard. Rivet issues it as soon as the customer has a Leitweg-ID (customer dialog → Billing). You get the Leitweg-ID from the authority; it is their address in the invoicing portal. Without it no authority accepts an invoice, and with it the document is always an XRechnung — which is why no extra switch is needed. Rivet also recomputes the check digits at the end of every Leitweg-ID: if they do not add up, a note appears under the field. The number can still be saved — the warning is there to catch a transposed digit, not to contradict you.
XRechnung demands more than EN 16931, and Rivet tells you before the export what is missing: the company's phone number and email address (“My company”), an IBAN in your bank details, and postcode and city on both sides. For ordinary invoices to businesses nothing changes — those obligations do not apply there.
The reason for a tax exemption as a choice. If the customer carries an exemption note, Rivet has so far read from its wording what kind it is — it recognises “Steuerschuldnerschaft des Leistungsempfängers” (reverse charge) reliably. For an intra-community supply or an export delivery the text is not enough: both have their own code in the e-invoice, and a wrong classification is booked wrongly by the recipient even though every validator lets it pass. The customer dialog therefore shows the type under “Tax exemption”: automatic (as before), reverse charge, tax-exempt, intra-community supply or export. The note text remains the main switch — without it there is no exemption, neither on the sheet nor in the file.
Voiding: at the bottom of the invoice detail. A document of its own is created with the next invoice number; it cancels the invoice — same company and customer data, same line items, reversed sign. It can be exported and sent like any invoice.
Nothing about the voided invoice changes. It stays in the archive, and its PDF remains character for character the document the customer received. That it has been cancelled is stated in the app: in the invoice browser as a VOIDED badge, in the detail view as a line above. Not on the sheet — a note added afterwards would be a different document from the one that was sent.
The confirmation asks the one question that is genuinely open: should the time entries be open again? With yes they are, and they can go onto a new, correct invoice. With “Void only” they stay invoiced — permanently, because there is no second chance.
An invoice cannot be deleted, and therefore neither can a project or customer with invoice history.
11Invoice layouts
Opening: My Company → Invoice details → “Open layout editor”. On the Mac a window of its own called “Invoice layout”, on iPhone locked to portrait, on iPad the inspector as a sidebar (landscape) or a bottom panel (portrait).
Structure: the company's template library on the left, the page in the middle (A4, measurements in millimetres), the inspector on the right or below.
11.1Blocks
Sender, logo, customer and address, invoice number, date, due date, service period, table header, note text, line-item table, totals, bank details, page number, footnote.
Every block has a position and size in millimetres, font size and weight (regular, semibold, bold), alignment and a page rule: “First page only”, “Last page only”, “Every page”, “Continuation pages only”. The last one is meant for running heads — the invoice number at the top of every page but the first, for instance. It is not the same as “Last page only”: on a one-page invoice the last page IS the first, so a head with that rule would land in the middle of the letterhead.
From page 2 onwards, everything may sit elsewhere. Every block that does not appear on page 1 alone has a “From page 2” section in the inspector with the switch “Own frame on continuation pages”. Switched on, it gets its own X, Y, width and height there; page 1 stays untouched. The same happens when you simply move it on a continuation page — dragged from page 2 means meant from page 2.
Without a frame of its own, the line item table moves up on page 2 by itself, together with the column headings above it: there is no sender block over the table on the second page, and the space belongs to the items. Touch that frame once and you take the placement over — the automatic shift steps aside, and nothing jumps while it does.
Text blocks know placeholders — company name, company address, tax number, bank details, customer name, customer street, postcode and city, country, email and website of both company and customer, the customer's tax number.
11.2Handling
- Dragging a block: grab it in the middle with mouse or finger. Corners change the size. The measurements update in the inspector as you go.
- Grid: switch it on → blocks snap. Hold ⌥ or turn the grid off → free positioning.
- Arrow keys (Mac): move the selected block by 1 mm, with ⇧ by 10 mm. The canvas needs the keyboard focus — clicking the block is enough.
- Undo and redo: the two arrows in the toolbar, on the Mac also ⌘Z and ⇧⌘Z. They take back every change to the template — dragging, number fields, lines, added and deleted blocks. One continuous entry in a number field counts as a single step, not three. The history belongs to the open template: switching to another one starts it over.
- Adding: the “Block” menu in the toolbar. Add one while page 2 is on screen and its page rule starts out as “Every page” — otherwise it would leave the view in the very moment it is created.
- “Fit”: the whole page into the window.
- “Preview”: real sample data in the current layout, page breaks included.
- Validation: blocks outside the page or overlapping mandatory blocks are named when you save.
11.3Templates
“Save” (as a new template or overwrite), “Set as active” (used for new invoices, symbol checkmark.seal), and a ⋯ menu per template: duplicate, rename, delete, export as .rivlay (violet LAY icon in the Finder).
“Import template” adds it as a new template; the active one does not change. Damaged files are rejected.
The library belongs to the company. Every company has its own.
.rivlay file (export and import) needs Pro (chapter 21).12Multiple companies
The company switcher sits at the bottom of the sidebar: switch company, “New company” (Pro), archived companies.
Every company is completely separate — customers, projects, pins, invoice archive, number range, layouts, favourites, currency, metrics.
A timer belongs to its company: it does not run in company B and keeps running in company A. The active company survives a restart and is adopted by the watch.
Archiving a company (My Company): it disappears from the switcher, the data stays. The last active company cannot be archived.
13Shared projects (team)
Rivet shares projects through iCloud (CKShare). Requirement: both sides are signed in to iCloud. There is no server of our own and no Rivet account.
13.1Sharing — the owner's side
Project detail → “Share” (toolbar, context menu or “Manage sharing” — always the same dialogue).
- Create an invitation link, then “Send invitation link”.
- Invitation: email field and “Send invitation”. Two ways — “Send via iCloud” or “Send & share link” (the person is registered first, then the link follows). Only registered people can use the link; a link sent to a stranger is rejected by iCloud. That is intended.
- “Choose from Contacts …” opens the address-book browser with search across name, email and phone, badges ICLOUD and LINK ONLY, and “As favourite”.
- Visibility per project: seven switches with the counter “n / 7” — hourly rate, revenue, open, hours, entries, project note & pins, other people's time. For monetary values the dialogue warns and names the fields. Unticking “Visible to employees” hides the project from the employee; for the owner it stays visible, greyed out.
- Participants: each person with the status “joined” or “invited”, resend link, “Revoke access” (the confirmation names the person and the reach).
Sidebar → Shared projects → “Shared by me”: one tile per customer with the shared projects, participant chips and “n invitations pending”, plus “Invite” (a slim sheet with one email field) and favourite tiles that can be dragged onto a project tile — always with a confirmation.
When someone accepts, Rivet reports it once: “X accepted your invitation”.
13.2Working along — the recipient's side
Accept the invitation → the project appears under Shared projects → “Shared with me”, with the customer as a subtitle and the role line (“Jo · employee · write access”). A notice names a newly arrived project once.
- Start a timer: directly in the overview or in the timer dialogue (customer slot → “Shared” group). Pins appear only if the “project note & pins” bit is shared, otherwise there is free text.
- Only what is shared is visible — no greyed-out placeholders.
- The “My times” card: your own entries with date, activity, from–to and duration. The period is adjustable, pre-filled with the current month. The total rounds like the owner's invoice. “Record as PDF” produces a proof of performance with your own company in the header; time already invoiced stays in it with the RIVETED badge.
- “Create as client”: creates the owner as a customer of your own (address pre-filled if they entered one), so you can bill the time in your own records — a mirror project.
- No invoicing, no archiving, no deleting on someone else's project.
13.3Checking a share
Settings → Synchronisation → Sync diagnostics → “Check sharing”: per shared project the customer, share identifier and scope.
14macOS: menu bar, hotkey, duo app
On the Mac, Rivet is a duo app: main window and menu-bar item in the same program.
14.1The menu-bar popover
Click the icon → start and stop timers (customer, project, pin), today's times, a button “App” to the main window. While a timer runs, the time sits next to the icon and counts up.
14.2Global hotkey
Settings → Menu bar. Opens the quick-start dialogue from any app: start or stop a timer without bringing Rivet to the front. If the system already uses the combination, it will not take effect — Rivet stays usable either way.
14.3Menu bar only
No main window, no Dock icon; the app is operated through the menu bar. You get back via the popover (“App”) or the setting.
Launch at login: Rivet starts when you sign in, in the configured mode.
14.4Closing the window does not quit Rivet
The app and the timer keep running in the menu bar. You bring the window back through File → New window or the popover. Quit with Rivet → Quit (⌘Q).
Settings: Rivet → Settings … (⌘,) opens a window of its own with a sidebar (chapter 20). Invoice texts and the layout editor have their own windows too; closing them with unsaved changes brings up Save / Discard / Cancel.
Window sizes and positions are remembered. Dark mode is supported.
15iPhone and iPad
You open the sidebar with the button at the top left. On iPad in landscape, sidebar and content sit side by side. “App settings” is a separate sidebar item there.
Bottom bar (iPhone, time tracking): shows the running timer with customer, project and time — regardless of the day on display — with a stop button.
Metrics appear as a 2 × 2 grid in portrait and as a flat row in landscape.
The layout editor is locked to portrait on iPhone; afterwards time tracking rotates again. In Split View on iPad, Rivet behaves as it does on iPhone when narrow.
Backup files (.riv, .rivbak) and layouts (.rivlay) open by tapping them in Files, with the import preview.
16Apple Watch
The watch shows the company that is active on the iPhone — there is no switcher of its own.
Three pages: company overview, recorded times (today), timer (choose a project, start, stop).
The watch talks to iCloud directly. A timer can be started even without the iPhone in range; after the sync it appears on iPhone and Mac. On the watch, the emergency stop is fixed at 12 hours.
RivetGo is part of Pro (chapter 21).
17Synchronisation via iCloud
All data sits in your private iCloud in Rivet's container and is mirrored between your devices. Without a network Rivet keeps working locally; changes arrive with their original timestamps as soon as the device is back online.
17.1Settings → Synchronisation
- Sync interval (1 minute to 1 hour or “Manual”): how often Rivet pulls arrived changes into the views. Per device.
- “Refresh now” with “Last updated”: catches up the local half. The app cannot force an iCloud import.
- Sync diagnostics: an event log with timestamps, plus “Check sharing”.
- Sync pause: set by the reset assistant (chapter 19).
17.2What Rivet resolves by itself
Duplicate timer. If two devices each start a timer for the same company while offline, the older one is closed when they meet — with a message.
Clock drift between devices is detected when stopping and reported, instead of producing a 0:00 entry.
A yellow sync warning appears on the affected view for as long as synchronisation is disrupted.
18Backups, import and export
Three kinds of file:
| Extension | Content |
|---|---|
.riv | Backup of one customer with projects, pins and times. Customer detail → export; required before permanent deletion. |
.rivbak | Backup of the whole app with all companies |
.rivlay | One invoice template |
.csv | Tracked time as a table, for Excel, Numbers or your accountant (18.4) |
18.1Settings → Backup
- “Create backup now”: a
.rivbakto a location you choose. - “Restore backup …”: choose a file → the preview names customers, projects and entries → “Import”. Cancelling changes nothing; damaged files are rejected with a message.
- Automatic backups with rotation, so the folder does not grow without limit.
18.2Protecting backups with a password
A backup leaves the app: it sits on a stick, in a cloud folder or in a mail attachment, and it holds your tax number, your bank details, every customer name and every note. Without a password all of that is in plain text.
“Protect backups with a password …” sets one. From then on all backups are encrypted — the automatic ones as well as the ones you save yourself. The password lives in your device’s keychain and is not synced through iCloud; on a second Mac you type it once.
When restoring, Rivet does not ask for the password on the same device — it fetches it itself. The prompt appears only for a backup that came from somewhere else.
Backups written earlier stay as they are: files saved without a password can still be read without one.
Importing customers: Customers → Import (.riv). Always lands in the active company. Double-clicking a .riv or .rivbak in the Finder opens Rivet with the import preview.
18.4Exporting time as CSV
A backup is a copy for Rivet itself. If you need your numbers somewhere else — at your accountant’s, in a spreadsheet, in another system — use the export. It is free and does not need Pro.
In time tracking, below the list: “Export”. The dialog starts from what is on screen and lets you change three things:
- Scope — if rows are ticked, “Selection only” is offered and preselected. Otherwise the period applies.
- Period and customer — from/to as in the day view, plus a customer filter that the day view does not have.
- Columns — seventeen to choose from, ten are ticked: date, from, to, duration (decimal), customer, project, pin, hourly rate, amount, status. Your choice is remembered.
At the top it says what you will get: “142 rows · 86:15 h · 7,420.00 €”. An empty file cannot be written at all.
The format targets Excel: UTF-8 with a byte-order mark, semicolon as the separator, numbers with the locale’s decimal separator and no thousands separator. A double-click is enough, accented characters survive, and amounts arrive as numbers, not as text.
The very first line of the file reads sep=;. It is an instruction to Excel and it is needed because Excel otherwise takes its separator from the system’s region settings — if that is the comma, the whole table lands in column A without this line and every amount breaks at its decimal separator. Excel and LibreOffice swallow the line; other programs may show it as a first row, which you delete once.
Two columns are deliberately left empty where the list on screen shows a dash: a flat rate has no duration and no hourly rate, a non-billable entry has no amount. A dash in a number column would be text and would spoil the whole column.
18.5Exporting automatically every day
Settings → Export → “Export automatically every day”. From then on Rivet writes one file once per calendar day when the app starts, covering the current month. The columns are the ones you last chose by hand.
“Choose folder …” decides where. Without a choice the file lands in Rivet’s own folder — reachable on the Mac through “Show folder in Finder”. The switch is off by default: a backup is a safety net, an export puts customer and revenue data into a folder you have to name first.
19Archiving, deleting and resetting
The normal way is archiving, not deleting.
Customers, projects and companies are archived: they disappear from lists and pickers but are kept with all their data, and can be found and reactivated through “Show archived”. Archiving needs Pro.
19.1Deleting permanently
Only possible on an archived record, from the detail view:
- The confirmation names time entries and pins.
- A backup (
.riv) is required first. If you cancel the save dialogue, everything stays. - Blocked while a timer runs (in this company only) and when invoice history exists — invoices must not lose their basis.
Catalogue pins are deleted directly, with a confirmation when dependencies exist; open time entries likewise. Invoices and riveted entries never.
19.2Resetting Rivet
Settings → Reset → “Reset Rivet” starts a multi-step assistant for a complete fresh start:
- You only get on with the tick “I have backed up everything”.
- Automatic backups must demonstrably be copied to a location you choose.
- Shares are ended or left, each named.
- Synchronisation is paused — the pause survives a restart, so a second device cannot mirror anything back.
- A running timer blocks the deletion.
On iOS, the iCloud data comes with directions into the system settings, not a button. A button could only jump into Rivet's own app settings there, not into iCloud management — so it would do nothing.
20App settings
Mac: Rivet → Settings … (⌘,). iPhone and iPad: sidebar → App settings.
| Section | Content |
|---|---|
| Synchronisation | Interval, refresh now, sync diagnostics |
| Backup | Create and restore backups, automatic backups |
| Export | Daily CSV export, target folder (chapter 18.5) |
| Launch & sounds | Splash screen on/off, start and stop sounds on/off, tooltips |
| Safety net | Emergency-stop maximum: 8, 10, 12, 16, 24 hours or off |
| Menu bar (Mac) | Global hotkey, menu bar only, launch at login |
| Pro | The purchase page (chapter 21) |
| Reset | Reset Rivet (chapter 19) |
Sounds, splash, interval, emergency stop, hotkey and launch at login are per device — they do not travel over iCloud. All settings survive a restart.
21Free and Pro
| Free | Pro | |
|---|---|---|
| Companies | 1 | unlimited |
| Customers | 1 | unlimited |
| Projects | 1 | unlimited |
| Backup export and import | — | ✓ |
Template exchange (.rivlay) | — | ✓ |
| Archiving | — | ✓ |
| RivetGo on the Apple Watch | — | ✓ |
| Shared projects (team) | — | ✓ |
Existing data above the limit always stays accessible — the app only blocks creating, never access. Archived companies do not count against the limit. With Pro active, PRO sits at the top of the sidebar next to the app name.
21.1Buying Pro
Settings → Pro. Everything is there: what Pro unlocks, both terms with prices, “Restore purchases” and “Manage subscription”. The same page opens from every lock notice through the button “View Pro” — anyone who hits a free limit does not have to look for the way there.
There are two terms, both unlocking the same thing:
- 1 month — cancellable monthly.
- 1 year — cheaper; the saving appears as a badge on the card.
Payment goes through your Apple account. The subscription renews automatically until you cancel it; you can cancel at any time up to 24 hours before the current period ends.
21.2On every device
The purchase belongs to your Apple ID, not to the device. Mac, iPhone, iPad and the watch recognise it by themselves — the watch asks the App Store directly and needs no connection to the iPhone for it.
If a device still shows Free: Settings → Pro → “Restore purchases”.
21.3Cancelling, switching, checking prices
Settings → Pro → “Manage subscription”. On iPhone the system sheet opens, on the Mac the App Store. Switching between monthly and yearly happens there too.
After cancelling, Pro stays active until the end of the paid period. After that Free applies again — your data is kept in full.
If a payment fails, Apple keeps trying for a few days. Pro stays active during that time: an expired card does not take your second company away mid-month.
22Common questions and symptoms
I cannot change an entry. It is riveted, that is, invoiced. This is intended. Corrections go through a new invoice with a flat-rate line, not through the old one.
“Save” stays grey. A required field is missing: short name or invoice name on the customer, name on the project, title on the pin, and for a flat rate the amount per entry. The text below the form says what is missing.
The invoice did not use up a number even though I pressed “Issue”. You cancelled the save dialogue, or the location was not writable. Nothing is issued until the export succeeds.
Tiles and invoice show different hours than the list. The list shows raw times; everything else rounds per project and day onto the grid from “My Company” or from the customer. A rounding of 0 means to the minute.
The timer was trimmed to 12 hours. Emergency stop. You set the maximum in Settings → Safety net.
I cannot see customers from another company. Correct — every company is separate. Switch at the bottom of the sidebar.
An employee sees projects I never shared. iCloud shares the customer as a whole. In the sharing dialogue, untick “Visible to employees” per project.
The invitation link does not work for the recipient. The person must be registered as a participant — email in the sharing dialogue. A forwarded link to an unregistered address is rejected by iCloud. That is not a fault.
After the reset, data came back from the second device. The assistant pauses synchronisation. If the pause was bypassed — because the second device was offline and came back later — reset on the second device as well.
The change to a catalogue pin did not arrive in the project. Only project pins that still carried the old value unchanged are updated — and only if you confirm the question when saving. Individually adjusted project pins stay.
The address book is empty. Contact access denied: System Settings → Privacy → Contacts. Without access, favourites and the manual email keep working.
The purchase page shows no prices. No connection to the App Store. Try again later; your data and the free scope are unaffected.
The invoice is printed in the wrong language. The document follows the customer, not the app. Customer form → Invoice language, or the company default under My Company → Invoice details → Configure. An invoice already issued keeps the language it was issued in.
23Keyboard shortcuts and quick reference
23.1macOS
| Shortcut | Effect |
|---|---|
| ⌘, | Settings |
| ⌘? | This manual |
| ⌘N | New window (File menu) |
| ⌘W | Close window — the app keeps running in the menu bar |
| ⌘Q | Quit Rivet |
| Hotkey | freely chosen: quick-start dialogue from any app |
| Arrow keys | in the layout editor: move a block by 1 mm |
| Hold ⌥ | in the layout editor: grid temporarily off |
23.2The everyday flow
- Start a timer — popover, hotkey, day view, project, bottom bar or watch.
- Stop the timer → the entry is open.
- Customer → “Prepare as invoice” → selection → preview → issue.
- Entries riveted, PDF saved, invoice in the archive.
23.3File extensions
| Extension | Content |
|---|---|
.riv | Customer backup |
.rivbak | App backup |
.rivlay | Invoice layout |
23.4What never happens
- An issued invoice changes afterwards.
- A riveted entry is changed or deleted.
- A whole catalogue is copied into a project.
- An invoice number is used up without a saved PDF.
- A customer with invoice history is deleted.