refactor!: rework repository structure (#129)

* refactor!:move to overlays scheme

add helper scripts

add soundcard autoconfigure

* docses

.github/workflows/build_img_ca_gui.yml → .github/workflows/build_audio_base.yml

@@ -1,13 +1,14 @@
-name: build catalan GUI image
+name: build base audio image
 
 on:
   workflow_dispatch:
   push:
     branches:
       - master
     paths:
-      - '.github/workflows/build_img_ca_gui.yml'
-      - 'build_raspOVOS_gui.sh'
+      - '.github/workflows/build_audio_base.yml'
+      - 'build_audio_base.sh'
+      - 'overlays/base/**'
 
 jobs:
   # Stage 1: Get Current Date and Release Name
@@ -21,7 +22,7 @@ jobs:
         id: current-date
         run: |
           current_date=$(date +'%Y-%m-%d')
-          release_name="raspOVOS-catalan-GUI-bookworm-arm64-lite-${current_date}"
+          release_name="raspOVOS-audio-base-bookworm-arm64-lite-${current_date}"
           cache_key="raspOVOS-${{ github.run_id }}"
           echo "release_name=$release_name" >> $GITHUB_OUTPUT
           echo "cache_key=$cache_key" >> $GITHUB_OUTPUT
@@ -42,24 +43,23 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Installing OVOS Shell via EGLFS on top of Catalan OVOS
+      - name: Add OVOS to Raspberry Pi OS Bookworm
         uses: TigreGotico/rpi-image-modifier@main
         id: create-image
         env:
           USER: 'ovos'
           PASSWORD: 'ovos'
           HOSTNAME: "raspOVOS"
           CONSTRAINTS: "https://github.com/OpenVoiceOS/ovos-releases/raw/refs/heads/main/constraints-alpha.txt"
-          MYCROFT_CONFIG_FILES: "mycroft.conf,mycroft_gui.conf,mycroft_ca.conf"
         with:
-          base-image-url: https://github.com/TigreGotico/raspOVOS/releases/download/raspOVOS-catalan-bookworm-arm64-lite-2024-12-05/raspOVOS-catalan-bookworm-arm64-lite.img.xz
-          image-path: raspOVOS-catalan-GUI-bookworm-arm64-lite.img
+          base-image-url: https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2024-11-19/2024-11-19-raspios-bookworm-arm64-lite.img.xz
+          image-path: raspOVOS-audio-base-bookworm-arm64-lite.img
           compress-with-xz: true
           shrink: true
           cache: false
           mount-repository: true
-          env-vars: USER,PASSWORD,HOSTNAME,CONSTRAINTS,MYCROFT_CONFIG_FILES
-          script-path: build_raspOVOS_gui.sh
+          env-vars: USER,PASSWORD,HOSTNAME,CONSTRAINTS
+          script-path: build_audio_base.sh
       - name: Print outputs
         shell: bash
         run: |
@@ -90,7 +90,7 @@ jobs:
           if [[ "$release_id" == "null" ]]; then
             release=$(curl -s -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
               -H "Content-Type: application/json" \
-              -d "{\"tag_name\":\"$release_name\",\"name\":\"$release_name\",\"body\":\"RaspOVOS and ovos-shell via EGLFS pre-configured for Catalan\"}" \
+              -d "{\"tag_name\":\"$release_name\",\"name\":\"$release_name\",\"body\":\"FOR DEVELOPERS: Base OS + audio/media packages.\"}" \
               "https://api.github.com/repos/${{ github.repository }}/releases")
             release_id=$(echo $release | jq -r .id)
           fi
@@ -104,11 +104,12 @@ jobs:
             echo "Failed to create release. Response: $release"
             exit 1
           fi
+
   # Stage 4: Upload to Release
   upload-image:
     runs-on: ubuntu-latest
-    needs: [ modify-rpi-image, check-release-or-create, get-date-release-name ]
     if: ${{ needs.check-release-or-create.outputs.release_id }}
+    needs: [ modify-rpi-image, check-release-or-create, get-date-release-name ]
     steps:
       - name: Restore Cache for Image
         uses: actions/cache@v4