UIX Desktop 0.4.0

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,90 @@
+name: Bug report
+description: Something in Theseus or UIX Desktop doesn't work the way it should.
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting. One bug per issue, please. Theseus never ships Xbox system files or game files, so please don't attach any.
+  - type: dropdown
+    id: os
+    attributes:
+      label: Where are you running it?
+      options:
+        - macOS
+        - Windows
+        - Linux
+        - Steam Deck
+        - Xbox (real hardware)
+        - Xbox (xemu)
+    validations:
+      required: true
+  - type: input
+    id: os-version
+    attributes:
+      label: OS version and GPU
+      description: For example "macOS 15.4, M2" or "Fedora 41, RX 6700 XT". The GPU matters most for display problems.
+  - type: input
+    id: version
+    attributes:
+      label: Theseus version
+      description: Help > About UIX Desktop shows it. The download's file name carries it too.
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Crash
+        - Games grid and launching
+        - Media (library, Plex, Jellyfin, playback)
+        - Music, sound or visualizer
+        - Xbox Cloud Gaming and remote play
+        - Skins, XAP scenes or XIPs
+        - Display or performance
+        - Controls
+        - Xbox dashboard
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: What you saw. Screenshots help for anything visual.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Open the Games grid
+        2. Pick a Steam game
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and crash reports
+      description: |
+        Drag `theseus.log` here from your user data folder. If it crashed, add the newest file from the `crashes` folder inside it, and `theseus.prev.log` if you've started Theseus again since.
+
+        - macOS: `~/Library/Application Support/Theseus`
+        - Linux and Steam Deck: `$XDG_DATA_HOME/theseus`, or `~/.local/share/theseus` when that isn't set
+        - Windows: `%APPDATA%\Theseus` (started from a terminal, the log goes to that terminal instead)
+
+        Please don't attach or paste `Configs/desktop.ini`. It holds your Plex, Jellyfin and Xbox sign in tokens.
+  - type: textarea
+    id: extra
+    attributes:
+      label: Anything else
+      description: Which download you used (app, AppImage, zip, built from source), controllers, skins, or anything that seems related.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Help and questions
+    url: https://discord.gg/qfVHTYD4xX
+    about: Setup questions and general chat go to the TeamUIX Discord.

.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,52 @@
+name: Feature request
+description: An idea for something Theseus doesn't do yet.
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the idea. Anything new has to fit the dashboard's look and render through the 3D scene, so describe the problem first and the solution second.
+  - type: dropdown
+    id: build
+    attributes:
+      label: Which build is it for?
+      options:
+        - UIX Desktop (macOS, Windows, Linux)
+        - Xbox dashboard
+        - Both
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Games grid and launching
+        - Media (library, Plex, Jellyfin, playback)
+        - Music, sound or visualizer
+        - Xbox Cloud Gaming and remote play
+        - Skins, XAP scenes or XIPs
+        - Controls
+        - Documentation
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What are you trying to do?
+      description: The problem or the missing piece, in your own words.
+    validations:
+      required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would you like to see?
+      description: How it would work from where you sit. Mockups and screenshots welcome.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Anything you've tried instead
+      description: Workarounds, other apps that do it well, or the original dashboard's behavior if it's relevant.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## What this changes
+
+<!-- A few plain sentences: what was wrong or missing, and what you did about it. Link the issue if there is one (Fixes #123). -->
+
+## How you tested it
+
+<!-- Which builds you ran and what you checked. Say so if something couldn't be tested here. -->
+
+- [ ] macOS
+- [ ] Linux or Steam Deck
+- [ ] Windows
+- [ ] Xbox (real hardware or xemu)
+
+## Checklist
+
+- [ ] `make lint-platform` is clean
+- [ ] No scriptable node, FND/PRD table, node name or material name was renamed or removed (scenes and skins rely on them; add alongside instead)
+- [ ] Screenshots attached for anything that changes how it looks
+- [ ] I'm fine with this being released under GPL-3.0-or-later

.github/workflows/build.yml

@@ -18,6 +18,13 @@ concurrency:
 # when authoring new shaders (offline by the contributor).
 
 jobs:
+  lint:
+    name: Lint / platform flags
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: make -C build lint-platform
+
   desktop-macos:
     name: Desktop / macOS
     runs-on: macos-latest

.github/workflows/release.yml

@@ -244,6 +244,22 @@ jobs:
           tar czf "${DROP}.tar.gz" "${DROP}"
           echo "ARCHIVE=${DROP}.tar.gz" >> "$GITHUB_ENV"
 
+      - name: Package AppImage
+        # The bare binary needs the runner's exact FFmpeg sonames, which
+        # newer distros like Debian trixie don't have. The AppImage carries them.
+        run: |
+          TAG="${{ github.event.inputs.tag || github.ref_name }}"
+          sudo apt-get install -y -qq patchelf wget file
+          chmod +x build/mk-appimage.sh
+          ./build/mk-appimage.sh ~/builds/theseus/desktop "UIX-Desktop-${TAG}-aarch64.AppImage"
+          echo "APPIMAGE=UIX-Desktop-${TAG}-aarch64.AppImage" >> "$GITHUB_ENV"
+
+      - name: Upload AppImage to release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.inputs.tag || github.ref_name }}
+          files: ${{ env.APPIMAGE }}
+
       - name: Upload to release
         uses: softprops/action-gh-release@v2
         with:

.gitignore

@@ -12,6 +12,8 @@
 *.wrn
 *.ilk
 *.idb
+# -MMD writes these beside the compiler's cwd when a build is driven by hand.
+*.d
 Debug/
 Release/
 Profile/
@@ -68,3 +70,6 @@ theseus/third-party/bgfx/.build/
 # xiptool writes <folder>.xip next to the source folder on create. The packed
 # artifact belongs in Data/Xips/, not here.
 xips-source/*.xip
+
+# Machine-local build settings (paths to retail XBEs)
+build/local.mk

Configs/version

@@ -1,2 +1,2 @@
 [default]
-version=0.5.250605
+version=0.4.0