Help with Fibers

What Fibers needs

• A Mac with macOS 26 or later.
• A Fibery workspace you can sign in to. The FAQ says which Fibery plans Fibers works with.
• For the first setup in a workspace, a Fibery Admin: only Admins can create the Fibers space, which the Admin then shares with the team. Setting up a further database needs Architect access to it.
• To track time, Editor access to the database you track on and to the Fibers space.
• To track new time, a subscription or its free trial. The rest of Fibers needs neither (see The subscription).

Fibers doesn’t offer databases that a Fibery integration keeps in sync.

Getting started

1. Open Fibers. It lives in the menu bar, not in the Dock, and the first time it opens it shows its welcome window.
2. Choose whether to sync your settings with iCloud: Keep on This Mac Only, or Sync with iCloud. You can change this later in Settings → Sync.
3. Click Connect Fibery. Fibery’s own sign-in opens in your browser: sign in, choose your workspace and allow Fibers in. When the page says “You’re signed in to Fibery”, close the tab and go back to Fibers.
4. Choose the database you track time on. Fibers lists everything it would add to your workspace, by name, and creates nothing until you click Approve and Create.
5. On the last step, Start Tracking opens the panel. The same step may offer the free trial, with Start Free Trial and Not Now, and lets you set a keyboard shortcut to open Fibers and turn on launch at login.
6. Click the Fibers icon in the menu bar, type what you’re working on, and press the item’s play button or ⌘↩. Stop saves the session to Fibery.

After the first setup in a workspace, share the Fibers space in Fibery, since Fibery shows a new space only to Admins. As Fibers puts it: “Share the Fibers space with the people who will track time: Editor to track, Architect to set up more databases.”

If Fibers is already set up in your workspace, the databases ready to use say Tracking. If the list says “Fibers may already be set up in this workspace”, ask an Admin to share the Fibers space with you.

Common problems

Signing in doesn’t finish

You sign in on Fibery’s own page, in your browser, and Fibers shows “Waiting for you to finish signing in in your browser…” until you’re done there. Fibers never sees your password. If you decline in the browser, or five minutes go by, Fibers says “Sign-in was cancelled or didn’t finish. Try again when you’re ready.” Click Try Again. If you clicked Cancel in Fibers, a sign-in you then finish in the browser can’t reach Fibers any more: click Connect Fibery again.

Fibers works with one workspace at a time. If you choose another workspace in the browser than the one this Mac was set up for, Fibers asks before it switches.

“Your Fibery session expired”

Fibery has ended the sign-in, so Fibers can’t reach your workspace until you sign in again: click Sign In Again in the panel, or in Settings → Fibery. A timer that was running keeps running in Fibery, and changes made on this Mac that are still waiting are saved to Fibery once you’re signed in.

A database “needs repair”

Fibers relies on the fields it added to each database you track. If one of them is deleted or changed in Fibery, Fibers finds out when it checks, as it does for the database you’re tracking each time it starts, and the panel shows a prompt such as “Story setup needs repair”. To check a database yourself, open Settings → Databases, click Manage beside it and choose Check Setup in Fibery: the row then says “Set up correctly”, or “Needs repair” with what’s wrong and a Repair… button.

Review and Repair… in the panel, or Repair… in Settings, lists exactly what Fibers would restore, and nothing changes until you click Approve and Repair. Repairing needs Architect access to the database. If a field was changed by hand, Fibers may not be able to repair it on its own, and says what to ask an Admin to do. While only a total is affected, tracking still works, but that total won’t update until it’s repaired.

“Tracking on Story is paused”

The field that links sessions to the database is missing, or was changed in Fibery, and Fibers says: “Timers can’t start on Story until it’s repaired.” Review and Repair… shows what Fibers would restore, and restores it once you approve. Other databases you track aren’t affected.

“Offline · 2 to save”

When Fibery can’t be reached, the Fibers icon in the menu bar dims and the panel’s footer says Offline. Starting, pausing, stopping and adjusting a timer, editing a session, adding an entry and renaming an item keep working: Fibers applies each change at once, keeps it on your Mac, and sends it to Fibery once, in order, when the connection is back, and the footer says “Saving to Fibery…” while it does. Offline, the picker offers the items Fibers has already seen; searching Fibery and setting up a database need a connection.

Settings → Fibery shows the connection and how many changes are waiting. If you’d rather not send them, Discard Changes… lists what would be lost and asks first; discarding can’t be undone.

