All downloadsSign in

WorkPulse for Linux

64-bit AppImage. Runs on Ubuntu 22.04+, Debian 12+, Fedora, RHEL 9+ and derivatives — no installer and no root needed.

Download WorkPulse for Linux

WorkPulse-x86_64.AppImage · x86_64 only

You need an Xorg (X11) session

On a Wayland session WorkPulse cannot read keyboard and mouse activity, cannot see which window is in front, and cannot capture screenshots. Wayland deliberately withholds all three from applications. WorkPulse will still start and still record your clock-in and clock-out, but your activity will read as idle.

To switch: log out, then on the login screen click the gear icon (bottom-right on Ubuntu, bottom-left on Fedora) and choose the session ending in Xorg or X11 before entering your password. That choice is remembered for next time.

  1. 1

    Make the file executable

    A downloaded AppImage has no execute permission, so double-clicking it does nothing at all — no error, no window. In your Downloads folder run chmod +x WorkPulse-x86_64.AppImage, or right-click the file → Properties → Permissions and tick "Allow executing file as program".

  2. 2

    Install the helper packages

    WorkPulse works without them but loses a feature each: sudo apt install libxss1 xdotool libnotify-bin libayatana-appindicator3-1 (Debian/Ubuntu). Without xdotool no app or window names are recorded; without libxss1 idle detection is coarse; without the appindicator package there is no tray icon.

  3. 3

    Run it and sign in

    Double-click the AppImage, or run ./WorkPulse-x86_64.AppImage from a terminal. Enter your HRMS email and password in the sign-in dialog to link the tracker to your account.

  4. 4

    Turn on start-at-login

    In the tracker's settings, enable start at login. Keep the AppImage where it is afterwards — the autostart entry points at the file path, so moving or renaming it later stops it from starting.

Uninstalling

Deleting the AppImage is not enough on its own — it leaves the running process, the autostart entry, and a lock file that will stop a future install from starting. Run uninstall_linux.sh from the agent directory, or ask IT for it.

Stuck? Email support@nepalhrm.com