Gauzy Desktop Apps

Desktop App Setup

• Download the Ever Gauzy Desktop App for your OS from https://github.com/ever-co/ever-gauzy-desktop/releases or from official downloads page https://gauzy.co/downloads.
• Setup Gauzy Desktop App and run it.
• You can select all defaults, i.e., "Integrated" mode, "SQLite" DB, and "Default" port (that set port 5620 value for API). Click "Save," and after a couple of seconds (minutes), it will create a local SQLite DB
• Gauzy Desktop App is ready to use
• You can login with admin@ever.co and password admin to check Admin functionality. Note: an Admin user is not an employee, so you can't track time with this user.
• You can login with employee@ever.co and password 123456 to check Desktop Timer and other functionality from the "Employee" perspective (such user is an Employee).

ActivityWatch integration

Desktop App can connect to ActivityWatch* API to collect more statistics related to running apps and visit Urls. If you need that functionality, you can install ActivityWatch* and make sure it's running, and you selected the "ActivityWatch" checkbox in Gauzy Desktop App.

Note: you can also install ActivityWatch Browser Extensions (see bottom of https://activitywatch.net/downloads page). It will allow ActivityWatch to collect open tabs statistics from Firefox / Chrome browsers and Gauzy Platform will sync that data from ActivityWatch into Gauzy DB.

Below is information about Gauzy build-in capabilities and ActivityWatch integration capabilities:

Features	ActivityWatch	Gauzy Built-in
Window Title	Yes	Yes
App name	Yes	Yes
Browser Opened Url	Yes	No
User Activity %	No	Yes

Setup Wizard Steps

Building Manually

If you want to build a Desktop App manually, you need to run one of the following commands from the root of mono-repo:

• yarn build:desktop:windows for Windows
• yarn build:desktop:mac for Mac
• yarn build:desktop:linux for Linux

After the build is finished, you can find binary packages in the dist/apps/desktop-packages folder.

Debugging

See Debugging Gauzy Desktop Apps.

Troubleshooting

Common

• If you can't run Timer (e.g., it's greyed in the menus), it might be because the user you are using is not an Employee Role

Mac OS

• If you install ActivityWatch* on MacOS Monterey, please see https://github.com/ActivityWatch/activitywatch/issues/334#issuecomment-1052392579

• if after installation, the timer does not make a screenshot,

• Jump to preferences --> Security & privacy,
• If it's already checked, uncheck then check, it will solve you're issue

• Monterey version

• Somona version

• if after installation, you keep seeing an "Accessibility Access" popup

• Completely close Gauzy Desktop Timer,
• Remove Gauzy Desktop Timer from accessibility by clicking (-) then.
• Add Gauzy Desktop Timer again to accessibility by clicking (+).
• Launch Gauzy Desktop Timer and start.

Ubuntu / Linux

See Troubleshoot Desktop Apps on Linux.

Windows

See Troubleshoot Desktop Apps on Windows.

How to build & run multiple Gauzy Desktop Timer instances

To be able to run multiple Desktop App instances on your PC/Mac, please see How to build & run multiple Gauzy Desktop Timer instances.

How to get Logs

By default, Desktop apps writes logs to the following locations:

• on Linux: ~/.config/{app name}/logs/main.log
• on macOS: ~/Library/Logs/{app name}/main.log
• on Windows: %USERPROFILE%\AppData\Roaming{app name}\logs\main.log

Legal Notice

The links to third-party software are being provided as a convenience and for informational purposes only; they do not constitute an endorsement or approval of any of the products, services, or opinions of the corporation or organization, or individual. Ever Co. LTD bears no responsibility for the accuracy, legality, or content of the external sites or applications or for subsequent links. Contact the external site or application vendor for answers to questions regarding its content.

Please see the list of third-party software below:

• ActivityWatch