Update helpers_cache.json

Added a beta program section with installation instructions and feedback guidelines.

.github/scripts/generate_helpers_cache.py

@@ -3,26 +3,28 @@ import json
 import re
 import sys
 from pathlib import Path
+from typing import Any
 
 import requests
 
-# ---------- Config ----------
-API_URL = "https://api.github.com/repos/community-scripts/ProxmoxVE/contents/frontend/public/json"
 SCRIPT_BASE = "https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main"
+POCKETBASE_BASE = "https://db.community-scripts.org/api/collections"
+SCRIPT_COLLECTION_URL = f"{POCKETBASE_BASE}/script_scripts/records"
+CATEGORY_COLLECTION_URL = f"{POCKETBASE_BASE}/script_categories/records"
 
-# Escribimos siempre en <raiz_repo>/json/helpers_cache.json, independientemente del cwd
 REPO_ROOT = Path(__file__).resolve().parents[2]
 OUTPUT_FILE = REPO_ROOT / "json" / "helpers_cache.json"
 OUTPUT_FILE.parent.mkdir(parents=True, exist_ok=True)
-# ----------------------------
+
+TYPE_TO_PATH_PREFIX = {
+    "lxc": "ct",
+    "vm": "vm",
+    "addon": "tools/addon",
+    "pve": "tools/pve",
+}
 
 
 def to_mirror_url(raw_url: str) -> str:
-    """
-    Convierte una URL raw de GitHub al raw del mirror.
-    GH : https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/docker.sh
-    MIR: https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/main/ct/docker.sh
-    """
     m = re.match(r"^https://raw\.githubusercontent\.com/([^/]+)/([^/]+)/([^/]+)/(.+)$", raw_url or "")
     if not m:
         return ""
@@ -32,143 +34,202 @@ def to_mirror_url(raw_url: str) -> str:
     return f"https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/{branch}/{path}"
 
 
-def guess_os_from_script_path(script_path: str) -> str | None:
-    """
-    Heurística suave cuando el JSON no publica resources.os:
-      - tools/pve/*   -> proxmox
-      - ct/alpine-*   -> alpine
-      - tools/addon/* -> generic (suele ejecutarse sobre LXC existente)
-      - ct/*          -> debian (por defecto para CTs)
-    """
-    if not script_path:
-        return None
-    if script_path.startswith("tools/pve/") or script_path == "tools/pve/host-backup.sh" or script_path.startswith("vm/"):
-        return "proxmox"
-    if "/alpine-" in script_path or script_path.startswith("ct/alpine-"):
-        return "alpine"
-    if script_path.startswith("tools/addon/"):
-        return "generic"
-    if script_path.startswith("ct/"):
-        return "debian"
-    return None
-
-
-def fetch_directory_json(api_url: str) -> list[dict]:
-    r = requests.get(api_url, timeout=30)
+def fetch_json(url: str, *, params: dict[str, Any] | None = None) -> dict[str, Any]:
+    r = requests.get(url, params=params, timeout=60)
     r.raise_for_status()
     data = r.json()
-    if not isinstance(data, list):
-        raise RuntimeError("GitHub API no devolvió una lista.")
+    if not isinstance(data, dict):
+        raise RuntimeError(f"Unexpected response from {url}: expected object")
     return data
 
 
+def fetch_all_records(url: str, *, expand: str | None = None, per_page: int = 500) -> list[dict[str, Any]]:
+    page = 1
+    items: list[dict[str, Any]] = []
+
+    while True:
+        params: dict[str, Any] = {"page": page, "perPage": per_page}
+        if expand:
+            params["expand"] = expand
+
+        data = fetch_json(url, params=params)
+        page_items = data.get("items", [])
+        if not isinstance(page_items, list):
+            raise RuntimeError(f"Unexpected items list from {url}")
+
+        items.extend(page_items)
+
+        total_pages = data.get("totalPages", page)
+        if not isinstance(total_pages, int) or page >= total_pages:
+            break
+        page += 1
+
+    return items
+
+
+def normalize_os_variants(install_methods_json: list[dict[str, Any]]) -> list[str]:
+    os_values: list[str] = []
+    for item in install_methods_json:
+        if not isinstance(item, dict):
+            continue
+        resources = item.get("resources", {})
+        if not isinstance(resources, dict):
+            continue
+        os_name = resources.get("os")
+        if isinstance(os_name, str) and os_name.strip():
+            normalized = os_name.strip().lower()
+            if normalized not in os_values:
+                os_values.append(normalized)
+    return os_values
+
+
+def build_script_path(type_name: str, slug: str) -> str:
+    type_name = (type_name or "").strip().lower()
+    slug = (slug or "").strip()
+
+    if type_name == "turnkey":
+        return "turnkey/turnkey.sh"
+
+    prefix = TYPE_TO_PATH_PREFIX.get(type_name)
+    if not prefix or not slug:
+        return ""
+
+    return f"{prefix}/{slug}.sh"
+
+
 def main() -> int:
     try:
-        directory = fetch_directory_json(API_URL)
+        scripts = fetch_all_records(SCRIPT_COLLECTION_URL, expand="type,categories")
+        categories = fetch_all_records(CATEGORY_COLLECTION_URL)
     except Exception as e:
-        print(f"ERROR: No se pudo leer el índice de JSONs: {e}", file=sys.stderr)
+        print(f"ERROR: Unable to fetch PocketBase data: {e}", file=sys.stderr)
         return 1
 
-    cache: list[dict] = []
-    seen: set[tuple[str, str]] = set()  # (slug, script) para evitar duplicados
+    category_map: dict[str, dict[str, Any]] = {}
+    for category in categories:
+        category_id = category.get("id")
+        if isinstance(category_id, str) and category_id:
+            category_map[category_id] = category
 
-    total_items = len(directory)
-    processed = 0
-    kept = 0
+    cache: list[dict[str, Any]] = []
 
-    for item in directory:
-        url = item.get("download_url")
-        name_in_dir = item.get("name", "")
-        if not url or not url.endswith(".json"):
+    print(f"Fetched {len(scripts)} scripts and {len(category_map)} categories")
+
+    for idx, raw in enumerate(scripts, start=1):
+        if not isinstance(raw, dict):
             continue
 
-        try:
-            raw = requests.get(url, timeout=30).json()
-            if not isinstance(raw, dict):
-                continue
-        except Exception:
-            print(f"❌ Error al obtener/parsing {name_in_dir}", file=sys.stderr)
-            continue
-
-        processed += 1
-
-        name = raw.get("name", "")
         slug = raw.get("slug")
