snapshot of https://github.com/ActivityWatch/activitywatch.git (master, 2026-09-15; blobs > 131072B omitted)

.github/FUNDING.yml

@@ -0,0 +1,8 @@
+# Docs for this file can be found here:
+# https://docs.github.com/en/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository
+
+github: ["ActivityWatch", "ErikBjare", "johan-bjareholt"]
+patreon: "erikbjare"
+open_collective: "activitywatch"
+liberapay: "ActivityWatch"
+custom: ["https://activitywatch.net/donate/"]

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,58 @@
+---
+name: "\U0001F41E Bug report"
+about: Did you find a bug?
+title: ''
+labels: 'type: bug'
+assignees: ''
+
+---
+
+<!--
+  Hi there! Thank you for discovering and submitting an issue.
+
+  Before you submit this; let's make sure of a few things.
+  Please make sure the following boxes are ticked if they are correct.
+  If not, please try and complete them first.
+-->
+
+<!-- Checked checkbox should look like this: [x] -->
+ - [ ] I am on the [latest](https://github.com/ActivityWatch/activitywatch/releases/latest) ActivityWatch version.
+ - [ ] I have searched the issues of this repo and believe that this is not a duplicate.
+
+
+<!--
+  Once those are done, if you're able to fill in the following list with your information,
+  it'd be very helpful to whoever handles the issue.
+-->
+
+- **OS name and version**: <!-- Replace this comment with OS name + version -->
+- **ActivityWatch version**: <!-- Replace this comment with the ActivityWatch version (found at the bottom of the Web UI) -->
+
+## Describe the bug
+<!-- A clear and concise description of what the bug is. -->
+
+## To Reproduce
+<!--
+  Steps to reproduce the behavior, for example:
+    1. Go to '...'
+    2. Click on '...'
+    3. Scroll down to '...'
+    4. See error
+-->
+
+## Expected behavior
+<!-- A clear and concise description of what you expected to happen. -->
+
+## Documentation
+<!--
+  If applicable, add screenshots or logs to help explain your problem.
+
+  Logs can be found in different places depending on platform:
+   - Windows: `C:\Users\<USER>\AppData\Local\ActivityWatch\Logs`
+   - macOS: `/Users/<USER>/Library/Logs/activitywatch`
+   - Linux: `/home/<USER>/.cache/activitywatch/log`
+  They can be opened with any plain text editor.
+-->
+
+## Additional context
+<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,19 @@
+# Issue templates are based on templates for poetry:
+# https://github.com/python-poetry/poetry/tree/master/.github/ISSUE_TEMPLATE
+blank_issues_enabled: false
+contact_links:
+  - name: "\U0001F381 Feature requests"
+    url: https://forum.activitywatch.net/c/features
+    about: Request and vote on features on the forum.
+  - name: "\u2753 Support"
+    url: https://forum.activitywatch.net/
+    about: Need help with something? Ask for help on the forum!
+  - name: "\U0001F4AD Discussion (on our forum)"
+    url: https://forum.activitywatch.net/
+    about: The preferred place for general discussion about ActivityWatch
+  - name: "\U0001F4AD Discussion (on GitHub Discussions)"
+    url: https://github.com/ActivityWatch/activitywatch/discussions
+    about: We're testing it out (but the forum is still the preferred place).
+  - name: "\U0001F4AC Chat with us on Discord"
+    url: https://discord.gg/dctJK6USjK
+    about: We love to see people who are active in issues on our Discord, come join us!

.github/ISSUE_TEMPLATE/everything-else.md

@@ -0,0 +1,18 @@
+---
+name: "\U0001F5C3 Everything Else"
+about: For questions and issues that do not fall in any of the other categories.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!-- Describe your question and issue here. This space is meant to be used for general questions that are neither bugs nor feature requests. If you're looking for help or support, please post on the forum instead: https://forum.activitywatch.net/ -->
+
+
+<!-- Checked checkbox should look like this: [x] -->
+- [ ] I have searched the [issues](https://github.com/ActivityWatch/activitywatch/issues) of this repo and believe that this is not a duplicate.
+- [ ] I have searched the [documentation](https://docs.activitywatch.net/en/latest/) and believe that my question is not covered.
+
+## Issue
+<!-- Now feel free to write your issue, but please be descriptive! Thanks again 🙌 ❤️ -->

.github/dependabot.yml

@@ -0,0 +1,27 @@
+# Set update schedule for GitHub Actions
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+
+  # Maintain submodule versions so module releases propagate into the meta-repo
+  - package-ecosystem: "gitsubmodule"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+
+  # Maintain dependencies for pip/poetry
+  # NOTE: too noisy, easier to update by hand
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    open-pull-requests-limit: 0
+    ignore:
+      # pytest 9.0.3 is the first non-vulnerable release, but it requires
+      # Python >=3.10 while ActivityWatch still builds/releases on Python 3.9.
+      - dependency-name: "pytest"
+        versions: [">=9"]

.github/stale.yml

@@ -0,0 +1,19 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 365
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 14
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - '!pinned'
+  - 'priority: high'
+  - 'improves: security'
+  - 'improves: sustainability'
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/workflows/codeql.yml

@@ -0,0 +1,43 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+  schedule:
+    - cron: "57 14 * * 4"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ python, javascript ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+        with:
+            submodules: recursive
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: ${{ matrix.language }}
+          queries: +security-and-quality
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v4
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v4
+        with:
+          category: "/language:${{ matrix.language }}"

.github/workflows/dependabot-automerge.yml

@@ -0,0 +1,27 @@
+name: Dependabot Auto-merge
+
+# NOTE: This workflow relies on a Personal Access Token from the @ActivityWatchBot user
+#       See this issue for details: https://github.com/ridedott/merge-me-action/issues/1581
+
+on:
+  workflow_run:
+    types:
+      - completed
+    workflows:
+      # List all required workflow names here.
+      - Build
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  auto_merge:
+    name: Auto-merge
+    runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion == 'success' && github.actor == 'dependabot[bot]'
+
+    steps:
+      - uses: ridedott/merge-me-action@e45e8ab1dd3d3dc1d27b8c0a3f465e40e8c9fb8e # v2
+        with:
+          GITHUB_TOKEN: ${{ secrets.AWBOT_GH_TOKEN }}

.github/workflows/diagram.yml

@@ -0,0 +1,28 @@
+name: Diagram
+
+on:
+  workflow_dispatch: {}
+  push:
+    branches:
+      - diagram
+     #- master  # protected branch, can't push updated diagram to
+
+jobs:
+  update-diagram:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+        with:
+          submodules: recursive
+      - name: Also checkout docs & website
+        run: |
+          git clone https://github.com/ActivityWatch/docs
+          git clone https://github.com/ActivityWatch/activitywatch.github.io
+      - name: Update diagram
+        uses: githubocto/repo-visualizer@a999615bdab757559bf94bda1fe6eef232765f85 # main
+        with:
+          commit_message: 'chore: update diagram [skip ci]'
+          file_colors: '{"rs": "#b7410e", "py": "#229922", "rst": "pink", "txt": "pink", "md": "pink", "css": "purple", "scss": "purple"}'
+          excluded_globs: "**/.github;**/.git;**/*.builds;**/*.bat;**/*.iss;**/*.ps1;**/*.pyi;**/*.plist;**/*.cmd"
+          #excluded_paths: '.github'

.github/workflows/greetings.yml

@@ -0,0 +1,25 @@
+name: Greetings
+
+on: [issues, pull_request]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'ActivityWatch'  # don't run on forks
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: >
+          Hi there!
+
+          As you're new to this repo, please make sure you've used an appropriate [issue template](https://github.com/ActivityWatch/activitywatch/issues/new/choose) and searched for duplicates (it helps us focus on actual development!).
+          We'd also like to suggest that you read our [contribution guidelines](https://github.com/ActivityWatch/activitywatch/blob/master/CONTRIBUTING.md) and our [code of conduct](https://github.com/ActivityWatch/activitywatch/blob/master/CODE_OF_CONDUCT.md).
+
+          Thanks a bunch for opening your first issue! 🙏
+        pr-message: >
+          Congratulations on opening your first pull request to this repo!
+
+          We'll get back to you as soon as possible. In the meantime, please make sure you've read our [contribution guidelines](https://github.com/ActivityWatch/activitywatch/blob/master/CONTRIBUTING.md).
+
+          Thanks for contributing!

.github/workflows/research-feed-publisher-tests.yml

@@ -0,0 +1,25 @@
+name: Research feed publisher tests
+on:
+  pull_request:
+    paths:
+      - 'scripts/package/publish_research_feed.py'
+      - 'scripts/tests/test_publish_research_feed.py'
+      - '.github/workflows/research-feed-publisher-tests.yml'
+  push:
+    branches: [master]
+    paths:
+      - 'scripts/package/publish_research_feed.py'
+      - 'scripts/tests/test_publish_research_feed.py'
+      - '.github/workflows/research-feed-publisher-tests.yml'
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.9'
+      - run: pip install pytest 'semver>=3,<4'
+      - run: python3 -m pytest scripts/tests/test_publish_research_feed.py -q

.github/workflows/test.yml

@@ -0,0 +1,175 @@
+name: Test
+
+on:
+  #push:
+  #  branches: [ master ]
+  #pull_request:
+  #  branches: [ master ]
+  workflow_dispatch:
+
+
+
+jobs:
+  # an integration test designed to catch bugs triggered by updating (database migrations and such)
+  upgrades:
+    name: upgrade from ${{ matrix.aw_server_old }} ${{ matrix.aw_server_old_args }} to ${{ matrix.aw_server_new }} ${{ matrix.aw_server_new_args }}
+    # needs: [build]
+    #if: startsWith(github.ref, 'refs/tags/v')  # only run on tag
+    runs-on: ubuntu-latest
+    env:
+      old_version: 'v0.12.2'
+      new_version: 'v0.13.1'
+    strategy:
+      fail-fast: false
+      matrix:
+        aw_server_old: ['aw-server', 'aw-server-rust']
+        aw_server_new: ['aw-server', 'aw-server-rust']
+        aw_server_old_args: ['']
+        aw_server_new_args: ['']
+        include:
+          # python, peewee (default)
+          - aw_server_old: 'aw-server'
+            aw_server_new: 'aw-server'
+          # python, sqlite
+          # FIXME: sqlite broken since aw-server enabled flask multithreading (new default)
+          - aw_server_old: "aw-server"
+            aw_server_new: "aw-server"
+            aw_server_old_args: "--storage sqlite"
+            aw_server_new_args: "--storage sqlite"
+            old_version: 'v0.12.2'
+            new_version: 'v0.13.1'
+          # python, peewee to sqlite
+          # FIXME: broken, same thing with sqlite as above
+          - aw_server_old: "aw-server"
+            aw_server_new: "aw-server"
+            aw_server_old_args: "--storage peewee"
+            aw_server_new_args: "--storage sqlite"
+            old_version: 'v0.12.2'
+            new_version: 'v0.13.1'
+        exclude:
+          # rust to python, not supported
+          - aw_server_old: 'aw-server-rust'
+            aw_server_new: 'aw-server'
+
+    steps:
+      # Will download all artifacts to path
+      - name: Download build artifacts
+        if: ${{ env.new_version == 'this' }}
+        uses: actions/download-artifact@v8
+        with:
+          name: builds-Linux-py3.9
+          path: dist
+
+      # Only used during testing, so we don't have to wait for the main build job
+      - name: Download new ActivityWatch
+        if: ${{ env.new_version != 'this' }}
+        run: |
+          mkdir dist
+          pushd dist
+          wget -q https://github.com/ActivityWatch/activitywatch/releases/download/${{ env.new_version }}/activitywatch-${{ env.new_version }}-linux-x86_64.zip
+
+      - name: Install new & old ActivityWatch
+        run: |
+          pushd dist
+
+          # New version
+          unzip activitywatch-*-linux-x86_64.zip
+          mv activitywatch/ aw-new
+
+          # Old version
+          wget -q -O aw-old.zip https://github.com/ActivityWatch/activitywatch/releases/download/${{ env.old_version }}/activitywatch-${{ env.old_version }}-linux-x86_64.zip
+          unzip aw-old.zip
+          mv activitywatch/ aw-old
+
+      - name: Display structure of downloaded files
+        run: ls -R
+        working-directory: dist
+
+      - name: Run and test old server
+        run: |
+          bin=dist/aw-old/${{ matrix.aw_server_old }}/${{ matrix.aw_server_old }}
+          url="http://localhost:5600"
+
+          # Check version
+          $bin --version || true  # due to bug in old aw-server
+
+          # Run server and log output
+          $bin ${{ matrix.aw_server_old_args }} >> log-old.txt 2>&1 &
+          sleep 5  # wait for startup
+
+          # Set server URL
+
+          # Get server info
+          curl "$url/api/0/info" --fail-with-body
+
+          # Create bucket
+          curl -X 'POST' --fail-with-body \
+            "$url/api/0/buckets/aw-test" \
+            -H 'accept: application/json' \
+            -H 'Content-Type: application/json' \
+            -d '{
+            "client": "test",
+            "type": "test",
+            "hostname": "test"
+          }'
+
+          # Get buckets
+          curl "$url/api/0/buckets/" -H 'accept: application/json'
+
+          # Send a heartbeat
+          timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+          curl -X 'POST' \
+            "$url/api/0/buckets/aw-test/heartbeat?pulsetime=0" \
+            -H 'accept: application/json' \
+            -H 'Content-Type: application/json' \
+            -d '{
+            "timestamp": "'$timestamp'",
+            "duration": 0,
+            "data": {"key": "test value"}
+          }'
+
+          # Give a sec, then kill server process
+          sleep 1
+          kill $!
+
+      - name: Run and test new server
+        run: |
+          bin=dist/aw-new/${{ matrix.aw_server_new }}/${{ matrix.aw_server_new }}
+          url="http://localhost:5600"
+
+          # Check version
+          $bin --version
+
+          # Run server and log output
+          $bin ${{ matrix.aw_server_new_args }} >> log-new.txt 2>&1 &
+          sleep 5  # wait for startup
+
+          # Get server info
+          curl "$url/api/0/info"
+
+          # Get buckets
+          curl "$url/api/0/buckets/" -H 'accept: application/json'
+
+          # Send a heartbeat
+          timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+          curl -X 'POST' --fail-with-body \
+            "$url/api/0/buckets/aw-test/heartbeat?pulsetime=60" \
+            -H 'accept: application/json' \
+            -H 'Content-Type: application/json' \
+            -d '{
+            "timestamp": "'$timestamp'",
+            "duration": 0,
+            "data": {"key": "test value"}
+          }'
+
+          # Give a sec, then kill server process
+          sleep 1
+          kill $!
+
+      - name: Output logs
+        if: always()
+        run: |
+          cat log-old.txt || true
+          echo "\n---\n"
+          cat log-new.txt || true
+

.github/workflows/winget.yml

@@ -0,0 +1,13 @@
+name: Publish to WinGet
+on:
+  release:
+    types: [released]
+jobs:
+  publish:
+    runs-on: windows-latest # action can only be run on windows
+    steps:
+      - uses: vedantmgoyal2009/winget-releaser@4ffc7888bffd451b357355dc214d43bb9f23917e # v2
+        with:
+          identifier: ActivityWatch.ActivityWatch
+          token: ${{ secrets.GH_TOKEN_WINGET_AUTOUPDATE }}
+          fork-user: ActivityWatchBot