Recording improvements (more options + better audio control)

.envrc

@@ -3,10 +3,11 @@ if has nix; then
 fi
 
 shopt -s globstar
-watch_file assets/cpp/**/*.cpp
-watch_file assets/cpp/**/*.hpp
 watch_file plugin/**/*.cpp
 watch_file plugin/**/*.hpp
+watch_file plugin/**/*.qml
+watch_file plugin/**/*.vert
+watch_file plugin/**/*.frag
 watch_file **/CMakeLists.txt
 
 cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_CXX_COMPILER=clazy -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DDISTRIBUTOR=direnv

.github/ISSUE_TEMPLATE/crash.yml

@@ -0,0 +1,57 @@
+name: Crash report
+description: Report a crash
+labels: ["bug", "crash"]
+type: "Bug"
+title: "[CRASH] "
+body:
+  - type: textarea
+    attributes:
+      label: What caused the crash
+      description: |
+        Any information likely to help debug the crash. What were you doing when the crash occurred,
+        what changes did you make, can you get it to happen again?
+
+  - type: upload
+    attributes:
+      label: Report file
+      description: Attach `report.txt` here.
+    validations:
+      required: true
+
+  - type: upload
+    attributes:
+      label: Log file
+      description: |
+        Attach `log.qslog.log` here. If it is too big to upload, compress it.
+
+        You can preview the log if you'd like using `qs log <path-to-log> -r '*=true'`.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Version info"
+      description: Run `caelestia -v` and paste the result below.
+      value: |
+        <details><summary>Version info</summary>
+
+        ```
+        <!-- Run `caelestia -v` and paste the result here! -->
+        ```
+
+        </details>
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Reminder
+      options:
+        - label: I've successfully updated to the latest versions following the [updating guide](https://github.com/caelestia-dots/caelestia?tab=readme-ov-file#updating).
+          required: false
+        - label: I've successfully updated the system packages to the latest.
+          required: false
+        - label: I agree that it's usually impossible for others to help me without my logs.
+          required: true
+        - label: I've ticked the checkboxes without reading their contents
+          required: false

.github/workflows/check-format.yml

@@ -0,0 +1,38 @@
+name: Check formatting
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  check-qml:
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/${{ github.repository_owner }}/shell-arch-env:latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check QML format
+        shell: fish {0}
+        run: |
+          for file in (string match -v 'build/*' **.qml)
+            /usr/lib/qt6/bin/qmlformat $file | diff -u $file - || exit 1
+          end
+          python3 scripts/qml-lint-conventions.py
+
+  check-cpp:
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/${{ github.repository_owner }}/shell-arch-env:latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check C++ format
+        shell: fish {0}
+        run: |
+          find plugin extras -name '*.cpp' -o -name '*.hpp' \
+            | xargs clang-format --dry-run --Werror

.github/workflows/lint.yml

@@ -0,0 +1,43 @@
+name: Lint code
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    container:
+      image: ghcr.io/${{ github.repository_owner }}/shell-arch-env:latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Build
+        run: |
+          # Set version and git rev for CI build so we don't call git
+          cmake -B build -G Ninja -DCMAKE_CXX_COMPILER=clazy -DCMAKE_CXX_FLAGS=-Werror -DVERSION= -DGIT_REVISION=
+          cmake --build build
+
+      - name: Lint QML
+        shell: fish {0}
+        run: |
+          # Generate tooling
+          touch .qmlls.ini
+          QT_QPA_PLATFORM=offscreen QML2_IMPORT_PATH="$PWD/build/qml:$QML2_IMPORT_PATH" timeout 2 qs -p .
+
+          # Construct linter args
+          set -l build_dir (grep -oP "(?<=buildDir=\")(.*)(?=\")" .qmlls.ini)
+          set -l import_paths (grep -oP "(?<=importPaths=\")(.*)(?=\")" .qmlls.ini | string split :)
+          set -l args -I $build_dir
+          for path in $import_paths
+            set -a args -I $path
+          end
+          set -l qml_files (string match -vr '(build|modules/controlcenter)/.*' **.qml)
+
+          # Lint
+          set -l lint_out (/usr/lib/qt6/bin/qmllint --import disable $args $qml_files 2>&1 | tee /dev/stderr)
+          test -z "$lint_out" || exit 1

.github/workflows/release.yml

@@ -3,7 +3,7 @@ name: Create release
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
 
 jobs:
   build-and-release:
@@ -13,7 +13,7 @@ jobs:
       contents: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Create packages
         run: |
@@ -35,3 +35,8 @@ jobs:
             caelestia-shell-${{ github.ref_name }}.tar.gz
             caelestia-shell-latest.tar.gz
           generate_release_notes: true
+
+      - name: Update stable branch
+        run: |
+          git branch -f stable "$GITHUB_SHA"
+          git push origin stable --force

.github/workflows/update-flake-inputs.yml

@@ -3,27 +3,33 @@ name: Update flake inputs
 on:
   workflow_dispatch:
   schedule:
-    - cron: '0 0 * * 0'
+    - cron: "0 0 * * 0"
 
 jobs:
   update-flake:
     runs-on: ubuntu-latest
 
-    permissions:
-      contents: write
-
     steps:
-      - uses: actions/checkout@v4
+      - name: Generate app token
+        id: app-token
+        uses: actions/create-github-app-token@v3
+        with:
+          client-id: ${{ secrets.CLIENT_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Install Nix
-        uses: nixbuild/nix-quick-install-action@v31
+        uses: nixbuild/nix-quick-install-action@v34
         with:
           nix_conf: |
             keep-env-derivations = true
             keep-outputs = true
 
       - name: Restore and save Nix store
-        uses: nix-community/cache-nix-action@v6
+        uses: nix-community/cache-nix-action@v7
         with:
           # restore and save a cache using this key
           primary-key: nix-${{ hashFiles('**/*.nix', '**/flake.lock') }}
@@ -78,8 +84,9 @@ jobs:
 
       - name: Commit and push changes
         if: steps.check.outputs.modified == 'true'
-        uses: EndBug/add-and-commit@v9
+        uses: EndBug/add-and-commit@v10
         with:
+          github_token: ${{ steps.app-token.outputs.token }}
           add: flake.lock
           default_author: github_actions
           message: "[CI] chore: update flake"

.github/workflows/update-image.yml

@@ -0,0 +1,46 @@
+name: Update Docker CI image
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 0 * * 0"
+
+permissions:
+  packages: write
+
+jobs:
+  build-image:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Write Dockerfile
+        run: |
+          cat > /tmp/Dockerfile <<EOF
+          FROM archlinux:latest
+          RUN pacman -Syu --needed --noconfirm sudo base-devel cmake ninja fish git clazy qt6-declarative qt6-shadertools python libpipewire aubio libqalculate && \
+              useradd -m builder && \
+              echo 'builder ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers && \
+              sudo -u builder git clone https://aur.archlinux.org/yay-bin.git /home/builder/yay-bin && \
+              cd /home/builder/yay-bin && \
+              sudo -u builder makepkg -si --noconfirm && \
+              sudo -u builder yay -S --noconfirm quickshell-git libcava && \
+              sudo -u builder yay -Yc --noconfirm && \
+              pacman -Rns --noconfirm yay-bin && \
+              sed -i '/builder ALL=(ALL) NOPASSWD:ALL/d' /etc/sudoers && \
+              userdel -r builder && \
+              pacman -Scc --noconfirm
+          EOF
+
+      - name: Build and push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          file: /tmp/Dockerfile
+          push: true
+          tags: ghcr.io/${{ github.repository_owner }}/shell-arch-env:latest

.gitignore

@@ -3,3 +3,4 @@
 /.qmlls.ini
 build/
 .cache/
+logs

CMakeLists.txt

@@ -60,8 +60,14 @@ if("plugin" IN_LIST ENABLE_MODULES)
 endif()
 
 if("shell" IN_LIST ENABLE_MODULES)
-    foreach(dir assets components config modules services utils)
+    foreach(dir assets components modules services utils)
         install(DIRECTORY ${dir} DESTINATION "${INSTALL_QSCONFDIR}")
     endforeach()
-    install(FILES shell.qml LICENSE DESTINATION "${INSTALL_QSCONFDIR}")
+
+    file(READ shell.qml SHELL_QML)
+    string(REPLACE "settings.watchFiles: true" "settings.watchFiles: false" SHELL_QML "${SHELL_QML}")
+    file(WRITE "${CMAKE_BINARY_DIR}/qml/shell.qml" "${SHELL_QML}")
+    install(FILES "${CMAKE_BINARY_DIR}/qml/shell.qml" DESTINATION "${INSTALL_QSCONFDIR}")
+
+    install(FILES LICENSE DESTINATION "${INSTALL_QSCONFDIR}")
 endif()