Merge pull request #2206 from alexbelgium/codex/add-env_vars-to-epic-games-addon

Add env_vars option to epicgamesfree addon

epicgamesfree/CHANGELOG.md

@@ -1,3 +1,6 @@
+## "debian-2025-11-09" (09-11-2025)
+- Added support for configuring extra environment variables via the `env_vars` add-on option alongside config.json
+
 ## "debian-2025-10-28" (01-11-2025)
 - Minor bugs fixed
 

epicgamesfree/README.md

@@ -28,7 +28,7 @@ This addon is based on the docker image https://hub.docker.com/r/charlocharlie/e
 
 ## Configuration
 
-There are no addon options available through the Home Assistant interface. All configuration is done via JSON files.
+Addon options expose the `env_vars` field for passing extra environment variables; all other configuration is done via JSON files.
 
 ### Configuration Files
 
@@ -39,6 +39,8 @@ Configuration files are stored in `/config/addons_config/epicgamesfree/`:
 
 If these files don't exist, they will be created at first boot with default settings.
 
+- **env_vars option**: Use the add-on `env_vars` option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.
+
 ### Basic Configuration
 
 Create `/config/addons_config/epicgamesfree/config.yaml`:

epicgamesfree/config.yaml

@@ -73,12 +73,18 @@ init: false
 map:
   - config:rw
 name: Epic Games Free
+options:
+  env_vars: []
 ports:
   3000/tcp: 3000
 ports_description:
   3000/tcp: web interface
+schema:
+  env_vars:
+    - name: match(^[A-Za-z0-9_]+$)
+      value: str?
 slug: epicgamesfree
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "debian-2025-10-28"
+version: "debian-2025-11-09"
 webui: "[PROTO:ssl]://[HOST]:[PORT:3000]"

jellyfin/CHANGELOG.md

@@ -1,3 +1,8 @@
+## breaking_versions: 10.11.3 (17-11-2025)
+- Minor bugs fixed
+
+## 10.11.3 (17-11-2025)
+- Add optional `i915_enable_guc` setting to apply Intel GuC mode at startup for improved hardware encoding stability, with runtime-only changes that rely on the host exposing `/sys/module/i915/parameters/enable_guc`.
 
 ## 10.11.2 (08-11-2025)
 - Update to latest version from linuxserver/docker-jellyfin (changelog : https://github.com/linuxserver/docker-jellyfin/releases)

jellyfin/README.md

@@ -43,6 +43,7 @@ Webui can be found at `<your-ip>:8096` or through the sidebar using Ingress.
 | `cifsusername` | str | | SMB username for network shares |
 | `cifspassword` | str | | SMB password for network shares |
 | `cifsdomain` | str | | SMB domain for network shares |
+| `i915_enable_guc` | int | | Optional Intel iGPU `enable_guc` parameter (0-3) applied at startup for improved hardware encoding compatibility. Does not reconfigure the kernel; the host must already expose `/sys/module/i915/parameters/enable_guc`. |
 | `DOCKER_MODS` | list | | Additional Docker mods for hardware acceleration |
 
 ### Example Configuration
@@ -69,6 +70,8 @@ Available Docker mods for hardware acceleration:
 - `linuxserver/mods:jellyfin-amd` - AMD hardware acceleration
 - `linuxserver/mods:jellyfin-rffmpeg` - Custom FFmpeg build
 
+For Intel systems that require GuC submission for stable hardware encoding (e.g., N6005), set `i915_enable_guc` to `2` to apply the kernel parameter at container startup. The add-on only writes to the existing runtime module parameter; no kernel rebuild or boot parameter change is attempted. If the path `/sys/module/i915/parameters/enable_guc` is missing or read-only on the host kernel, the add-on logs a warning and continues without modification.
+
 ### Mounting Drives
 
 This addon supports mounting both local drives and remote SMB shares:

jellyfin/config.yaml

@@ -92,6 +92,7 @@ options:
   PGID: 0
   PUID: 0
   data_location: /share/jellyfin
+  i915_enable_guc: null
 panel_admin: false
 panel_icon: mdi:billiards-rack
 ports:
@@ -120,10 +121,11 @@ schema:
   cifspassword: str?
   cifsusername: str?
   data_location: str
+  i915_enable_guc: int?
   localdisks: str?
   networkdisks: str?
 slug: jellyfin
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "10.11.2"
+version: "10.11.3"
 video: true

jellyfin/rootfs/etc/cont-init.d/25-i915-enable-guc.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/with-contenv bashio
+# shellcheck shell=bash
+set -e
+
+if ! bashio::config.has_value 'i915_enable_guc'; then
+    exit 0
+fi
+
+GUC_VALUE=$(bashio::config 'i915_enable_guc')
+
+if [[ "${GUC_VALUE}" = "null" ]]; then
+    exit 0
+fi
+
+if [[ ${GUC_VALUE} -lt 0 || ${GUC_VALUE} -gt 3 ]]; then
+    bashio::log.warning "Invalid i915_enable_guc value '${GUC_VALUE}'. Expected a value between 0 and 3. Skipping configuration."
+    exit 0
+fi
+
+PARAM_PATH="/sys/module/i915/parameters/enable_guc"
+
+if [ ! -e "${PARAM_PATH}" ]; then
+    bashio::log.warning "i915 module parameter not found at ${PARAM_PATH}. The add-on cannot enable GuC unless the host kernel exposes this path."
+    exit 0
+fi
+
+if [ ! -w "${PARAM_PATH}" ]; then
+    bashio::log.warning "Missing permission to change ${PARAM_PATH}. Try enabling privileged mode or ensure the host allows changing the parameter."
+    exit 0
+fi
+
+if echo "${GUC_VALUE}" > "${PARAM_PATH}"; then
+    bashio::log.info "Set i915 enable_guc to ${GUC_VALUE}."
+else
+    bashio::log.warning "Failed to set i915 enable_guc to ${GUC_VALUE}."
+fi