“Two timers are running”

Only one timer runs at a time. If one was started on another device while this Mac was offline, or Fibery has two of yours open, Fibers asks which to keep, with a button for each device, such as Keep This Mac’s. The one you don’t keep stops, and its time is saved.

“You were away for …”

While a timer runs, Fibers notices when the keyboard and mouse have been idle for longer than you chose, and the Fibers icon in the menu bar shows a dot. Open the panel to answer: Discard leaves the time away out, and the timer goes on from when you came back; Keep counts it; and More offers Discard and Stop the Timer, or Save the Away Time as a Separate Session. Settings → General → Ask about idle time after sets when Fibers asks: after 5, 10, 15 or 30 minutes, or Never. It starts at 10 minutes.

“Fibery refused the request. The workspace may restrict IP addresses.”

According to Fibery’s documentation, a workspace that accepts requests only from certain IP addresses refuses requests made through its MCP server, which Fibers uses for everything. Your workspace’s Admin can tell you whether yours does.

The subscription

Signing in, setting up databases, and looking through your items and their details need no subscription, and neither does anything that protects time you’ve already tracked: pausing, stopping, adjusting and editing it. Tracking new time, by starting or resuming a timer, with Create and Start, or with Add Entry, needs a subscription, yearly or monthly, bought in the App Store. Without one, those controls are disabled and say why, and Subscription… in the panel opens Settings → Subscription. A timer that’s running when a subscription ends keeps running, and stopping it saves its time.

The free trial

Each plan starts with a one-month free trial, which the App Store gives once per Apple Account. Fibers offers it on the last step of setup and in Settings → Subscription, with Start Free Trial; once you’ve had it, the button says Subscribe. The panel tells you when the free trial ends and what it renews at. After the free trial, the plan renews automatically, charged to your Apple Account, until you cancel it in the App Store’s subscription settings at least 24 hours before it renews.

Changing plan or cancelling

The App Store manages your subscription. In Fibers, Settings → Subscription → Manage Subscription opens the App Store’s subscriptions page, where you can change plan or cancel. You can also get there in the App Store app: click your name, then Account Settings, then Manage next to Subscriptions (Apple’s guide). Settings → Subscription then says when your subscription or your free trial ends.

On another Mac

The subscription belongs to your Apple Account, so it works on any Mac signed in to the same Apple Account in the App Store. Fibers usually finds it by itself; if it doesn’t, click Restore Purchases in Settings → Subscription. Redeem Code…, on the same pane, takes an offer code.

“Your payment didn’t go through”

The App Store couldn’t take a renewal’s payment and keeps trying. Update Payment Method, in Settings → Subscription, opens the App Store’s billing page.

Refunds

Apple takes the payments for the App Store, so refunds are Apple’s to give: ask for one at reportaproblem.apple.com. We can’t refund an App Store purchase ourselves.

“Fibers couldn’t reach the App Store to check your subscription”

Fibers asks the App Store whether you’re subscribed and keeps the last answer on your Mac. Once it has confirmed your subscription, new time can still be tracked while the App Store is out of reach; before that, new time waits until it can check. Click Retry in Settings → Subscription once you’re online.

Sending us Fibers’ log

Fibers’ log helps us see what happened. In Fibers, open Settings → About and click Export Log…, or choose Export Log… in the menu you get by right-clicking the Fibers icon in the menu bar. After a few seconds, save the file and attach it to your email. The log holds only what happened since Fibers was last opened, so export it before you quit Fibers or restart your Mac.

It’s a plain text file of the messages Fibers wrote, up to the last 24 hours: about signing in to Fibery, its requests to Fibery, timers, what it saved on your Mac and in iCloud, what the App Store said about the subscription, and what it asked of macOS, with the versions of Fibers and macOS. Fibers never logs passwords or sign-in tokens, and names, email addresses, workspaces, items and Fibery’s own messages show as “<private>”. You can read it before you send it, and Fibers never sends it anywhere itself. How we handle it once you send it is in the privacy policy.

Contact

Email hello@getfibers.app for help with Fibers, and privacy@getfibers.app for questions about your data. How we handle what you send us is in the privacy policy.

Fibers is made by Ktesio, in Rotterdam. It is an independent app, not made by Fibery: for Fibery itself, such as your plan or your workspace’s settings, ask Fibery.