Add timestamp metadata / action

.github/scripts/update_manifests.py

@@ -0,0 +1,114 @@
+import subprocess
+import os
+import yaml
+import glob
+
+def get_git_dates(path):
+    # Get all commit dates for the path
+    try:
+        # Define patterns for commits to ignore (automated metadata updates)
+        ignore_patterns = [
+            "Add timestamp metadata",
+            "Implement sorting by newest",
+            "Merge updated-apps",
+            "Fix YAML formatting",
+            "Update manifest metadata",
+            "Merge branch",
+            "Tag consolidation",
+            "llm generated categories",
+            "Fix Updates and script",
+            "Fix updated timestamps",
+            "Implement sorting by newest and last updated in app viewer"
+        ]
+        ignore_regex = "|".join(ignore_patterns)
+
+        # Use TZ=UTC to get dates in UTC format.
+        env = os.environ.copy()
+        env["TZ"] = "UTC"
+
+        # Get published (oldest)
+        cmd_pub = ["git", "log", "--reverse", "--date=iso-strict-local", "--format=%ad", "--", path]
+        output_pub = subprocess.check_output(cmd_pub, env=env).decode("utf-8").strip()
+        if not output_pub:
+            return None, None
+        published = output_pub.splitlines()[0]
+
+        # Get updated (newest, excluding automated commits)
+        cmd_upd = [
+            "git", "log", "-1", "--date=iso-strict-local", "--format=%ad",
+            "--invert-grep", f"--grep={ignore_regex}", "--extended-regexp",
+            "--", path
+        ]
+        output_upd = subprocess.check_output(cmd_upd, env=env).decode("utf-8").strip()
+
+        # If no "real" update found, use published date
+        updated = output_upd if output_upd else published
+
+        return published, updated
+    except Exception as e:
+        print(f"Error getting dates for {path}: {e}")
+        return None, None
+
+def update_manifest(manifest_path):
+    # Get the directory of the app
+    app_dir = os.path.dirname(manifest_path)
+
+    published, updated = get_git_dates(app_dir)
+    if not published:
+        print(f"Skipping {manifest_path} (no git history)")
+        return
+
+    # Check if we need to update
+    with open(manifest_path, 'r') as f:
+        try:
+            data = yaml.safe_load(f)
+        except Exception as e:
+            print(f"Error parsing YAML in {manifest_path}: {e}")
+            return
+
+    if data is None:
+        data = {}
+
+    changed = False
+    # Only set published if it's missing. This preserves historical dates
+    # even when running in a shallow clone.
+    if not data.get('published'):
+        data['published'] = published
+        changed = True
+
+    # Always update the 'updated' date to the latest commit
+    if data.get('updated') != updated:
+        data['updated'] = updated
+        changed = True
+
+    if data.get('tags') is None:
+        data['tags'] = []
+
+    if changed:
+        print(f"Updating {manifest_path}: published={published}, updated={updated}")
+        with open(manifest_path, 'w', encoding='utf-8') as f:
+            yaml.dump(data, f, sort_keys=False, default_flow_style=False, explicit_start=True, allow_unicode=True, width=1000)
+
+import sys
+
+def main():
+    if len(sys.argv) > 1:
+        # Use provided arguments (files or directories)
+        manifests = []
+        for arg in sys.argv[1:]:
+            if arg.endswith("manifest.yaml"):
+                manifests.append(arg)
+            elif os.path.isdir(arg):
+                m = os.path.join(arg, "manifest.yaml")
+                if os.path.exists(m):
+                    manifests.append(m)
+    else:
+        # Scan all apps
+        manifests = glob.glob("apps/*/manifest.yaml")
+
+    print(f"Checking {len(manifests)} manifests.")
+    for m in manifests:
+        update_manifest(m)
+
+if __name__ == "__main__":
+    main()

.github/workflows/update-metadata.yml