-        type_ = raw.get("type", "")
+        name = raw.get("name", "")
         desc = raw.get("description", "")
-        categories = raw.get("categories", [])
-        notes = [n.get("text", "") for n in raw.get("notes", []) if isinstance(n, dict)]
 
-        # Credenciales (si existen, se copian tal cual)
-        credentials = raw.get("default_credentials", {})
-        cred_username = credentials.get("username") if isinstance(credentials, dict) else None
-        cred_password = credentials.get("password") if isinstance(credentials, dict) else None
-        add_credentials = any([
-            cred_username not in (None, ""),
-            cred_password not in (None, "")
-        ])
-
-        install_methods = raw.get("install_methods", [])
-        if not isinstance(install_methods, list) or not install_methods:
-            # Sin install_methods válidos -> continuamos
+        if not isinstance(slug, str) or not slug.strip():
             continue
 
-        for im in install_methods:
-            if not isinstance(im, dict):
-                continue
-            script = im.get("script", "")
-            if not script:
-                continue
+        expand = raw.get("expand", {}) if isinstance(raw.get("expand"), dict) else {}
+        type_expanded = expand.get("type", {}) if isinstance(expand.get("type"), dict) else {}
+        type_name = type_expanded.get("type", "") if isinstance(type_expanded.get("type"), str) else ""
 
-            # OS desde resources u heurística
-            resources = im.get("resources", {}) if isinstance(im, dict) else {}
-            os_name = resources.get("os") if isinstance(resources, dict) else None
-            if not os_name:
-                os_name = guess_os_from_script_path(script)
-            if isinstance(os_name, str):
-                os_name = os_name.strip().lower()
+        script_path = build_script_path(type_name, slug)
+        if not script_path:
+            print(f"[{idx:03d}] WARNING: Unable to build script path for slug={slug} type={type_name!r}", file=sys.stderr)
+            continue
 
-            full_script_url = f"{SCRIPT_BASE}/{script}"
-            script_url_mirror = to_mirror_url(full_script_url)
+        full_script_url = f"{SCRIPT_BASE}/{script_path}"
+        script_url_mirror = to_mirror_url(full_script_url)
 
-            key = (slug or "", script)
-            if key in seen:
-                continue
-            seen.add(key)
+        install_methods_json = raw.get("install_methods_json", [])
+        if not isinstance(install_methods_json, list):
+            install_methods_json = []
 
