Skip to content

Gauzy Desktop Apps

Jump to bottom
Ruslan Konviser edited this page Sep 3, 2022 · 22 revisions

Desktop App Setup

  • Download Gauzy Desktop App for your OS from https://github.com/ever-co/gauzy/releases
  • 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 [email protected] 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 [email protected] and password 123456 to check Desktop Timer and other functionality from the "Employee" perspective (such user is an Employee).

Note: 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.

Setup Wizard Steps

Screen1

Screen2

Screen3

Screen4

Screen5

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 finished, you can find binary packages in the dist/apps/desktop-packages folder.

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

Windows

Desktop App

  • By default Gauzy Desktop App should be installed in the folder C:\Users\%USERNAME%\AppData\Roaming\gauzy-desktop
  • check logs in C:\Users\%USERNAME%\AppData\Roaming\gauzy-desktop\logs\main.log file for Desktop App

Desktop Timer App

  • By default Gauzy Desktop Timer App should be installed in the folder C:\Users\%USERNAME%\AppData\Roaming\gauzy-desktop-timer
  • check logs in C:\Users\%USERNAME%\AppData\Roaming\gauzy-desktop-timer\logs\main.log file for Desktop Timer App

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:

Clone this wiki locally