@@ -0,0 +1,60 @@
+name: Update App Metadata
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'apps/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  update-metadata:
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'tronbyt' # Avoid running on forks by default
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Full history needed for git log analysis
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: pip install PyYAML
+
+      - name: Update manifest metadata
+        id: update
+        run: |
+          # Determine modified apps
+          if [[ "${{ github.event_before }}" == "0000000000000000000000000000000000000000" ]]; then
+            echo "Initial push or new branch, checking all apps..."
+            python3 .github/scripts/update_manifests.py
+          else
+            echo "Performing incremental update for push..."
+            TARGETS=$(git diff --name-only ${{ github.event.before }} ${{ github.sha }} | grep '^apps/' | cut -d'/' -f1-2 | sort -u || true)
+            if [ -n "$TARGETS" ]; then
+              python3 .github/scripts/update_manifests.py $TARGETS
+            else
+              echo "No apps modified in this push."
+            fi
+          fi
+
+      - name: Commit and push changes
+        run: |
+          if [[ -n $(git status --porcelain) ]]; then
+            echo "Detected changes in app manifests. Committing updates..."
+            git config --global user.name "github-actions[bot]"
+            git config --global user.email "github-actions[bot]@users.noreply.github.com"
+            git add apps/*/manifest.yaml
+            git commit -m "chore: auto-update manifest metadata [skip ci]"
+            git push
+          else
+            echo "No metadata updates required."
+          fi

apps/3cellularautomata/manifest.yaml

@@ -10,8 +10,10 @@ recommendedInterval: 5
 supports2x: true
 category: entertainment
 tags:
-  - art
-  - science
-  - gaming
-  - retro
-  - wide 2x support
+- art
+- science
+- gaming
+- retro
+- wide 2x support
+published: '2023-03-23T12:36:07Z'
+updated: '2025-12-23T12:55:56Z'

apps/GitHubContributions/manifest.yaml

@@ -10,7 +10,9 @@ recommendedInterval: 60
 supports2x: true
 category: utilities
 tags:
-  - tech
-  - productivity
-  - dev-tools
-  - wide 2x support
+- tech
+- productivity
+- dev-tools
+- wide 2x support
+published: '2026-01-10T08:59:05Z'
+updated: '2026-05-01T01:08:29Z'

apps/M365Status/manifest.yaml

@@ -6,5 +6,7 @@ desc: Simple app that looks at the Microsoft Admin Center Status RSS feed and sh
 author: M0ntyP
 category: utilities
 tags:
-  - utility
-  - admin
+- utility
+- admin
+published: '2026-01-23T22:34:33Z'
+updated: '2026-01-23T22:34:33Z'

apps/OctoWatts/manifest.yaml

@@ -9,6 +9,8 @@ fileName: octowatts.star
 packageName: OctoWatts
 category: utilities
 tags:
-  - utility
-  - smart-home
-  - tech
+- utility
+- smart-home
+- tech
+published: '2024-10-23T14:05:48Z'
+updated: '2025-12-28T23:11:23Z'

apps/aadailyreflect/manifest.yaml

@@ -9,5 +9,7 @@ packageName: aadailyreflect
 recommendedInterval: 5
 category: lifestyle
 tags:
-  - lifestyle
-  - daily-reflection
+- lifestyle
+- daily-reflection
+published: '2022-11-18T22:27:20Z'
+updated: '2025-12-02T19:30:22Z'

apps/abcnews/manifest.yaml

@@ -4,3 +4,6 @@ name: ABC News
 summary: Displays ABC News Headlines
 desc: Displays headlines from ABC News Australia. Select the topic from the dropdown and it will display the last 5 headlines.
 author: M0ntyP
+published: '2026-05-05T16:01:26Z'
+updated: '2026-05-05T16:01:26Z'
+tags: []

apps/abcradio/manifest.yaml

@@ -9,6 +9,8 @@ packageName: abcradio
 recommendedInterval: 10
 category: entertainment
 tags:
-  - music
-  - real-time
-  - local
+- music
+- real-time
+- local
+published: '2024-02-01T22:50:22Z'
+updated: '2025-11-30T19:58:27Z'

apps/abstractclock/manifest.yaml

@@ -9,6 +9,8 @@ packageName: abstractclock
 recommendedInterval: 0
 category: clocks
 tags:
-  - time
-  - digital-clock
-  - art
+- time
+- digital-clock
+- art
+published: '2022-04-04T15:46:29Z'
+updated: '2025-11-30T19:58:27Z'

apps/accidentfreedays/manifest.yaml

@@ -9,6 +9,8 @@ packageName: accidentfreedays
 recommendedInterval: 240
 category: utilities
 tags:
-  - lifestyle
-  - utility
-  - tracking
+- lifestyle
+- utility
+- tracking
+published: '2023-08-12T12:20:03Z'
+updated: '2025-11-30T19:58:27Z'

apps/accuweather/manifest.yaml

@@ -9,5 +9,7 @@ packageName: accuweather
 recommendedInterval: 5
 category: weather
 tags:
-  - weather
-  - local
+- weather
+- local
+published: '2023-10-16T21:35:00Z'
+updated: '2025-12-02T19:30:22Z'

apps/acfilmshowtimes/manifest.yaml

@@ -9,5 +9,7 @@ packageName: acfilmshowtimes
 recommendedInterval: 5
 category: entertainment
 tags:
-  - media
-  - theaters
+- media
+- theaters
+published: '2023-03-14T18:48:18Z'
+updated: '2026-05-01T16:28:33Z'

apps/acidwarp/manifest.yaml

@@ -7,5 +7,7 @@ author: tavdog
 recommendedInterval: 5
 category: entertainment
 tags:
-  - retro
-  - art
+- retro
+- art
+published: '2025-02-03T23:05:56Z'
+updated: '2025-12-02T19:30:22Z'

apps/acnhvillager/manifest.yaml

@@ -9,4 +9,6 @@ packageName: acnhvillager
 recommendedInterval: 5
 category: entertainment
 tags:
-  - gaming
+- gaming
+published: '2023-02-21T18:22:33Z'
+updated: '2025-12-02T19:30:22Z'

apps/actransit/manifest.yaml

@@ -9,4 +9,6 @@ packageName: actransit
 recommendedInterval: 5
 category: transit
 tags:
-  - real-time
+- real-time
+published: '2023-03-02T17:17:36Z'
+updated: '2025-12-23T13:24:18Z'

apps/adafruitio/manifest.yaml

@@ -8,6 +8,8 @@ fileName: adafruitio.star
 packageName: adafruitio
 category: utilities
 tags:
-  - tech
-  - smart-home
-  - utility
+- tech
+- smart-home
+- utility
+published: '2023-11-01T18:27:25Z'
+updated: '2025-11-30T19:58:27Z'

apps/adelaidemetro/manifest.yaml

@@ -8,4 +8,6 @@ fileName: adelaide_metro.star
 packageName: adelaidemetro
 recommendedInterval: 5
 category: transit
-tags:
+tags: []
+published: '2023-02-03T20:58:19Z'
+updated: '2025-12-02T19:30:22Z'

apps/advice/manifest.yaml

@@ -9,5 +9,7 @@ packageName: advice
 recommendedInterval: 5
 category: entertainment
 tags:
-  - motivational
-  - media
+- motivational
+- media
+published: '2022-09-15T19:22:14Z'
+updated: '2025-12-05T22:28:51Z'

apps/afl/manifest.yaml

@@ -9,5 +9,7 @@ packageName: afl
 recommendedInterval: 5
 category: sports
 tags:
-  - afl
-  - football
+- afl
+- football
+published: '2022-06-09T16:52:13Z'
+updated: '2025-11-30T20:08:55Z'

apps/aflladder/manifest.yaml

@@ -9,6 +9,8 @@ packageName: aflladder
 recommendedInterval: 5
 category: sports
 tags:
-  - real-time
-  - afl
-  - football
+- real-time
+- afl
+- football
+published: '2023-03-23T12:25:31Z'
+updated: '2026-01-14T23:37:56Z'

apps/aflscores/manifest.yaml

@@ -9,5 +9,7 @@ packageName: aflscores
 recommendedInterval: 5
 category: sports
 tags:
-  - afl
-  - football
+- afl
+- football
+published: '2023-03-23T12:24:44Z'
+updated: '2026-04-21T20:43:23Z'