WorkDiary
Documentation

WorkDiary User Guide

Learn how to install, configure, and use WorkDiary to track your overtime work effectively.

Table of Contents

1

Installation

Install WorkDiary on your system
2

Login

Connect your account
3

Start Tracking

Begin your overtime session
4

Features & Settings

Customize your experience
5

Cloud Sync

Sync data to dashboard
6

Troubleshooting

Common issues & solutions

Installation

Get WorkDiary running on your computer

Windows

  1. 1. Download the .exe installer from the Download page
  2. 2. Run the installer and follow the setup wizard
  3. 3. Launch WorkDiary from the Start Menu or Desktop shortcut

Tip: If Windows SmartScreen warns you, click "More info" then "Run anyway". The app is safe but not code-signed yet.

Linux (Debian/Ubuntu)

  1. 1. Download the .deb package
  2. 2. Install using terminal:
sudo dpkg -i workdiary_*.deb
sudo apt-get install -f # Install dependencies
  • 3. Launch from Applications menu or run workdiary in terminal

    • macOS

    1. 1. Download the .dmg file
    2. 2. Open the DMG and drag WorkDiary to Applications folder
    3. 3. Launch from Applications or Spotlight

    Note: On first launch, right-click the app and select "Open" to bypass Gatekeeper. Go to System Preferences > Security & Privacy > Open Anyway.

    Login

    Connect your MegaAds account

    WorkDiary uses your MegaAds account for authentication. This allows seamless sync with your team's dashboard.

    Login Screen

    WorkDiary Login Screen

    1. 1

      Launch WorkDiary

      When you first open the app, you'll see the login screen.

    2. 2

      Click "Login with MegaAds"

      This will open your default browser for OAuth authentication.

    3. 3

      Authorize the app

      Log in with your MegaAds credentials and grant permission to WorkDiary.

    4. 4

      Return to the app

      After successful authentication, you'll be automatically redirected back to WorkDiary and logged in.

    Tip: Your login session is saved securely. You'll stay logged in until you manually log out.

    Start Tracking

    Begin recording your overtime work

    Starting a Session

    OT Form

    OT Form Dialog

    Fill OT Form

    Fill in OT Details

    1. 1. Click the "Start Tracking" button in the main window
    2. 2. Select your overtime type (if prompted) - e.g., "Evening OT", "Weekend OT"
    3. 3. Add an optional description for what you're working on
    4. 4. The app will begin tracking automatically

    During Tracking

    App Working

    App is tracking your work

    While tracking is active, WorkDiary will:

    • Capture screenshots at configured intervals (default: every 10 minutes)
    • Log active window titles and applications
    • Track keyboard and mouse activity levels
    • Record the total duration of your session

    Stopping a Session

    End OT Session

    Confirm end of OT session

    1. 1. Click the "Stop Tracking" button
    2. 2. Optionally add notes about what you accomplished
    3. 3. The session will be saved locally and queued for sync

    Important: Always remember to stop tracking when you finish working. This ensures accurate overtime records.

    Features & Settings

    Customize WorkDiary to your needs

    Admin only

    Screenshot Settings

    • Configure capture interval (5-30 min)
    • Enable/disable screenshots
    • Blur sensitive information

    Notifications

    • Reminder to start tracking
    • Screenshot capture alerts
    • Sync status notifications

    Activity History

    • View past sessions
    • See screenshots timeline
    • Export activity reports

    System Tray

    • Minimize to tray
    • Quick start/stop from tray
    • Status indicator

    Keyboard Shortcuts

    Start/Stop Tracking Ctrl + Shift + T
    Take Screenshot Ctrl + Shift + S
    Show/Hide Window Ctrl + Shift + W
    Open Settings Ctrl + ,

    Cloud Sync

    Sync your data to the team dashboard

    How Sync Works

    WorkDiary automatically syncs your overtime sessions to the cloud dashboard. Your team lead can then view and approve your overtime records.

    Automatic Sync

    Sessions are synced automatically when you stop tracking (requires internet)

    Offline Support

    If offline, data is stored locally and synced when connection is restored

    Encrypted Transfer

    All data is transferred securely over HTTPS

    Sync Status

    Check your sync status in the app:

    • Green: All data synced
    • Yellow: Sync in progress
    • Red: Sync failed / Offline

    Troubleshooting

    Common issues and solutions

    App won't start on Windows

    SmartScreen may block unsigned applications.

    Solution: Right-click the file > Properties > Check "Unblock" > Apply. Or click "More info" > "Run anyway" in SmartScreen dialog.

    Screenshots not being captured

    Permission issues may prevent screenshots.

    Solution: Grant screen recording permission in System Preferences (macOS) or ensure no other screen recording app is conflicting.

    Login fails or keeps redirecting

    OAuth callback may be blocked.

    Solution: Ensure your default browser allows popups and redirects. Clear browser cookies and try again.

    Sync stuck or failing

    Network or server issues.

    Solution: Check your internet connection. Try logging out and back in. If the problem persists, contact your administrator.