Fix common problems in the Mac app

If something goes wrong

“Qufy is taking too long to open your timer.”

Press “Try again”. If it shows again, press “Sign in again” and sign in with a new code.

“Qufy can't reach the website. Check the connection.”

Check that your Mac is online, then press “Try again”.

“Something went wrong while opening. The details are in the app log.”

Press “Try again”, then “Sign in again” if needed. If it keeps happening, send us feedback and mention the log file: ~/Library/Logs/studio.qufy.desktop/qufy.log. It never contains tokens or notes.

“The website refuses the sign-in code.”

Type the code the app shows now, and make sure you are signed in to the right account on the website. A code lasts 10 minutes. After too many tries, wait 10 minutes. The full list of messages is in the sign-in article.

“The Qufy widget does not appear in the widget gallery.”

Widgets need macOS 15 or later. Make sure Qufy is in your Applications folder and open it from there once, then look again.

“The widget does not update, or its buttons do nothing.”

Widget buttons work only while Qufy is running. If Qufy was closed, the first tap only opens it, so tap again. When no timer is running, the widget refreshes about every 15 minutes, and macOS may slow that down.

“There is no timer next to the Q in the menu bar.”

The time shows there only while a timer is running or paused, and only if Settings → “Menu bar” → “While the timer runs” is “Timer” or “Timer and amount” (not “Icon only”).

“Update required.”

Your version no longer works with the website. Press “Update now” and install the new version; see “Update the Mac app”.

“Actions waiting to sync do not go away.”

Check that you are online, then right-click the Q and choose “Sync”. If a timer comes back after you stopped it offline, press “Stop” again.

“You want to tell us about a problem.”

Press your name at the bottom of the sidebar and choose “About”. Under “Send us a note”, write your note and press “Send”. It goes straight to the Qufy team with the app and macOS versions; you see “Sent. Thank you.” If you are signed out, press “Sign in to send a note” first.