Files
configng/tools
Soumya Deb 37f091998d fix(jellyfin): expose MPP/RGA, setup permissions, rectify purge script (#661)
* fix(hwacc): use correct flag for RKMPP detection

The prior flag `"${LINUXFAMILY}" == "rockchip64"` was returning `false` as the actual value was set to `rk35xx` (tested on ROCK 5T, Noble 25.8.1 Minimal), resulting in no access to hardware acceleration from within the container.

Wasn't affecting direct playback, but using any kind of transcoding were resulting in playback error in the Jellyfin clients, and `ffmpeg` error 187 in the container logs.

* fix(hwacc): add udev rules for RKMPP

In addition to activating the RK35XX conditional block to expose the VPU/MPP hardware, we also need to add the correct `udev` rules (to fix up the group permissions) so that the `jellyfin`  container (rather, `jellyfin-ffmpeg` within the container) can access the host's HWA features (MPP and RGA).

* chore(formatting): remove stray indentation spaces, use EOT instead of EOF

* fix(purge): use correct app installation path for purging

* fix(purge): only delete the config, to avoid deleting user media by accident

* Fix EOT definitions and style - add tabs

* Drop udev rules upon app removal

---------

Co-authored-by: Igor Pecovnik <igor@armbian.com>
2025-08-24 11:47:20 +02:00
..
2025-03-15 15:54:41 +01:00
2024-10-28 09:22:14 -05:00
2024-10-28 09:22:14 -05:00

Tools Directory

This folder contains scripts for managing files for the armbian-config project.

Overview

config-assemble.sh

The config-assemble.sh script is used to manage and assemble module files for the armbian-config project. This script includes functionality assemble modules and jobs for production or testing.

Usage

To run the script, use the following command:

./tools/config-assemble.sh -h
Options:
  -h Display this help message
  -p Assembe module and jobs for production
  -t Assembe module and jobs  for testing

config-markdown.py

The config-dynamic-doc script generates both technical and user-focused Markdown documentation from an external JSON configuration. The generated documentation files are saved in the docs directory, with separate Markdown files for each item in the JSON configuration.

Usage

python3 config-markdown.py -h

The script expects the JSON file to be located at ../lib/armbian-config/config.jobs.json

Error: The configuration file 'config.jobs.json' was not found.
Please run 'config_assemble.sh` `-p` or `-t' first.
python3 config-markdown.py -h
Usage: config-markdown [-u|-t]
Options:
  -u  Generate user documentation
  -t  Generate technical documentation

What It Does

  • Creates navigation links (table of contents) for all IDs and descriptions.

  • Generates technical documentation that includes commands, prompts, conditions, author information, and status.

  • Creates user-focused documentation with simplified instructions.

  • Includes custom header, footer and section image:

    - tools/include/markdown/ID-header.md
    - tools/include/markdown/ID-footer.md
    - tools/include/images/ID.png
    

Dependencies

  • Python 3 with the standard libraries json, sys, argparse, and os.

Example Usage

Markdown files will be created in the docs directory.