Figlet alternative / native header in shell

.editorconfig

@@ -0,0 +1,16 @@
+; editorconfig.org
+root = true
+
+[*]
+charset                     = utf-8
+continuation_indent_size    = 2
+end_of_line                 = lf
+indent_size                 = 2
+indent_style                = space
+insert_final_newline        = true
+max_line_length             = 120
+tab_width                   = 2
+; trim_trailing_whitespace    = true ; disabled until files are cleaned up
+
+[*.md]
+trim_trailing_whitespace    = false

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -5,44 +5,64 @@ body:
   - type: markdown
     attributes:
       value: |
-        **IMPORTANT:** Failure to comply with the following guidelines may result in immediate closure.
-        - Prior to submitting, kindly search the closed issues to check if the problem you are reporting has already been addressed and resolved. If you come across a closed issue that pertains to your problem, please leave a comment on that issue instead of creating a new one.
-        - If the default Linux distribution is not adhered to, script support will be discontinued.
-        - When encountering the error message `[ERROR] in line 23: exit code *: while executing command "$@" > /dev/null 2>&1`, make sure to run the script in verbose mode to accurately determine the underlying issue.
-        - For suggestions, questions, or feature/script requests, please use the [Discussions section.](https://github.com/community-scripts/ProxmoxVE/discussions)
+        # 🐞 **Script Issue Report**
+        Thank you for taking the time to report an issue! Please provide as much detail as possible to help us address the problem efficiently.  
+
+        ## ⚠️ **IMPORTANT**  
+        - 🔍 **Search first:** Before submitting, check if the issue has already been reported or resolved in [closed issues](https://github.com/community-scripts/ProxmoxVE/issues?q=is%3Aissue+is%3Aclosed). If found, comment on that issue instead of creating a new one.  
+        Alternatively, check the **[Discussions](https://github.com/community-scripts/ProxmoxVE/discussions)** under the *"Announcement"* or *"Guide"* categories for relevant information.  
+        - 🛠️ **Supported environments only:** Ensure you are using a default Linux distribution. Custom setups may not be supported.  
+        - 🔎 If you encounter `[ERROR] in line 23: exit code *: while executing command "$@" > /dev/null 2>&1`, rerun the script with verbose mode before submitting the issue.  
+        - 💡 For general questions, feature requests, or suggestions, use the [Discussions section](https://github.com/community-scripts/ProxmoxVE/discussions).  
 
   - type: input
     id: guidelines
     attributes:
-      label: Please verify that you have read and understood the guidelines.
+      label: ✅ Have you read and understood the above guidelines?
       placeholder: "yes"
     validations:
       required: true
 
+  - type: input
+    id: script_name
+    attributes:
+      label: 📜 What is the name of the script you are using?
+      placeholder: "e.g., NextcloudPi, Zigbee2MQTT"
+    validations:
+      required: true
+
+  - type: input
+    id: script_command
+    attributes:
+      label: 📂 What was the exact command used to execute the script?
+      placeholder: "e.g., bash -c \"$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/zigbee2mqtt.sh)\" or \"update\""
+    validations:
+      required: true
+
   - type: textarea
-    id: bug
+    id: issue_description
     attributes:
-      label: A clear and concise description of the issue.
+      label: 📝 Provide a clear and concise description of the issue.
     validations:
       required: true
-      
+
   - type: checkboxes
     validations:
       required: true
     attributes:
-      label: What settings are you currently utilizing?
+      label: ⚙️ What settings are you using?
       options:
         - label: Default Settings
         - label: Advanced Settings
 
   - type: markdown
     attributes:
-      value: "If using Advanced Settings, please try Default Settings before creating an issue."
+      value: "💡 **Tip:** If you are using Advanced Settings, please test with Default Settings before submitting an issue."
 
   - type: dropdown
-    id: distribution
+    id: linux_distribution
     attributes:
-      label: Which Linux distribution are you employing?
+      label: 🖥️ Which Linux distribution are you using?
       options:
         - 
         - Alpine
@@ -51,21 +71,30 @@ body:
         - Ubuntu 20.04
         - Ubuntu 22.04
         - Ubuntu 24.04
+        - Ubuntu 24.10
     validations:
       required: true
 
   - type: textarea
-    id: screenshot
+    id: steps_to_reproduce
     attributes:
-      label: If relevant, including screenshots or a code block can be helpful in clarifying the issue.
-      placeholder: "Code blocks begin and conclude by enclosing the code with three backticks (```) above and below it."
+      label: 🔄 Steps to reproduce the issue.
+      placeholder: "e.g., Step 1: ..., Step 2: ..."
     validations:
-      required: false
+      required: true
+
+  - type: textarea
+    id: error_output
+    attributes:
+      label: ❌ Paste the full error output (if available).
+      placeholder: "Include any relevant logs or error messages."
+    validations:
+      required: true
 
   - type: textarea
-    id: reproduce
+    id: additional_context
     attributes:
-      label: Please provide detailed steps to reproduce the issue.
-      placeholder: "First do this, then this ..."
+      label: 🖼️ Additional context (optional).
+      placeholder: "Include screenshots, code blocks (use triple backticks ```), or any other relevant information."
     validations:
       required: false

.github/pull_request_template.md

@@ -1,31 +1,39 @@
-> [!NOTE]
-> We are meticulous when it comes to merging code into the main branch, so please understand that we may reject pull requests that do not meet the project's standards. It's never personal. Also, game-related scripts have a lower chance of being merged.
+> **🛠️ Note:**  
+> We are meticulous about merging code into the main branch, so please understand that pull requests not meeting the project's standards may be rejected. It's never personal!  
+> 🎮 **Note for game-related scripts:** These have a lower likelihood of being merged.
 
-## Description
+---
 
+## ✍️ Description
 Provide a summary of the changes made and/or reference the issue being addressed.
 
-Fixes # (issue)
+ 
 
-## Type of change
-Please check the relevant option(s):
+- - -
+**_Please remove unneeded lines!_**
+- Related Issue: # (issue number, if applicable)  
+- Related PR: # (if applicable)  
+- Related Discussion: []()(if applicable)  
 
-- [ ] Bug fix (non-breaking change that resolves an issue)
-- [ ] New feature (non-breaking change that adds functionality)
-- [ ] Breaking change (a fix or feature that would cause existing functionality to change unexpectedly)
-- [ ] New script (a fully functional and thoroughly tested script or set of scripts.)
+---
 
-## Prerequisites
-The following efforts must be made for the PR to be considered. Please check when completed:
-- [ ] Self-review performed (I have reviewed my code, ensuring it follows established patterns and conventions)
-- [ ] Testing performed (I have tested my changes, ensuring everything works as expected)
-- [ ] Documentation updated (I have updated any relevant documentation)
+## 🛠️ Type of Change
+Please check the relevant options:  
+- [ ] Bug fix (non-breaking change that resolves an issue)  
+- [ ] New feature (non-breaking change that adds functionality)  
+- [ ] Breaking change (fix or feature that would cause existing functionality to change unexpectedly)  
+- [ ] New script (a fully functional and thoroughly tested script or set of scripts)  
+
+---
 
-## Additional Information (optional)
-Provide any additional context or screenshots about the feature or fix here.
+## ✅ Prerequisites
+The following steps must be completed for the pull request to be considered:  
+- [ ] Self-review performed (I have reviewed my code to ensure it follows established patterns and conventions.)  
+- [ ] Testing performed (I have thoroughly tested my changes and verified expected functionality.)  
+- [ ] Documentation updated (I have updated any relevant documentation)
 
+---
 
-## Related Pull Requests / Discussions
+## 📋 Additional Information (optional)
+Provide any extra context or screenshots about the feature or fix here.  
 
-If there are other pull requests or discussions related to this change, please link them here:
-- Related PR #

.github/workflows/changelog-pr.yml

@@ -63,6 +63,7 @@ jobs:
             const { data: pulls } = await github.rest.pulls.list({
               owner: context.repo.owner,
               repo: context.repo.repo,
+              base: "main",
               state: "closed",
               sort: "updated",
               direction: "desc",

.github/workflows/check-lowercase.yml

@@ -0,0 +1,92 @@
+name: Check Lowercase Filenames
+
+on:
+  pull_request:
+    paths:
+      - 'ct/*.sh'
+      - 'install/*.sh'
+      - 'json/*.json'
+
+jobs:
+  check_lowercase:
+    runs-on: ubuntu-latest
+
+    steps:
+      # Step 1: Checkout the code
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Ensure the full history is fetched for accurate diffing
+
+      # Step 2: Fetch the base branch
+      - name: Fetch base branch
+        run: git fetch origin ${{ github.base_ref }}
+
+      # Step 3a: Validate filenames in ct directory
+      - name: "Validate filenames in ct directory"
+        run: |
+          changed_files=$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '^ct/.*\.sh$')
+
+          ERROR_COUNT=0
+
+          for FILE in $changed_files; do
+              BASENAME=$(basename "$FILE")
+              if [[ "$BASENAME" =~ ^[a-z0-9._-]+$ ]]; then
+                  echo "$FILE: Check for lowercase in filename passed."
+              else
+                  echo "Error in $FILE. Change filename to lowercase."
+                  ERROR_COUNT=$((ERROR_COUNT + 1))
+              fi
+          done
+
+          if [ "$ERROR_COUNT" -ne 0 ]; then
+              exit 1
+          else
+              echo "All filenames in ct directory passed the lowercase check."
+          fi
+
+      # Step 3b: Validate filenames in install directory
+      - name: "Validate filenames in install directory"
+        run: |
+          changed_files=$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '^install/.*\.sh$')
+
+          ERROR_COUNT=0
+
+          for FILE in $changed_files; do
+              BASENAME=$(basename "$FILE")
+              if [[ "$BASENAME" =~ ^[a-z0-9._-]+$ ]]; then
+                  echo "$FILE: Check for lowercase in filename passed."
+              else
+                  echo "Error in $FILE. Change filename to lowercase."
+                  ERROR_COUNT=$((ERROR_COUNT + 1))
+              fi
+          done
+
+          if [ "$ERROR_COUNT" -ne 0 ]; then
+              exit 1
+          else
+              echo "All filenames in install directory passed the lowercase check."
+          fi
+
+      # Step 3c: Validate filenames in json directory
+      - name: "Validate filenames in json directory."
+        run: |
+          changed_files=$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '^json/.*\.json$')
+
+          ERROR_COUNT=0
+
+          for FILE in $changed_files; do
+              BASENAME=$(basename "$FILE")
+              if [[ "$BASENAME" =~ ^[a-z0-9._-]+$ ]]; then
+                  echo "$FILE: Check for lowercase in filename passed."
+              else
+                  echo "Error in $FILE. Change filename to lowercase."
+                  ERROR_COUNT=$((ERROR_COUNT + 1))
+              fi
+          done
+
+          if [ "$ERROR_COUNT" -ne 0 ]; then
+              exit 1
+          else
+              echo "All filenames in json directory passed the lowercase check."
+          fi

.github/workflows/check-metadata.yml

@@ -0,0 +1,55 @@
+name: Check Metadata
+on:
+  pull_request:
+    paths:
+      - '/ct/*.sh'
+      - '/install/*.sh'
+jobs:
+  check-metadata:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+      - name: Check Metadata Lines in Scripts
+        shell: bash
+        run: |
+          set -e
+          ERROR_COUNT=0
+          FILES=$(find . -name "*.sh")
+
+          for FILE in $FILES; do
+            if [[ "$(sed -n '3p' "$FILE")" == "# Copyright (c) 2021-2024 community-scripts ORG" ]]; then
+                echo "Check for Copyright metadata passed for line 3 in: $FILE"
+            else
+                echo "Error in $FILE: Copyright metadata missing or not on line 3"
+                ERROR_COUNT=$((ERROR_COUNT + 1))
+            fi
+
+            if sed -n '4p' "$FILE" | grep -qE "^# Author: .+"; then
+                echo "Check for Author metadata passed for line 4 in: $FILE"
+            else
+                echo "Error in $FILE: Author metadata missing or invalid on line 4"
+                ERROR_COUNT=$((ERROR_COUNT + 1))
+            fi
+
+            if [[ "$(sed -n '5p' "$FILE")" == "# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE" ]]; then
+                echo "Check for License metadata passed for line 5 in: $FILE"
+            else
+                echo "Error in $FILE: License metadata missing or not on line 5"
+                ERROR_COUNT=$((ERROR_COUNT + 1))
+            fi
+
+            if sed -n '6p' "$FILE" | grep -qE "^# Source: .+"; then
+                echo "Check for Source metadata passed for line 6 in: $FILE"
+            else
+                echo "Error in $FILE: Source metadata missing or invalid on line 6"
+                ERROR_COUNT=$((ERROR_COUNT + 1))
+            fi
+          done
+
+          if [[ "$ERROR_COUNT" -gt 0 ]]; then
+              echo "$ERROR_COUNT script(s) failed validation."
+              exit 1
+          else
+              echo "All scripts passed."
+          fi