-            entry = {
-                "name": name,
-                "slug": slug,
-                "desc": desc,
-                "script": script,
-                "script_url": full_script_url,
-                "script_url_mirror": script_url_mirror,  # nuevo
-                "os": os_name,                            # nuevo
-                "categories": categories,
-                "notes": notes,
-                "type": type_,
+        notes_json = raw.get("notes_json", [])
+        if not isinstance(notes_json, list):
+            notes_json = []
+
+        notes = [
+            note.get("text", "")
+            for note in notes_json
+            if isinstance(note, dict) and isinstance(note.get("text"), str) and note.get("text", "").strip()
+        ]
+
+        category_ids = raw.get("categories", [])
+        if not isinstance(category_ids, list):
+            category_ids = []
+
+        expanded_categories = expand.get("categories", []) if isinstance(expand.get("categories"), list) else []
+        category_names: list[str] = []
+        for cat in expanded_categories:
+            if isinstance(cat, dict):
+                cat_name = cat.get("name")
+                if isinstance(cat_name, str) and cat_name.strip():
+                    category_names.append(cat_name.strip())
+
+        if not category_names:
+            for cat_id in category_ids:
+                cat = category_map.get(cat_id, {})
+                cat_name = cat.get("name")
+                if isinstance(cat_name, str) and cat_name.strip():
+                    category_names.append(cat_name.strip())
+
+        # Shared fields across all install method entries
+        default_user = raw.get("default_user")
+        default_passwd = raw.get("default_passwd")
+        default_credentials: dict[str, str] | None = None
+        if (isinstance(default_user, str) and default_user.strip()) or (isinstance(default_passwd, str) and default_passwd.strip()):
+            default_credentials = {
+                "username": default_user if isinstance(default_user, str) else "",
+                "password": default_passwd if isinstance(default_passwd, str) else "",
             }
-            if add_credentials:
-                entry["default_credentials"] = {
-                    "username": cred_username,
-                    "password": cred_password,
-                }
 
+        base_entry: dict[str, Any] = {
+            "name": name,
+            "slug": slug,
+            "desc": desc,
+            "script": script_path,
+            "script_url": full_script_url,
+            "script_url_mirror": script_url_mirror,
+            "type": type_name,
+            "type_id": raw.get("type", ""),
+            "categories": category_ids,
+            "category_names": category_names,
+            "notes": notes,
+            "port": raw.get("port", 0),
+            "website": raw.get("website", ""),
+            "documentation": raw.get("documentation", ""),
+            "logo": raw.get("logo", ""),
+            "updateable": bool(raw.get("updateable", False)),
+            "privileged": bool(raw.get("privileged", False)),
+            "has_arm": bool(raw.get("has_arm", False)),
+            "is_dev": bool(raw.get("is_dev", False)),
+            "execute_in": raw.get("execute_in", []),
+            "config_path": raw.get("config_path", ""),
+        }
+        if default_credentials:
+            base_entry["default_credentials"] = default_credentials
+
+        # Emit one entry per install method so the menu shell can offer an
+        # explicit OS choice. When there is only one method (or none), a
+        # single entry is emitted with os="" (script decides at runtime).
+        os_variants = normalize_os_variants(install_methods_json)
+
+        if len(os_variants) > 1:
+            for os_name in os_variants:
+                entry = {**base_entry, "os": os_name}
+                cache.append(entry)
+                print(f"[{len(cache):03d}] {slug:<24} → {script_path:<28} type={type_name:<7} os={os_name}")
+        else:
+            os_name = os_variants[0] if os_variants else ""
+            entry = {**base_entry, "os": os_name}
             cache.append(entry)
-            kept += 1
+            print(f"[{len(cache):03d}] {slug:<24} → {script_path:<28} type={type_name:<7} os={os_name or 'n/a'}")
 
-            # Progreso ligero
-            print(f"[{kept:03d}] {slug or name:<24} → {script:<28} os={os_name or 'n/a'} src={'GH+MR' if script_url_mirror else 'GH'}")
-
-    # Orden estable para commits reproducibles
     cache.sort(key=lambda x: (x.get("slug") or "", x.get("script") or ""))
 
     with OUTPUT_FILE.open("w", encoding="utf-8") as f:
         json.dump(cache, f, ensure_ascii=False, indent=2)
 
     print(f"\n✅ helpers_cache.json → {OUTPUT_FILE}")
-    print(f"   Total JSON en índice: {total_items}")
-    print(f"   Procesados: {processed} | Guardados: {kept} | Únicos (slug,script): {len(seen)}")
+    print(f"   Guardados: {len(cache)}")
 
     return 0
 

.github/scripts/generate_helpers_cache_back.py

@@ -0,0 +1,178 @@
+#!/usr/bin/env python3
+import json
+import re
+import sys
+from pathlib import Path
+
+import requests
+
+# ---------- Config ----------
+# API_URL = "https://api.github.com/repos/community-scripts/ProxmoxVE/contents/frontend/public/json"
+API_URL = "https://api.github.com/repos/community-scripts/ProxmoxVE-Frontend-Archive/contents/public/json"
+SCRIPT_BASE = "https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main"
+
+# Escribimos siempre en <raiz_repo>/json/helpers_cache.json, independientemente del cwd
+REPO_ROOT = Path(__file__).resolve().parents[2]
+OUTPUT_FILE = REPO_ROOT / "json" / "helpers_cache.json"
+OUTPUT_FILE.parent.mkdir(parents=True, exist_ok=True)
+# ----------------------------
+
+
+def to_mirror_url(raw_url: str) -> str:
+    """
+    Convierte una URL raw de GitHub al raw del mirror.
+    GH : https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/docker.sh
+    MIR: https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/main/ct/docker.sh
+    """
+    m = re.match(r"^https://raw\.githubusercontent\.com/([^/]+)/([^/]+)/([^/]+)/(.+)$", raw_url or "")
+    if not m:
+        return ""
+    org, repo, branch, path = m.groups()
+    if org.lower() != "community-scripts" or repo != "ProxmoxVE":
+        return ""
+    return f"https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/{branch}/{path}"
+
+
+def guess_os_from_script_path(script_path: str) -> str | None:
+    """
+    Heurística suave cuando el JSON no publica resources.os:
+      - tools/pve/*   -> proxmox
+      - ct/alpine-*   -> alpine
+      - tools/addon/* -> generic (suele ejecutarse sobre LXC existente)
+      - ct/*          -> debian (por defecto para CTs)
+    """
+    if not script_path:
+        return None
+    if script_path.startswith("tools/pve/") or script_path == "tools/pve/host-backup.sh" or script_path.startswith("vm/"):
+        return "proxmox"
+    if "/alpine-" in script_path or script_path.startswith("ct/alpine-"):
+        return "alpine"
+    if script_path.startswith("tools/addon/"):
+        return "generic"
+    if script_path.startswith("ct/"):
+        return "debian"
+    return None
+
+
+def fetch_directory_json(api_url: str) -> list[dict]:
+    r = requests.get(api_url, timeout=30)
+    r.raise_for_status()
+    data = r.json()
+    if not isinstance(data, list):
+        raise RuntimeError("GitHub API no devolvió una lista.")
+    return data
+
+
+def main() -> int:
+    try:
+        directory = fetch_directory_json(API_URL)
+    except Exception as e:
+        print(f"ERROR: No se pudo leer el índice de JSONs: {e}", file=sys.stderr)
+        return 1
+
+    cache: list[dict] = []
+    seen: set[tuple[str, str]] = set()  # (slug, script) para evitar duplicados
+
+    total_items = len(directory)
+    processed = 0
+    kept = 0
+
+    for item in directory:
+        url = item.get("download_url")
+        name_in_dir = item.get("name", "")
+        if not url or not url.endswith(".json"):
+            continue
+
+        try:
+            raw = requests.get(url, timeout=30).json()
+            if not isinstance(raw, dict):
+                continue
+        except Exception:
+            print(f"❌ Error al obtener/parsing {name_in_dir}", file=sys.stderr)
+            continue
+
+        processed += 1
+
+        name = raw.get("name", "")
+        slug = raw.get("slug")
+        type_ = raw.get("type", "")
+        desc = raw.get("description", "")
+        categories = raw.get("categories", [])
+        notes = [n.get("text", "") for n in raw.get("notes", []) if isinstance(n, dict)]
+
+        # Credenciales (si existen, se copian tal cual)
+        credentials = raw.get("default_credentials", {})
+        cred_username = credentials.get("username") if isinstance(credentials, dict) else None
+        cred_password = credentials.get("password") if isinstance(credentials, dict) else None
+        add_credentials = any([
+            cred_username not in (None, ""),
+            cred_password not in (None, "")
+        ])
+
+        install_methods = raw.get("install_methods", [])
+        if not isinstance(install_methods, list) or not install_methods:
+            # Sin install_methods válidos -> continuamos
+            continue
+
+        for im in install_methods:
+            if not isinstance(im, dict):
+                continue
+            script = im.get("script", "")
+            if not script:
+                continue
+
+            # OS desde resources u heurística
+            resources = im.get("resources", {}) if isinstance(im, dict) else {}
+            os_name = resources.get("os") if isinstance(resources, dict) else None
+            if not os_name:
+                os_name = guess_os_from_script_path(script)
+            if isinstance(os_name, str):
+                os_name = os_name.strip().lower()
+
+            full_script_url = f"{SCRIPT_BASE}/{script}"
+            script_url_mirror = to_mirror_url(full_script_url)
+
+            key = (slug or "", script)
+            if key in seen:
+                continue
+            seen.add(key)
+
+            entry = {
+                "name": name,
+                "slug": slug,
+                "desc": desc,
+                "script": script,
+                "script_url": full_script_url,
+                "script_url_mirror": script_url_mirror,  # nuevo
+                "os": os_name,                            # nuevo
+                "categories": categories,
+                "notes": notes,
+                "type": type_,
+            }
+            if add_credentials:
+                entry["default_credentials"] = {
+                    "username": cred_username,
+                    "password": cred_password,
+                }
+
+            cache.append(entry)
+            kept += 1
+
+            # Progreso ligero
+            print(f"[{kept:03d}] {slug or name:<24} → {script:<28} os={os_name or 'n/a'} src={'GH+MR' if script_url_mirror else 'GH'}")
+
+    # Orden estable para commits reproducibles
+    cache.sort(key=lambda x: (x.get("slug") or "", x.get("script") or ""))
+
+    with OUTPUT_FILE.open("w", encoding="utf-8") as f:
+        json.dump(cache, f, ensure_ascii=False, indent=2)
+
+    print(f"\n✅ helpers_cache.json → {OUTPUT_FILE}")
+    print(f"   Total JSON en índice: {total_items}")
+    print(f"   Procesados: {processed} | Guardados: {kept} | Únicos (slug,script): {len(seen)}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

.github/workflows/build-appimage-Release.yml

@@ -1,24 +1,29 @@
-name: Build ProxMenux Monitor AppImage
+name: Build AppImage Release
 
 on:
+  workflow_dispatch:
 
-  workflow_dispatch:  
-  
 permissions:
   contents: write
-  
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   build:
     runs-on: ubuntu-22.04
     
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
+    - name: Checkout main
+      uses: actions/checkout@v5
+      with:
+        ref: main
+        token: ${{ secrets.GITHUB_TOKEN }}
       
     - name: Setup Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v5
       with:
-        node-version: '20'
+        node-version: '22'
         
     - name: Install dependencies
       working-directory: AppImage
@@ -45,13 +50,6 @@ jobs:
       id: version
       working-directory: AppImage
       run: echo "VERSION=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
-      
-    - name: Upload AppImage artifact
-      uses: actions/upload-artifact@v4
-      with:
-        name: ProxMenux-${{ steps.version.outputs.VERSION }}-AppImage
-        path: AppImage/dist/*.AppImage
-        retention-days: 30
 
     - name: Generate SHA256 checksum
       run: |
@@ -60,22 +58,26 @@ jobs:
         echo "Generated SHA256:"
         cat ProxMenux-Monitor.AppImage.sha256
 
-    - name: Upload AppImage and checksum to /AppImage folder in main
+    - name: Upload AppImage artifact
+      uses: actions/upload-artifact@v5
+      with:
+        name: ProxMenux-${{ steps.version.outputs.VERSION }}-AppImage
+        path: |
+          AppImage/dist/*.AppImage
+          AppImage/dist/*.sha256
+        retention-days: 30
+
+    - name: Commit AppImage to main
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
         git config --global user.name "github-actions[bot]"
         git config --global user.email "github-actions[bot]@users.noreply.github.com"
 
-        git fetch origin main
-        git checkout main
-
         rm -f AppImage/*.AppImage AppImage/*.sha256 || true
-
-        # Copy new files
         cp AppImage/dist/*.AppImage AppImage/
         cp AppImage/dist/ProxMenux-Monitor.AppImage.sha256 AppImage/
 
         git add AppImage/*.AppImage AppImage/*.sha256
-        git commit -m "Update AppImage build ($(date +'%Y-%m-%d %H:%M:%S'))" || echo "No changes to commit"
+        git commit -m "Update AppImage release build ($(date +'%Y-%m-%d %H:%M:%S'))" || echo "No changes to commit"
         git push origin main

.github/workflows/build-appimage-beta.yml

@@ -0,0 +1,83 @@
+name: Build AppImage Beta
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    
+    steps:
+    - name: Checkout develop
+      uses: actions/checkout@v5
+      with:
+        ref: develop
+        token: ${{ secrets.GITHUB_TOKEN }}
+      
+    - name: Setup Node.js
+      uses: actions/setup-node@v5
+      with:
+        node-version: '22'
+        
+    - name: Install dependencies
+      working-directory: AppImage
+      run: npm install --legacy-peer-deps
+      
+    - name: Build Next.js app
+      working-directory: AppImage
+      run: npm run build
+      
+    - name: Install Python dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y python3 python3-pip python3-venv
+        
+    - name: Make build script executable
+      working-directory: AppImage
+      run: chmod +x scripts/build_appimage.sh
+      
+    - name: Build AppImage
+      working-directory: AppImage
+      run: ./scripts/build_appimage.sh
+      
+    - name: Get version from package.json
+      id: version
+      working-directory: AppImage
+      run: echo "VERSION=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+    - name: Generate SHA256 checksum
+      run: |
+        cd AppImage/dist
+        sha256sum *.AppImage > ProxMenux-Monitor.AppImage.sha256
+        echo "Generated SHA256:"
+        cat ProxMenux-Monitor.AppImage.sha256
+
+    - name: Upload AppImage artifact
+      uses: actions/upload-artifact@v5
+      with:
+        name: ProxMenux-${{ steps.version.outputs.VERSION }}-beta-AppImage
+        path: |
+          AppImage/dist/*.AppImage
+          AppImage/dist/*.sha256
+        retention-days: 30
+
+    - name: Commit AppImage to develop
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        git config --global user.name "github-actions[bot]"
+        git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+        rm -f AppImage/*.AppImage AppImage/*.sha256 || true
+        cp AppImage/dist/*.AppImage AppImage/
+        cp AppImage/dist/ProxMenux-Monitor.AppImage.sha256 AppImage/
+
+        git add AppImage/*.AppImage AppImage/*.sha256
+        git commit -m "Update AppImage beta build ($(date +'%Y-%m-%d %H:%M:%S'))" || echo "No changes to commit"
+        git push origin develop

.github/workflows/build-appimage.yml

@@ -9,18 +9,21 @@ on:
     paths: [ 'AppImage/**' ]
   workflow_dispatch:  
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   build:
     runs-on: ubuntu-22.04
     
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       
     - name: Setup Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v5
       with:
-        node-version: '20'
+        node-version: '22'
         
     - name: Install dependencies
       working-directory: AppImage
@@ -49,7 +52,7 @@ jobs:
       run: echo "VERSION=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
       
     - name: Upload AppImage artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       with:
         name: ProxMenux-${{ steps.version.outputs.VERSION }}-AppImage
         path: AppImage/dist/*.AppImage

CHANGELOG.md

@@ -1,3 +1,38 @@
+## 2026-03-14
+
+### New version v1.1.9 — *Helper Scripts Catalog Rebuilt*
+
+### Changed
+
+- **Helper Scripts Menu — Full Catalog Rebuild**
+  The Helper Scripts catalog has been completely rebuilt to adapt to the new data architecture of the [Community Scripts](https://community-scripts.github.io/ProxmoxVE/) project.
+
+  The previous implementation relied on a `metadata.json` file that no longer exists in the upstream repository. The catalog now connects directly to the **PocketBase API** (`db.community-scripts.org`), which is the new official data source for the project.
+
+  A new GitHub Actions workflow generates a local `helpers_cache.json` index that replaces the old metadata dependency. This new cache is richer, more structured, and includes:
+  - Script type, slug, description, notes, and default credentials
+  - OS variants per script (e.g. Debian, Alpine) — each shown as a separate selectable option in the menu
+  - Direct GitHub URL and **Mirror URL** (`git.community-scripts.org`) for every script
+  - Category names embedded directly in the cache — no external requests needed to build the menu
+  - Additional metadata: default port, website, logo, update support, ARM availability
+
+  Scripts that support multiple OS variants (e.g. Docker with Alpine and Debian) now correctly show **one entry per OS**, each with its own GitHub and Mirror download option — restoring the behavior that existed before the upstream migration.
+
+---
+
+### 🎖 Special Acknowledgment
+
+This update would not have been possible without the openness and collaboration of the **Community Scripts** maintainers.
+
+When the upstream metadata structure changed and broke the ProxMenux catalog, the maintainers responded quickly, explained the new architecture in detail, and provided all the information needed to rebuild the integration cleanly.
+
+Special thanks to:
+
+- **MickLeskCanbiZ ([@MickLesk](https://github.com/MickLesk))** — for documenting the new script path structure by type and slug, and for the clear and direct technical guidance.
+- **Michel Roegl-Brunner ([@michelroegl-brunner](https://github.com/michelroegl-brunner))** — for explaining the new PocketBase collections structure (`script_scripts`, `script_categories`).
+
+The Helper Scripts project is an extraordinary resource for the Proxmox community. The scripts belong entirely to their authors and maintainers — ProxMenux simply offers a guided way to discover and launch them. All credit goes to the community behind [community-scripts/ProxmoxVE](https://github.com/community-scripts/ProxmoxVE).
+
 ## 2025-09-18
 
 ### New version v1.1.8 — *ProxMenux Offline Mode*

README.md

@@ -57,20 +57,114 @@ Then, follow the on-screen options to manage your Proxmox server efficiently.
 
 ---
 
-## 📌 System Requirements
-🖥 **Compatible with:**
-- Proxmox VE 8.x and 9.x
 
-📦 **Dependencies:**
-- `bash`, `curl`, `wget`, `jq`, `whiptail`, `python3-venv` (These dependencies are installed automatically during setup.)
-- **Translations are handled in a Python virtual environment using `googletrans-env`.**
+## 🧪 Beta Program
+
+Want to try the latest features before the official release and help shape the final version?
+
+The **ProxMenux Beta Program** gives early access to new functionality — including the newest builds of ProxMenux Monitor — directly from the `develop` branch. Beta builds may contain bugs or incomplete features. Your feedback is what helps fix them before the stable release.
+
+**Install the beta version:**
+
+```bash
+bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/develop/install_proxmenux_beta.sh)"
+```
+
+**What to expect:**
+
+- You'll get new features and Monitor builds before anyone else
+- Some things may not work perfectly — that's expected and normal
+- When a stable release is published, ProxMenux will notify you on the next `menu` launch and offer to switch automatically
+
+**How to report issues:**
+
+Open a [GitHub Issue](https://github.com/MacRimi/ProxMenux/issues) and include:
+- What you did and what you expected to happen
+- Any error messages shown on screen
+- Logs from the Monitor if relevant:
+
+```bash
+journalctl -u proxmenux-monitor -n 50
+```
+
+> 💙 Thank you for being part of the beta program. Your help makes ProxMenux better for everyone.
 
 ---
 
+
+## 🖥️ ProxMenux Monitor
+
+ProxMenux Monitor is an integrated web dashboard that provides real-time visibility into your Proxmox infrastructure — accessible from any browser on your network, without needing a terminal.
+
+**What it offers:**
+
+- Real-time monitoring of CPU, RAM, disk usage and network traffic
+- Overview of running VMs and LXC containers with status indicators
+- Login authentication to protect access
+- Two-Factor Authentication (2FA) with TOTP support
+- Reverse proxy support (Nginx / Traefik)
+- Designed to work across desktop and mobile devices
+
+**Access:**
+
+Once installed, the dashboard is available at:
+
+```
+http://<your-proxmox-ip>:8008
+```
+
+The Monitor is installed automatically as part of the standard ProxMenux installation and runs as a systemd service (`proxmenux-monitor.service`) that starts automatically on boot.
+
+**Useful commands:**
+
+```bash
+# Check service status
+systemctl status proxmenux-monitor
+
+# View logs
+journalctl -u proxmenux-monitor -n 50
+
+# Restart the service
+systemctl restart proxmenux-monitor
+```
+
+---
+
+
+## 🔧 Dependencies
+
+The following dependencies are installed automatically during setup:
+
+| Package | Purpose |
+|---|---|
+| `dialog` | Interactive terminal menus |
+| `curl` | Downloads and connectivity checks |
+| `jq` | JSON processing |
+| `git` | Repository cloning and updates |
+| `python3` + `python3-venv` | Translation support *(Translation version only)* |
+| `googletrans` | Google Translate library *(Translation version only)* |
+
+
+---
+
+
 ## ⭐ Support the Project!
 If you find **ProxMenux** useful, consider giving it a ⭐ on GitHub to help others discover it!
 
 
+## 🤝 Contributing
+
+Contributions, bug reports and feature suggestions are welcome!
+
+- 🐛 [Report a bug](https://github.com/MacRimi/ProxMenux/issues/new)
+- 💡 [Suggest a feature](https://github.com/MacRimi/ProxMenux/discussions)
+- 🔀 [Submit a pull request](https://github.com/MacRimi/ProxMenux/pulls)
+
+
+---
+
+
+
 ## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=MacRimi/ProxMenux&type=Date)](https://www.star-history.com/#MacRimi/ProxMenux&Date)

scripts/menus/menu_Helper_Scripts.sh

@@ -6,8 +6,8 @@
 # Author      : MacRimi
 # Copyright   : (c) 2024 MacRimi
 # License     : (GPL-3.0) (https://github.com/MacRimi/ProxMenux/blob/main/LICENSE)
-# Version     : 1.2
-# Last Updated: 14/11/2025
+# Version     : 1.3
+# Last Updated: 14/03/2025
 # ==========================================================
 # Description:
 # This script provides a simple and efficient way to access and execute Proxmox VE scripts
@@ -33,8 +33,9 @@ load_language
 initialize_cache
 # ==========================================================
 
+# New unified cache — categories and mirror URLs are embedded,
+# metadata.json is no longer needed.
 HELPERS_JSON_URL="https://raw.githubusercontent.com/MacRimi/ProxMenux/refs/heads/main/json/helpers_cache.json"
-METADATA_URL="https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/frontend/public/json/metadata.json"
 
 for cmd in curl jq dialog; do
   if ! command -v "$cmd" >/dev/null; then
@@ -44,63 +45,78 @@ for cmd in curl jq dialog; do
 done
 
 CACHE_JSON=$(curl -s "$HELPERS_JSON_URL")
-META_JSON=$(curl -s "$METADATA_URL")
 
+# Validate that the JSON loaded correctly
+if ! echo "$CACHE_JSON" | jq -e 'if type == "array" and length > 0 then true else false end' >/dev/null 2>&1; then
+  dialog --title "Helper Scripts" \
+    --msgbox "Error: Could not load helpers cache.\nCheck your internet connection and try again.\n\nURL: $HELPERS_JSON_URL" 10 70
+  exec bash "$LOCAL_SCRIPTS/menus/main_menu.sh"
+fi
+
+# ---------------------------------------------------------------------------
+# Build category map directly from the cache (id → name).
+# Uses transpose to pair categories[] and category_names[] arrays — no
+# dependency on metadata.json, which no longer exists upstream.
+# ---------------------------------------------------------------------------
 declare -A CATEGORY_NAMES
-while read -r id name; do
-  CATEGORY_NAMES[$id]="$name"
-done < <(echo "$META_JSON" | jq -r '.categories[] | "\(.id)\t\(.name)"')
+while IFS=$'\t' read -r id name; do
+  [[ -n "$id" && -n "$name" ]] && CATEGORY_NAMES["$id"]="$name"
+done < <(echo "$CACHE_JSON" | jq -r '
+  [.[] | [.categories, .category_names] | transpose[] | @tsv]
+  | unique[]')
 
+# Count scripts per category (deduplicated by slug)
 declare -A CATEGORY_COUNT
-for id in $(echo "$CACHE_JSON" | jq -r '
-  group_by(.slug) | map(.[0])[] | .categories[]'); do
+while read -r id; do
   ((CATEGORY_COUNT[$id]++))
-done
+done < <(echo "$CACHE_JSON" | jq -r '
+  group_by(.slug) | map(.[0])[] | .categories[]')
 
+# ---------------------------------------------------------------------------
+# Type label — updated to match new type values (lxc instead of ct)
+# ---------------------------------------------------------------------------
 get_type_label() {
   local type="$1"
   case "$type" in
-    ct) echo $'\Z1LXC\Zn' ;;
-    vm) echo $'\Z4VM\Zn' ;;
-    pve) echo $'\Z3PVE\Zn' ;;
-    addon) echo $'\Z2ADDON\Zn' ;;
-    *) echo $'\Z7GEN\Zn' ;;
+    lxc)     echo $'\Z1LXC\Zn' ;;
+    vm)      echo $'\Z4VM\Zn' ;;
+    pve)     echo $'\Z3PVE\Zn' ;;
+    addon)   echo $'\Z2ADDON\Zn' ;;
+    turnkey) echo $'\Z5TK\Zn' ;;
+    *)       echo $'\Z7GEN\Zn' ;;
   esac
 }
 
+# ---------------------------------------------------------------------------
+# Download and execute a script URL, with optional mirror fallback
+# ---------------------------------------------------------------------------
 download_script() {
   local url="$1"
-  local fallback_pve="${url/misc\/tools\/pve}"
-  local fallback_addon="${url/misc\/tools\/addon}"
-  local fallback_copydata="${url/misc\/tools\/copy-data}"
 
   if curl --silent --head --fail "$url" >/dev/null; then
-      bash <(curl -s "$url")
-  elif curl --silent --head --fail "$fallback_pve" >/dev/null; then
-      bash <(curl -s "$fallback_pve")
-  elif curl --silent --head --fail "$fallback_addon" >/dev/null; then
-      bash <(curl -s "$fallback_addon")
-  elif curl --silent --head --fail "$fallback_copydata" >/dev/null; then
-      bash <(curl -s "$fallback_copydata")
+    bash <(curl -s "$url")
   else
-      dialog --title "Helper Scripts" --msgbox "Error: Failed to download the script." 12 70
+    dialog --title "Helper Scripts" --msgbox "$(translate "Error: Failed to download the script.")" 8 70
   fi
 }
 
 RETURN_TO_MAIN=false
 
+# ---------------------------------------------------------------------------
+# Format default credentials for display
+# ---------------------------------------------------------------------------
 format_credentials() {
   local script_info="$1"
   local credentials_info=""
-  
+
   local has_credentials
   has_credentials=$(echo "$script_info" | base64 --decode | jq -r 'has("default_credentials")')
-  
+
   if [[ "$has_credentials" == "true" ]]; then
     local username password
     username=$(echo "$script_info" | base64 --decode | jq -r '.default_credentials.username // empty')
     password=$(echo "$script_info" | base64 --decode | jq -r '.default_credentials.password // empty')
-    
+
     if [[ -n "$username" && -n "$password" ]]; then
       credentials_info="Username: $username | Password: $password"
     elif [[ -n "$username" ]]; then
@@ -109,30 +125,41 @@ format_credentials() {
       credentials_info="Password: $password"
     fi
   fi
-  
+
   echo "$credentials_info"
 }
 
+# ---------------------------------------------------------------------------
+# Run a script identified by its slug.
+#
+# A slug can have multiple entries when a script supports several OS variants
+# (e.g. Debian + Alpine). Each entry carries its own script_url / mirror and
+# the os field already normalised to lowercase by generate_helpers_cache.py.
+# The menu lets the user pick OS variant × source (GitHub / Mirror).
+# ---------------------------------------------------------------------------
 run_script_by_slug() {
   local slug="$1"
   local -a script_infos
-  mapfile -t script_infos < <(echo "$CACHE_JSON" | jq -r --arg slug "$slug" '.[] | select(.slug == $slug) | @base64')
+  mapfile -t script_infos < <(echo "$CACHE_JSON" | jq -r --arg slug "$slug" \
+    '.[] | select(.slug == $slug) | @base64')
 
   if [[ ${#script_infos[@]} -eq 0 ]]; then
-    dialog --title "Helper Scripts" --msgbox "Error: No script data found for slug: $slug" 8 60
+    dialog --title "Helper Scripts" \
+      --msgbox "$(translate "Error: No script data found for slug:") $slug" 8 60
     return
   fi
 
-  decode() {
-    echo "$1" | base64 --decode | jq -r "$2"
-  }
+  decode() { echo "$1" | base64 --decode | jq -r "$2"; }
 
   local first="${script_infos[0]}"
-  local name desc notes
+  local name desc notes port website
   name=$(decode "$first" ".name")
   desc=$(decode "$first" ".desc")
-  notes=$(decode "$first" ".notes | join(\"\n\")")
+  notes=$(decode "$first" '.notes | join("\n")')
+  port=$(decode "$first" ".port // 0")
+  website=$(decode "$first" ".website // empty")
 
+  # Build notes block
   local notes_dialog=""
   if [[ -n "$notes" ]]; then
     while IFS= read -r line; do
@@ -145,18 +172,21 @@ run_script_by_slug() {
   local credentials
   credentials=$(format_credentials "$first")
 
-  local msg="\Zb\Z4Descripción:\Zn\n$desc"
-  [[ -n "$notes_dialog" ]] && msg+="\n\n\Zb\Z4Notes:\Zn\n$notes_dialog"
-  [[ -n "$credentials" ]] && msg+="\n\n\Zb\Z4Default Credentials:\Zn\n$credentials"
-  
-  # Add separator before menu options
+  # Build info message
+  local msg="\Zb\Z4$(translate "Description"):\Zn\n$desc"
+  [[ -n "$notes_dialog" ]] && msg+="\n\n\Zb\Z4$(translate "Notes"):\Zn\n$notes_dialog"
+  [[ -n "$credentials" ]] && msg+="\n\n\Zb\Z4$(translate "Default Credentials"):\Zn\n$credentials"
+  [[ "$port" -gt 0 ]] && msg+="\n\n\Zb\Z4$(translate "Default Port"):\Zn $port"
+  [[ -n "$website" ]] && msg+="\n\Zb\Z4$(translate "Website"):\Zn $website"
+
   msg+="\n\n$(translate "Choose how to run the script:"):"
 
+  # Build menu: one or two entries per script_info (GH + optional Mirror)
   declare -a MENU_OPTS=()
   local idx=0
   for s in "${script_infos[@]}"; do
     local os script_url script_url_mirror script_name
-    os=$(decode "$s" ".os // empty")
+    os=$(decode "$s" '.os // empty')
     [[ -z "$os" ]] && os="$(translate "default")"
     script_name=$(decode "$s" ".name")
     script_url=$(decode "$s" ".script_url")
@@ -196,7 +226,8 @@ run_script_by_slug() {
     if [[ -n "$mirror_url" ]]; then
       download_script "$mirror_url"
     else
-      dialog --title "Helper Scripts" --msgbox "$(translate "Mirror URL not available for this script.")" 8 60
+      dialog --title "Helper Scripts" \
+        --msgbox "$(translate "Mirror URL not available for this script.")" 8 60
       RETURN_TO_MAIN=false
       return
     fi
@@ -206,10 +237,10 @@ run_script_by_slug() {
   echo
 
   if [[ -n "$desc" || -n "$notes" || -n "$credentials" ]]; then
-    echo -e "$TAB\e[1;36mScript Information:\e[0m"
+    echo -e "$TAB\e[1;36m$(translate "Script Information"):\e[0m"
 
     if [[ -n "$notes" ]]; then
-      echo -e "$TAB\e[1;33mNotes:\e[0m"
+      echo -e "$TAB\e[1;33m$(translate "Notes"):\e[0m"
       while IFS= read -r line; do
         [[ -z "$line" ]] && continue
         echo -e "$TAB• $line"
@@ -218,26 +249,30 @@ run_script_by_slug() {
     fi
 
     if [[ -n "$credentials" ]]; then
-      echo -e "$TAB\e[1;32mDefault Credentials:\e[0m"
+      echo -e "$TAB\e[1;32m$(translate "Default Credentials"):\e[0m"
       echo "$TAB$credentials"
       echo
     fi
   fi
 
-  msg_success "Press Enter to return to the main menu..."
+  msg_success "$(translate "Press Enter to return to the main menu...")"
   read -r
   RETURN_TO_MAIN=true
 }
 
+# ---------------------------------------------------------------------------
+# Search / filter scripts by name or description
+# ---------------------------------------------------------------------------
 search_and_filter_scripts() {
   local search_term=""
-  
+
   while true; do
-    search_term=$(dialog --inputbox "Enter search term (leave empty to show all scripts):" \
-              8 65 "$search_term" 3>&1 1>&2 2>&3)
-    
+    search_term=$(dialog --inputbox \
+      "$(translate "Enter search term (leave empty to show all scripts):"):" \
+      8 65 "$search_term" 3>&1 1>&2 2>&3)
+
     [[ $? -ne 0 ]] && return
-    
+
     local filtered_json
     if [[ -z "$search_term" ]]; then
       filtered_json="$CACHE_JSON"
@@ -250,12 +285,14 @@ search_and_filter_scripts() {
           (.desc | ascii_downcase | contains($term))
         )]')
     fi
-    
+
     local count
     count=$(echo "$filtered_json" | jq 'group_by(.slug) | length')
-    
-    if [[ $count -eq 0 ]]; then
-      dialog --msgbox "No scripts found for: '$search_term'\n\nTry a different search term." 8 50
+
+    if [[ "$count" -eq 0 ]]; then
+      dialog --msgbox \
+        "$(translate "No scripts found for:") '$search_term'\n\n$(translate "Try a different search term.")" \
+        8 50
       continue
     fi
 
@@ -263,43 +300,41 @@ search_and_filter_scripts() {
       declare -A index_to_slug
       local menu_items=()
       local i=1
-      
+
       while IFS=$'\t' read -r slug name type; do
         index_to_slug[$i]="$slug"
         local label
         label=$(get_type_label "$type")
         local padded_name
         padded_name=$(printf "%-42s" "$name")
-        local entry="$padded_name $label"
-        menu_items+=("$i" "$entry")
+        menu_items+=("$i" "$padded_name $label")
         ((i++))
       done < <(echo "$filtered_json" | jq -r '
-        group_by(.slug) | map(.[0]) | sort_by(.name)[] | [.slug, .name, .type] | @tsv')
-      
+        group_by(.slug) | map(.[0]) | sort_by(.name)[]
+        | [.slug, .name, .type] | @tsv')
+
       menu_items+=("" "")
-      menu_items+=("new_search" "New Search")
-      menu_items+=("show_all" "Show All Scripts")
-      
-      local title="Search Results"
+      menu_items+=("new_search" "$(translate "New Search")")
+      menu_items+=("show_all"   "$(translate "Show All Scripts")")
+
+      local title
       if [[ -n "$search_term" ]]; then
-        title="Search Results for: '$search_term' ($count found)"
+        title="$(translate "Search Results for:") '$search_term' ($count $(translate "found"))"
       else
-        title="All Available Scripts ($count total)"
+        title="$(translate "All Available Scripts") ($count $(translate "total"))"
       fi
-      
+
       local selected
       selected=$(dialog --colors --backtitle "ProxMenux" \
                  --title "$title" \
-                 --menu "Select a script or action:" \
+                 --menu "$(translate "Select a script or action:"):" \
                  22 75 15 "${menu_items[@]}" 3>&1 1>&2 2>&3)
-      
-      if [[ $? -ne 0 ]]; then
-        return
-      fi
-      
+
+      [[ $? -ne 0 ]] && return
+
       case "$selected" in
         "new_search")
-          break  
+          break
           ;;
         "show_all")
           search_term=""
@@ -308,7 +343,7 @@ search_and_filter_scripts() {
           continue
           ;;
         "back"|"")
-          return  
+          return
           ;;
         *)
           if [[ -n "${index_to_slug[$selected]}" ]]; then
@@ -321,48 +356,64 @@ search_and_filter_scripts() {
   done
 }
 
+# ---------------------------------------------------------------------------
+# Main loop — category list built from embedded category data.
+# We map scriptcatXXXXX IDs to short numeric indices so dialog doesn't show
+# the long ID string as the visible tag in the menu column.
+# ---------------------------------------------------------------------------
 while true; do
   MENU_ITEMS=()
-  
-  MENU_ITEMS+=("search" "Search/Filter Scripts")
+  MENU_ITEMS+=("search" "$(translate "Search/Filter Scripts")")
   MENU_ITEMS+=("" "")
-  
-  for id in $(printf "%s\n" "${!CATEGORY_COUNT[@]}" | sort -n); do
+
+  # Map scriptcatXXXXX IDs to short numeric indices (1, 2, 3…) so dialog
+  # doesn't render the long ID string as the visible tag column.
+  declare -A CAT_IDX_TO_ID
+  local_idx=1
+  for id in $(printf "%s\n" "${!CATEGORY_COUNT[@]}" | sort); do
+    CAT_IDX_TO_ID[$local_idx]="$id"
     name="${CATEGORY_NAMES[$id]:-Category $id}"
     count="${CATEGORY_COUNT[$id]}"
     padded_name=$(printf "%-35s" "$name")
     padded_count=$(printf "(%2d)" "$count")
-    MENU_ITEMS+=("$id" "$padded_name $padded_count")
+    MENU_ITEMS+=("$local_idx" "$padded_name $padded_count")
+    ((local_idx++))
   done
 
-  SELECTED=$(dialog --backtitle "ProxMenux" --title "Proxmox VE Helper-Scripts" --menu \
-    "Select a category or search for scripts:" 20 70 14 \
-    "${MENU_ITEMS[@]}" 3>&1 1>&2 2>&3) || {
-     dialog --clear --title "ProxMenux" \
-         --msgbox "\n\n$(translate "Visit the website to discover more scripts, stay updated with the latest updates, and support the project:")\n\nhttps://community-scripts.github.io/ProxmoxVE" 15 70
+  SELECTED_IDX=$(dialog --backtitle "ProxMenux" \
+    --title "Proxmox VE Helper-Scripts" \
+    --menu "$(translate "Select a category or search for scripts:"):" \
+    20 70 14 "${MENU_ITEMS[@]}" 3>&1 1>&2 2>&3) || {
+      dialog --clear --title "ProxMenux" \
+        --msgbox "\n\n$(translate "Visit the website to discover more scripts, stay updated with the latest updates, and support the project:")\n\nhttps://community-scripts.github.io/ProxmoxVE" 15 70
       exec bash "$LOCAL_SCRIPTS/menus/main_menu.sh"
   }
- 
-  if [[ "$SELECTED" == "search" ]]; then
+
+  if [[ "$SELECTED_IDX" == "search" ]]; then
     search_and_filter_scripts
     continue
   fi
 
+  # Resolve numeric index back to the real category ID
+  SELECTED="${CAT_IDX_TO_ID[$SELECTED_IDX]}"
+  [[ -z "$SELECTED" ]] && continue
+
+  # ---- Scripts within the selected category --------------------------------
   while true; do
     declare -A INDEX_TO_SLUG
     SCRIPTS=()
     i=1
+
     while IFS=$'\t' read -r slug name type; do
       INDEX_TO_SLUG[$i]="$slug"
       label=$(get_type_label "$type")
       padded_name=$(printf "%-42s" "$name")
-      entry="$padded_name $label"
-      SCRIPTS+=("$i" "$entry") 
+      SCRIPTS+=("$i" "$padded_name $label")
       ((i++))
-    done < <(echo "$CACHE_JSON" | jq -r --argjson id "$SELECTED" '
+    done < <(echo "$CACHE_JSON" | jq -r --arg id "$SELECTED" '
       [
-        .[] 
-        | select(.categories | index($id)) 
+        .[]
+        | select(.categories | index($id))
         | {slug, name, type}
       ]
       | group_by(.slug)
@@ -371,13 +422,14 @@ while true; do
       | [.slug, .name, .type]
       | @tsv')
 
-    SCRIPT_INDEX=$(dialog --colors --backtitle "ProxMenux" --title "Scripts in ${CATEGORY_NAMES[$SELECTED]}" --menu \
-      "Choose a script to execute:" 20 70 14 \
-      "${SCRIPTS[@]}" 3>&1 1>&2 2>&3) || break
+    SCRIPT_INDEX=$(dialog --colors --backtitle "ProxMenux" \
+      --title "$(translate "Scripts in") ${CATEGORY_NAMES[$SELECTED]}" \
+      --menu "$(translate "Choose a script to execute:"):" \
+      20 70 14 "${SCRIPTS[@]}" 3>&1 1>&2 2>&3) || break
 
     SCRIPT_SELECTED="${INDEX_TO_SLUG[$SCRIPT_INDEX]}"
     run_script_by_slug "$SCRIPT_SELECTED"
-    
+
     [[ "$RETURN_TO_MAIN" == true ]] && { RETURN_TO_MAIN=false; break; }
   done
 done

version.txt

@@ -1 +1 @@
-1.1.8
+1.1.9