refactor script

not really supported, local test not possible

.github/scripts/translate.py

@@ -0,0 +1,25 @@
+from googletrans import Translator
+
+def translate_readme(input_text, target_lang):
+    translator = Translator()
+    translated = translator.translate(input_text, dest=target_lang)
+    translated_text = translated.text
+    
+    # add hint for automatically translation
+    translated_text = f"Note: This is an automatically translated file. Original content from [here](https://github.com/tuxbox-neutrino/buildenv/blob/3.2.4/README-de.md):\n\n{translated_text}"
+
+    # Use this workaround, because translater breaks some links and anchors
+    translated_text = translated_text.replace("[Build Image](#Build Image)", "[Build Image](#build-image)")
+    translated_text = translated_text.replace("devtool -reference.html", "devtool-reference.html")
+    translated_text = translated_text.replace("dev-manual -common-tasks.html", "dev-manual-common-tasks.html")
+    translated_text = translated_text.replace("Clone #1-Init-Script", "#1-clone-init-script")
+
+    return translated_text
+
+if __name__ == "__main__":
+    input_text = open("README-de.md", "r").read()
+    target_lang = "en"  # target language is english
+    translated_text = translate_readme(input_text, target_lang)
+
+    with open("README-en.md", "w") as outfile:
+        outfile.write(translated_text)

.github/workflows/readme.yml

@@ -0,0 +1,42 @@
+name: Translate README
+
+on:
+  push:
+    branches:
+      - 3.2.4
+    paths:
+      - 'README-de.md'
+
+permissions:
+  contents: write
+
+jobs:
+  translate:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Setup Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.x
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install --upgrade googletrans==3.1.0a0
+
+    - name: Translate README
+      run: |
+        python .github/scripts/translate.py
+
+    - name: Commit and push translated README
+      run: |
+        git config --global user.email "actions@github.com"
+        git config --global user.name "GitHub Actions"
+        git add README-en.md
+        git commit -m "readme: Automatically translated README to English"
+        git push
+

.gitignore

@@ -9,6 +9,12 @@ build-neutrino
 local.conf.common.inc
 dist/*
 build*
+backups*
 *.orig
 *.log
+local build increment
+*.list
+
+*/poky
+poky-*
 

README-de.md

@@ -0,0 +1,213 @@
+# Schnellstart Image-Erstellung #
+
+- [Vorbereitung](#Vorbereitung)
+- [Image bauen](#Image-bauen)
+- [Aktualisierung](#Aktualisierung)
+- [Arbeiten an Zielquellen](#Arbeiten-an-Zielquellen)
+- [Übersicht über globale Konfigurationsdateien](#Übersicht-über-globale-Konfigurationsdateien)
+
+## Vorbereitung
+
+### Erforderliche Host-Pakete installieren (Debian 11)
+Zur Verwendung mit anderen Distributionen siehe: [Yocto Project Quick Build](https://docs.yoctoproject.org/3.2.4/ref-manual/ref-system-requirements.html#supported-linux-distributions)
+
+> :memo: **HINWEIS:** Bei Verwendung der Tuxbox-Builder-VM (welche nicht zwingend erforderlich ist), springe bitte zu [Schritt 1](#1-Init-Skript-klonen). Die Tuxbox-Builder-VM enthält bereits erforderliche Pakete. Details und Download von Tuxbox-Builder VM siehe: [Tuxbox-Builder](https://sourceforge.net/projects/n4k/files/Tuxbox-Builder)
+
+```bash
+apt-get install -y gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential \
+chrpath socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils \
+iputils-ping python3-git python3-jinja2 libegl1-mesa pylint3 xterm subversion locales-all \
+libxml2-utils ninja-build default-jre clisp libcapstone4 libsdl2-dev doxygen
+```
+> :memo: **HINWEIS:** Bei Debian 10 (buster) libcapstone3 verwenden.
+
+#### Empfohlene Zusatzpakete zur grafischen Unterstützung und Analyse (z.B. mit Kdevelop, Meld):
+```bash
+apt-get install -y gitk git-gui meld cppcheck clazy kdevelop
+```
+
+### Optional: Falls kein konfiguriertes Git vorhanden ist, gib bitte Deine globalen Git-Benutzerdaten ein:
+```bash
+git config --global user.email "you@example.com"
+git config --global user.user "Dein Name"
+```
+
+## Image bauen
+
+> :memo: **Hinweis:** Einige Pfade basieren auf Vorgaben, die vom Init-Script erzeugt werden. Einige Einträge werden als ```<Platzhalter>``` dargestellt, die entsprechend angepasst werden müssen.
+
+> ### 1. Init-Skript klonen.
+```bash
+git clone https://github.com/tuxbox-neutrino/buildenv.git
+cd buildenv
+```
+
+> ### 2. Init-Skript ausführen
+```bash
+./init
+cd poky-3.2.4
+```
+
+> ### 3. Liste möglicher Maschinentypen anzeigen
+```bash
+ls  build
+```
+
+> ### 4. Umgebungsskript ausführen
+```bash
+. ./oe-init-build-env build/<Machine-Type aus der Liste von Schritt 3 hier eintragen>
+```
+
+> ### 5. Bauen
+```bash
+bitbake neutrino-image
+```
+
+Das kann eine Weile dauern. Einige Warnmeldungen können ignoriert werden. Fehlermeldungen, welche die Setscene-Tasks betreffen, sind kein Problem, aber Fehler während der Build- und Package-Tasks brechen den Prozess in den meißten Fällen ab.  [Bitte melde in diesem Fall den Fehler oder sende Deine Lösung an uns](https://forum.tuxbox-neutrino.org/forum/viewforum.php?f=77). Hilfe ist sehr willkommen.
+
+Wenn alles erledigt ist, sollte eine ähnliche Meldung wie diese erscheinen:
+```bash
+...
+NOTE: Tasks Summary: Attempted 4568 tasks of which 4198 didn't need to be rerun and all succeeded.
+...
+```
+**Das war's ...**
+
+Erstellte Images und Pakete sind zu finden unter:
+```
+~/build/poky-3.2.4/build/<machine>/tmp/deploy
+```
+oder im dist-Verzeichnis:
+```
+~/build/dist/<Image-Version>/<machine>/
+```
+
+## Aktualisierung
+> :memo: Manuelle Aktualisierungen für beliebeige Ziel-Quellen sind nicht erforderlich. Dies wird automatisch bei jedem aufgerufenen Ziel mit Bitbake durchgeführt. Dadurch werden auch immer erforderliche Abhängigkeiten aktualisiert. Wenn man die volle Kontrolle über bestimmte Ziel-Quellen haben möchte,  siehe [Arbeiten an Zielquellen](#Arbeiten-an-Zielquellen)!
+
+Falls [Schritte 1 bis 4](#3-Liste-möglicher-Maschinentypen-anzeigen) bereits ausgeführt wurden, ist nur Schritt 5 erforderlich:
+
+### Update Image
+```bash
+bitbake neutrino-image
+```
+	
+### Update Ziel
+```bash
+bitbake <target>
+```
+
+### Meta-Layer-Repositories aktualisieren
+Die erneute Ausführung des Init-Skripts aktualisiert die enthaltenen Meta-Layer auf den Stand der Remote-Repositories. 
+```bash
+cd $HOME/build
+./init
+```	
+Die angestoßenen Update-Routinen des Init-scripts sollten nicht festgeschriebene Änderungen vorübergehend stashen bzw. rebasen lokale Commits auf die Remote-Änderungen. Konflikte muss man jedoch manuell auflösen. Natürlich kann man seine lokalen Meta-Layer für Meta-Neutrino- und Maschinen-Layer-Repositories manuell aktualisieren und modifizieren. 
+
+> :memo: **Hinweis:** Konfigurationsdateien bleiben unberührt. Neue oder geänderte Konfigurationsoptionen werden nicht berücksichtigt. Bitte überprüfe ggf. die Konfiguration.
+
+## Arbeiten an Zielquellen
+Wenn man die volle Kontrolle über die Ziel-Quellen haben möchte, sollten die Quellcodes in den Workspace verschoben werden. Siehe 
+[devtool](https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html) und insbesondere [devtool modify](https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html#modifying-an-existing-recipe).
+
+## Konfiguration zurücksetzen
+Wenn Du deine Maschinen-Konfigurationen zurücksetzen möchtest, benenne bitte das conf-Verzeichnis um (Löschen wird nicht empfohlen) und führe das Init-Skript erneut aus.
+```bash
+mv $HOME/build/poky-3.2.4/build/<machine>/conf $HOME/build/poky-3.2.4/build/<machine>/conf.01
+cd $HOME/build
+./init
+```
+	
+## Neubau eines einzelnen Ziels erzwingen
+In einigen Fällen kann es vorkommen, dass ein Target, warum auch immer, abbricht. Man sollte deswegen nicht in Panik verfallen und deswegen den tmp-Ordner und den sstate-cache löschen. Das kann man auch für jedes Target einzeln machen.
+
+> :memo: Insbesondere defekte Archiv-URL's können zum Abbruch führen. Diese Fehler werden aber immer angezeigt und man kann die URL überprüfen. Oft liegt es nur an den Servern und funktioneren nach wenigen Minuten sogar wieder.
+
+Um sicherzustellen, ob das betreffende Recipe auch tatsächlich ein Problem hat, macht es Sinn das betreffende Target komplett zu bereinigen und neu zu bauen. Um dies zu erzwingen, müssen alle erzeugten Paket-, Build- und Cachedaten bereinigt werden.
+```bash
+bitbake -c cleansstate <target>
+```
+anschließend neu bauen:
+```bash
+bitbake <target>
+```
+	
+## Vollständigen Imagebau erzwingen
+Wenn Du einen kompletten Imagebau erzwingen möchtest, kann man das tmp-Verzeichnis löschen (oder umbenennen):
+```bash
+mv tmp tmp.01
+bitbake neutrino-image
+```
+Wenn man den sstate-cache **nicht** gelöscht hat, sollte das Image in relativ kurzer Zeit fertig gebaut sein. Daher wird empfohlen, den sstate-cache beizubehalten. Das Verzeichnis wo sich der sstate-cache befindet, wird über die Variable ```${SSTATE_DIR}``` festgelegt und kann in der Konfiguration angepasst werden. 
+	
+Dieses Verzeichnis ist ziemlich wertvoll und nur in seltenen Fällen ist es notwendig, dieses Verzeichnis zu löschen. Bitte beachte, dass der Build in diesem Fall sehr viel mehr Zeit in Anspruch nimmt. 
+> :bulb: Man kann Bitbake anweisen, keinen sstate-cache zu verwenden.
+```bash
+bitbake --no-setscene neutrino-image
+```
+oder
+```bash
+bitbake --skip-setscene neutrino-image
+```
+	
+## Bei Bedarf anpassen
+Es wird empfohlen, zum ersten Mal ohne Änderungen an den Konfigurationsdateien zu bauen, um einen Eindruck davon zu bekommen, wie der Build-Prozess funktioniert, und um die Ergebnisse zu sehen.
+Die Einstellmöglichkeiten sind sehr umfangreich und für Einsteiger nicht wirklich überschaubar. Das Yoctoproject ist jedoch sehr
+umfassend dokumentiert und bietet die beste Informationsquelle.
+	
+**Wichtig für Entwickler**: "[Arbeiten an Zielquellen](#Arbeiten-an-Zielquellen)"!
+
+> :memo: **Bitte ändere nicht die Yocto-Recipes! Dies wird vom Yocto-Team nicht empfohlen, aber man kann zum Vervollständigen, Erweitern oder Überschreiben von Meta-Core-Recipes [.bbappend](https://docs.yoctoproject.org/3.2.4/dev-manual/dev-manual-common-tasks.html#using-bbappend-files-in-your-layer)-Dateien verwenden.**
+
+### Übersicht über globale Konfigurationsdateien
+Für die lokale Konfiguration werden diese Konfigurationsdateien innerhalb der Build-Verzeichnissen benötigt:
+
+> $HOME/build/poky-3.2.4/build/```<machine>```/conf/local.conf
+
+Diese generierte local.conf enthält nur wenige Zeilen, besitzt aber eine Zeile, die auf eine gemeinsame Konfigurationsdatei zeigt, die für alle Images und unterstützten Maschinentypen gültig ist und kann man mit eigenen Optionen füttern.
+	
+> $HOME/build/local.conf.common.inc
+
+Diese **.inc** Datei wurde aus der geklonten Beispieldatei beim erstmaligen ausführen des init-Scripts erzeugt.
+
+> local.conf.common.inc.sample
+
+Diese Beispieldatei sollte unberührt bleiben, um mögliche Konflikte beim Aktualisieren des build-Repositories zu vermeiden und um zu sehen, was sich geändert haben könnte.
+	
+Nach einer Aktualisierung des build-Repositries könnten einige neue oder geänderte Optionen hinzugefügt oder entfernt worden sein, die nicht in die inkludierte Konfigurationsdatei übernommen werden. Diesen Fall sollte man in der eigenen Konfiguration berücksichtigen und falls erforderlich anpassen.
+Natürlich kann man ```$HOME/Build/poky-3.2.4/build/<machine>/conf/local.conf``` mit eigenen Anforderungen ändern und als separate Konfigurationsdatei für einen Maschinentyp verwenden. 
+
+#### Musterkonfiguration für bblayers.conf:
+> $HOME/build/poky-3.2.4/build/```<machine>```/conf/bblayers.conf
+
+```bitbake
+# POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
+# changes incompatibly
+POKY_BBLAYERS_CONF_VERSION = "2"
+
+BBPATH = "${TOPDIR}"
+BBFILES ?= ""
+
+BBLAYERS ?= " \
+  /home/<username>build/poky-3.2.4/meta \
+  /home/<username>/build/poky-3.2.4/meta-poky \
+  /home/<username>/build/poky-3.2.4/meta-yocto-bsp \
+  "
+BBLAYERS += " \
+			/home/<username>/build/poky-3.2.4/meta-neutrino \
+			/home/<username>/build/poky-3.2.4/meta-<machine-brand-or-bsp-name> \
+			/home/<username>/build/poky-3.2.4/meta-openembedded/meta-oe \
+			"
+BBLAYERS += " \
+				/home/<username>/build/poky-3.2.4/meta-python2 \
+				"
+BBLAYERS += " \
+				/home/<username>/build/poky-3.2.4/meta-qt5 \
+				"
+```
+
+## Mehr Informationen
+Weitere Informationen zum Yocto Buildsystem:
+
+* https://docs.yoctoproject.org/3.2.4/index.html

README-en.md

@@ -0,0 +1,215 @@
+Note: This is an automatically translated file. Original content from [here](https://github.com/tuxbox-neutrino/buildenv/blob/3.2.4/README-de.md):
+
+# Quick start image creation #
+
+- [Preparation](#Preparation)
+- [Build Image](#build-image)
+- [Update](#Update)
+- [Working on Target Sources](#Working-on-Target-Sources)
+- [Overview of global configuration files](#overview-of-global-configuration-files)
+
+## Preparation
+
+### Install required host packages (Debian 11)
+For use with other distributions see: [Yocto Project Quick Build](https://docs.yoctoproject.org/3.2.4/ref-manual/ref-system-requirements.html#supported-linux-distributions)
+
+> :memo: **NOTE:** If using the Tuxbox Builder VM (which is not mandatory), please skip to [Step 1](#1-clone-init-script). The Tuxbox Builder VM already contains required packages. Details and download of Tuxbox-Builder VM see: [Tuxbox-Builder](https://sourceforge.net/projects/n4k/files/Tuxbox-Builder)
+
+```bash
+apt-get install -y gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential \
+chrpath socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils \
+iputils-ping python3-git python3-jinja2 libegl1-mesa pylint3 xterm subversion locales-all \
+libxml2-utils ninja-build default-jre clisp libcapstone4 libsdl2-dev doxygen
+```
+> :memo: **NOTE:** On Debian 10 (buster) use libcapstone3.
+
+#### Recommended additional packages for graphical support and analysis (e.g. with Kdevelop, Meld):
+```bash
+apt-get install -y gitk git-gui meld cppcheck clazy kdevelop
+```
+
+### Optional: If there is no configured Git, please enter your global Git user data:
+```bash
+git config --global user.email "you@example.com"
+git config --global user.user "Your name"
+```
+
+## Build image
+
+> :memo: **Note:** Some paths are based on defaults generated by the init script. Some entries are displayed as ```<placeholder>```, which need to be adjusted accordingly.
+
+> ### 1. Clone init script.
+```bash
+git clone https://github.com/tuxbox-neutrino/buildenv.git
+cd buildenv
+```
+
+> ### 2. Run init script
+```bash
+./init
+cd poky-3.2.4
+```
+
+> ### 3. Show list of possible machine types
+```bash
+ls build
+```
+
+> ### 4. Run environment script
+```bash
+. ./oe-init-build-env build/<enter machine type from the list from step 3 here>
+```
+
+> ### 5. Build
+```bash
+bitbake neutrino image
+```
+
+This could take a while. Some warning messages can be ignored. Error messages affecting the setscene tasks are not a problem, but errors during the build and package tasks terminate the process in most cases. [In this case, please report the error or send your solution to us](https://forum.tuxbox-neutrino.org/forum/viewforum.php?f=77). Help is very welcome.
+
+When everything is done, you should see a message similar to this:
+```bash
+...
+NOTE: Tasks Summary: Attempted 4568 tasks of which 4198 didn't need to be rerun and all succeeded.
+...
+```
+**That's it...**
+
+Created images and packages can be found at:
+```
+~/build/poky-3.2.4/build/<machine>/tmp/deploy
+```
+or in the dist directory:
+```
+~/build/dist/<image version>/<machine>/
+```
+
+## Update
+> :memo: Manual updates for arbitrary target sources are not required. This is done automatically for every target accessed using Bitbake. This means that required dependencies are always updated. If you want full control over specific target sources, see [Working on Target Sources](#Working-on-Target-Sources)!
+
+If [Steps 1 to 4](View #3-list-of-possible-machine-types) have already been completed, only step 5 is required:
+
+### Update image
+```bash
+bitbake neutrino image
+```
+
+### Update target
+```bash
+bitbake <target>
+```
+
+### Update meta layer repositories
+Re-executing the init script updates the included meta layers to the status of the remote repositories.
+```bash
+cd $HOME/build
+./init
+```
+The triggered update routines of the init script should temporarily stash uncommitted changes or rebase local commits to the remote changes. However, conflicts must be resolved manually. Of course, you can manually update and modify your local meta layers for meta neutrino and machine layer repositories.
+
+> :memo: **Note:** Configuration files remain untouched. New or changed configuration options are not taken into account. Please check the configuration if necessary.
+
+## Working on target sources
+If you want to have full control over the target sources, the source codes should be moved to the workspace. Please refer
+[devtool](https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html) and especially [devtool modify](https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html#modifying-an-existing-recipe).
+
+## Reset configuration
+If you want to reset your machine configurations, please rename the conf directory (deletion is not recommended) and run the init script again.
+```bash
+mv $HOME/build/poky-3.2.4/build/<machine>/conf $HOME/build/poky-3.2.4/build/<machine>/conf.01
+cd $HOME/build
+./init
+```
+
+## Force rebuild of a single target
+In some cases it can happen that a target breaks off for whatever reason. You shouldn't panic and delete the tmp folder and the sstate cache. You can also do this for each target individually.
+
+> :memo: In particular, broken archive URLs can lead to termination. However, these errors are always displayed and you can check the URL. Often it's just the servers and they even work again after a few minutes.
+
+To make sure whether the recipe in question actually has a problem, it makes sense to completely clean up the target in question and rebuild it. To enforce this, all generated package, build and cache data must be cleaned up.
+```bash
+bitbake -c cleansstate <target>
+```
+then rebuild:
+```bash
+bitbake <target>
+```
+
+## Force full image build
+If you want to force a complete image build, you can delete (or rename) the tmp directory:
+```bash
+mv tmp tmp.01
+bitbake neutrino image
+```
+If you have **not** cleared the sstate cache, the image should be built in a relatively short time. Therefore, it is recommended to keep the sstate cache. The directory where the sstate cache is located is determined via the variable ```${SSTATE_DIR}``` and can be adjusted in the configuration.
+
+This directory is quite valuable and only in rare cases is it necessary to delete this directory. Please note that the build will take much longer in this case.
+> :bulb: You can tell Bitbake not to use sstate cache.
+```bash
+bitbake --no-setscene neutrino-image
+```
+or
+```bash
+bitbake --skip-setscene neutrino-image
+```
+
+## Adjust if necessary
+It is recommended to build for the first time without making any changes to the configuration files to get an idea of ​​how the build process works and to see the results.
+The setting options are very extensive and not really manageable for beginners. However, the Yoctoproject is very
+comprehensively documented and provides the best source of information.
+
+**Important for developers**: "[Working on Target Sources](#Working-on-Target-Sources)"!
+
+> :memo: **Please do not change the Yocto recipes! This is not recommended by the Yocto team, but you can use [.bbappend](https://docs.yoctoproject.org/3.2.4/dev-manual/dev-manual-common-tasks.html#using-bbappend-files-in-your-layer) files.**
+
+### Overview of global configuration files
+For local configuration, these configuration files are required within the build directories:
+
+> $HOME/build/poky-3.2.4/build/```<machine>```/conf/local.conf
+
+This generated local.conf only contains a few lines, but has a line that points to a common configuration file that is valid for all images and supported machine types and can be fed with your own options.
+
+> $HOME/build/local.conf.common.inc
+
+This **.inc** file was created from the cloned example file when running the init script for the first time.
+
+> local.conf.common.inc.sample
+
+This example file should be left untouched to avoid possible conflicts when updating the build repository and to see what might have changed.
+
+After an update to the build repository, some new or changed options may have been added or removed that are not reflected in the included configuration file. You should take this case into account in your own configuration and adapt it if necessary.
+Of course, you can modify ```$HOME/Build/poky-3.2.4/build/<machine>/conf/local.conf``` with your own requirements and use it as a separate configuration file for a machine type.
+
+#### Sample configuration for bblayers.conf:
+> $HOME/build/poky-3.2.4/build/```<machine>```/conf/bblayers.conf
+
+```bitbake
+# POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
+# changes incompatibly
+POKY_BBLAYERS_CONF_VERSION = "2"
+
+BBPATH = "${TOPDIR}"
+BBFILES ?= ""
+
+BBLAYERS ?= " \
+  /home/<username>build/poky-3.2.4/meta \
+  /home/<username>/build/poky-3.2.4/meta-poky \
+  /home/<username>/build/poky-3.2.4/meta-yocto-bsp \
+  "
+BBLAYERS += "\
+/home/<username>/build/poky-3.2.4/meta-neutrino \
+/home/<username>/build/poky-3.2.4/meta-<machine-brand-or-bsp-name> \
+/home/<username>/build/poky-3.2.4/meta-openembedded/meta-oe \
+"
+BBLAYERS += "\
+/home/<username>/build/poky-3.2.4/meta-python2 \
+"
+BBLAYERS += "\
+/home/<username>/build/poky-3.2.4/meta-qt5 \
+"
+```
+
+## More information
+Further information about the Yocto build system:
+
+* https://docs.yoctoproject.org/3.2.4/index.html

README.md

@@ -1,156 +1,7 @@
-# Quick start image build #
 
-## Preparation
-NOTE: If you are using the Tuxbox-Builder VM please jump to step 1. The Tuxbox-Builder VM already contains required packages.
-For details and download of Tuxbox-Builder VM see: https://sourceforge.net/projects/n4k/files/Tuxbox-Builder
-
-### Install required packages (Debian 9/10)
-```bash
-apt-get install -y gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa pylint3 xterm subversion locales-all libxml2-utils ninja-build default-jre clisp
-```
-Also required is sdl.
-```bash
-apt-get install -y libsdl1.2-dev
-```
-For newer image versions with dunfell (3.1) or later use libsdl2-dev instead libsdl1.2-dev
-```bash
-apt-get install -y libsdl2-dev
-```
-
-### Recommended additional packages:
-```bash
-apt-get install -y gitk git-gui meld
-```
-NOTE: In case of no configured git, please set your global git user data:
-```bash
-git config --global user.email "you@example.com"
-git config --global user.user "Your Name"
-```
-
-For usage with other distributions see:
-
-https://www.yoctoproject.org/docs/3.0.3/brief-yoctoprojectqs/brief-yoctoprojectqs.html
-
-## 1. Clone init script into a directory of your choice
-```bash
-$:~ git clone https://github.com/Tuxbox-Project/build.git
-```
-
-## 2. Change to the generated directory
-```bash
-$:~ cd build
-```
-
-## 3. Execute init script
-This will clone all required layers and moves some config files into your build directory.
-* Parameter 1: Machine type can be  h7, hd51, hd60, hd61, osmio4k, osmio4kplus or set 'all' or keep empty '' for all machines.
-* Parameter 2: Image version can be 3.0, 3.1, 3.2 or keep empty for latest version (recommended, because of older versions are not really maintained anymore)
-```bash
-$:~ ./init.sh <machine> <image-version>
-```
-
-## 4. Switch to poky directory
-After sccessfull executed init script you will find a subdirectory like poky-3.x .
-Now switch to this directory e.g.:
-```bash
-$:~ cd poky-3.2
-```
-
-## 5. Execute environment script
-Please use possible machine type which you selected (see step 3)! Here as example we use hd51.
-This creates (if not exists!) the build directory named as hd51 (default name ist build) and sets the build environment.
-```bash
-$:~ . ./oe-init-build-env hd51
-
-### Shell environment set up for builds. ###
-
-You can now run 'bitbake <target>'
-
-Common targets are:
-    core-image-minimal
-    core-image-sato
-    meta-toolchain
-    meta-ide-support
-
-You can also run generated qemu images with a command like 'runqemu qemux86'
-
-Other commonly useful commands are:
- - 'devtool' and 'recipetool' handle common recipe tasks
- - 'bitbake-layers' handles common layer tasks
- - 'oe-pkgdata-util' handles common target package tasks
-tuxbox@tuxbox-builder:~/Build/poky-3.0/hd51
-$ . ./oe-init-build-env hd51
-```
-NOTE: If you left the build directory you must retry step 5 for your machine type to recreate the required environment.
-
-## 6. Build image
-After step 5 you are ready to build an image.
-```bash
-$:~ /build/poky-3.0/<machine>$ bitbake neutrino-image
-```
-This may take a while. Some warn messages can be ignored and error messages during setscene tasks are no problem but errors during build and package tasks will abort the process. In this case please report or send us your solution to https://forum.tuxbox-neutrino.org/forum/viewforum.php?f=77. Help is very welcome.
-
-If all done, such a message should appear:
-```bash
-...
-NOTE: Tasks Summary: Attempted 4568 tasks of which 4198 didn't need to be rerun and all succeeded.
-...
-```
-## That's it ...
-
-Built images and packages to find under:
-```
-~/build/poky-X.X/<machine>/tmp/deploy
-```
-or in the dist directory:
-```
-~/build/dist/<image-version/<machine>/
-```
-
-## Update the meta layer repositories
-Execution of init script will update the meta layers. Of corse you can update your meta-layer repositories manually.
-
-Note: Your config files will be untouched. New or adapted config options are not considered. Please check your configuration if required.
-
-
-## Reset configuration
-If you want to reset your configs, please rename (delete is not recommended) the conf directory and execute the init script again.
-
-
-## Customize if required
-It's recommended to build for first time without any changes on config files to get an impression how the build process is working and see the results.
-The possibilities for adjustments are very extensive and not really manageable for beginners. However, the Yoctoproject is very 
-extensively documented and provides the best source of information.
-
-The generated local.conf contains only a few lines but contains a line which is linking a common config file and is valid for all images and supported machine types. The origin cloned sample config file ("local.conf.common.inc.sample") should be untouched. This avoids possible conflicts during updating the init script from git repo. After executed init script (step 3), the config sample file was renamed from "local.conf.common.inc.sample" to "local.conf.common.inc" and this file you can feed with your own options which have effect for all images you want to build.
-Alternatively you can modify the default "$HOME/Build/poky-X.X/<machine>/conf/local.conf" with your own requirements or include your own config file. After updated init script, some new or changed options could be added or removed. This case you should consider for your own configuration.
-
-For local configuration these config files within your build directory are required:
-```
-../build/poky-X.X/<machine>/conf/bblayers.conf
-../build/poky-X.X/<machine>/conf/local.conf
-```
-
-This is the minimal required setup for bblayers.conf. 
-NOTE! machine name is not a part of layer name (e.g. hd51) 
-
-```bitbake
-# POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
-# changes incompatibly
-POKY_BBLAYERS_CONF_VERSION = "2"
-
-BBPATH = "${TOPDIR}"
-BBFILES ?= ""
-
-BBLAYERS ?= " \
-  	${HOME}/build/poky-X.X/meta \
-  	${HOME}/build/poky-X.X/meta-poky \
-  	${HOME}/build/poky-X.X/meta-yocto-bsp \
-	${HOME}/build/poky-X.X/meta-neutrino \
-	${HOME}/build/poky-X.X/poky/meta-<metaname> \
-"
-```  
-Further informations about yocto buildsystem you can find here:
-
-* https://www.yoctoproject.org/docs/latest/brief-yoctoprojectqs/brief-yoctoprojectqs.html
-* https://www.yoctoproject.org/docs/current/mega-manual/mega-manual.html
+## Localized `README.md`'s
+
+| Language                   |
+| -------------------------- |
+| [English](README-en.md)    |
+| [German](README-de.md)     |

files/0001-openembedded-disable-meta-python.patch

@@ -0,0 +1,24 @@
+From 090a04acb63ed1d7fc829fa41de9c5ee86d249c1 Mon Sep 17 00:00:00 2001
+From: Thilo Graf <dbt@novatux.de>
+Date: Sun, 24 Jul 2022 14:53:27 +0200
+Subject: [PATCH 1/2] openembedded: disable meta-python
+
+---
+ meta-multimedia/conf/layer.conf | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+
+diff --git a/meta-multimedia/conf/layer.conf b/meta-multimedia/conf/layer.conf
+index be0e2b362..eb10c6eaa 100644
+--- a/meta-multimedia/conf/layer.conf
++++ b/meta-multimedia/conf/layer.conf
+@@ -29,6 +29,6 @@ BBFILE_PRIORITY_multimedia-layer = "6"
+ # cause compatibility issues with other layers
+ LAYERVERSION_multimedia-layer = "1"
+ 
+-LAYERDEPENDS_multimedia-layer = "core meta-python"
++#LAYERDEPENDS_multimedia-layer = "core meta-python"
+ 
+ LAYERSERIES_COMPAT_multimedia-layer = "gatesgarth"
+-- 
+2.35.1
+

files/0002-openembedded-disable-openembedded-layer-meta-phyton.patch

@@ -0,0 +1,27 @@
+From eb53094f171a3833f19b20667bda236d78a44ca9 Mon Sep 17 00:00:00 2001
+From: Thilo Graf <dbt@novatux.de>
+Date: Sun, 24 Jul 2022 14:56:09 +0200
+Subject: [PATCH 2/2] openembedded: disable openembedded-layer, meta-phyton
+
+---
+ meta-networking/conf/layer.conf | 4 ++--
+ 1 file changed, 2 insertions(+), 2 deletions(-)
+
+diff --git a/meta-networking/conf/layer.conf b/meta-networking/conf/layer.conf
+index bd0a44cae..dce550fe2 100644
+--- a/meta-networking/conf/layer.conf
++++ b/meta-networking/conf/layer.conf
+@@ -14,8 +14,8 @@ BBFILE_PRIORITY_networking-layer = "5"
+ LAYERVERSION_networking-layer = "1"
+ 
+ LAYERDEPENDS_networking-layer = "core"
+-LAYERDEPENDS_networking-layer += "openembedded-layer"
+-LAYERDEPENDS_networking-layer += "meta-python"
++#LAYERDEPENDS_networking-layer += "openembedded-layer"
++#LAYERDEPENDS_networking-layer += "meta-python"
+ 
+ LAYERSERIES_COMPAT_networking-layer = "gatesgarth"
+ 
+-- 
+2.35.1
+

image_build_increment.sample

@@ -0,0 +1 @@
+0

init

@@ -0,0 +1 @@
+init.sh

init.functions.sh

@@ -0,0 +1,383 @@
+#!/bin/bash
+
+## Function to replace the echo command
+function my_echo() {
+	local no_term_output="$1"
+	# Clean up text
+	if [ "$no_term_output" == "true" ]; then
+		shift
+	fi
+    local cleaned_output=$(echo -e "${@}" | sed -r "s/\x1B\[[0-9;]*[a-zA-Z]//g")
+    # Write to log
+    echo "[ $(date '+%Y-%m-%d %H:%M:%S') ] - ${cleaned_output}" >> "$LOGFILE"
+    # Show on terminal
+    if [[ "$no_term_output" != "true" && -t 1 ]]; then
+        echo -e "${@}"
+    fi
+}
+
+# function for checking of valid machine(s)
+function is_valid_machine ()
+{
+	local ISM=$1
+	for M in $MACHINES ; do
+		if [ "$ISM" == "$M" ] || [ "$MACHINE" == "all" ]; then
+			echo true
+			return 1
+		fi
+	done
+	echo false
+	return 0
+}
+
+function do_exec() {
+    local cmd="$1"
+    local exit_behavior="$2"
+    local show_output="$3"
+    local log_text
+    local cmd_exit_status
+
+    my_echo true "[EXEC] $cmd"
+
+    # TODO: Evaluate alternatives to 'eval' for executing complex commands
+	# Using 'eval' here allows for dynamic execution of commands that may include
+	# special characters, variable expansions, or other complexities that are
+	# difficult to handle with direct execution methods. However, 'eval' comes with
+	# significant security implications, especially when dealing with untrusted input.
+	# It executes the given string as a bash command, which can lead to code injection
+	# vulnerabilities if not carefully managed. This usage is a temporary solution to
+	# achieve desired functionality and should be revisited to explore safer alternatives.
+    if [[ "$show_output" == "show_output" ]]; then
+        eval $cmd 2>> "$TMP_LOGFILE"
+    else
+        eval $cmd > /dev/null 2>> "$TMP_LOGFILE"
+    fi
+
+    cmd_exit_status=${PIPESTATUS[0]} # Get exit status of the first command in the last pipe
+
+    if [[ -f "$TMP_LOGFILE" ]]; then
+        log_text=$(cat "$TMP_LOGFILE")
+        >> "$LOGFILE" # Clear TMP_LOGFILE after reading
+    fi
+
+    if [[ $cmd_exit_status -ne 0 ]]; then
+        if [[ "$exit_behavior" != "no_exit" ]]; then
+            if [[ -n "$log_text" ]]; then
+                my_echo -e "\033[31;1mERROR:\033[0m $log_text"
+                my_echo "ERROR: $log_text" >> "$LOGFILE"
+            fi
+            exit 1
+        else
+            if [[ -n "$log_text" ]]; then
+                my_echo -e "\033[37;1mNOTE:\033[0m $log_text"
+                my_echo "NOTE: $log_text" >> "$LOGFILE"
+            fi
+        fi
+    fi
+}
+
+function get_metaname () {
+	local TMP_NAME=$1
+
+	if [ "$TMP_NAME" == "hd51" ] || [ "$TMP_NAME" == "bre2ze4k" ] || [ "$TMP_NAME" == "mutant51" ] || [ "$TMP_NAME" == "ax51" ]; then
+		META_NAME="gfutures"
+	elif [ "$TMP_NAME" == "h7" ] || [ "$TMP_NAME" == "zgemmah7" ]; then
+		META_NAME="airdigital"
+	elif [ "$TMP_NAME" == "hd60" ] || [ "$TMP_NAME" == "hd61" ] || [ "$TMP_NAME" == "ax60" ] || [ "$TMP_NAME" == "ax61" ]; then
+		META_NAME="hisilicon"
+	elif [ "$TMP_NAME" == "osmio4k" ] || [ "$TMP_NAME" == "osmio4kplus" ]; then
+		META_NAME="edision"
+    elif [ "$TMP_NAME" == "e4hdultra" ]; then
+		META_NAME="ceryon"
+	else
+		META_NAME=$TMP_NAME
+	fi
+	echo "$META_NAME"
+}
+
+# clone or update required branch for required meta-<layer>
+function fetch_meta() {
+    local layer_name="$1"
+    local branch_name="$2"
+    local layer_git_url="$3"
+    local branch_hash="$4"
+    local target_git_path="$5"
+    local patch_list="$6"
+
+    local GIT_SSH_COMMAND=""
+    if [[ "$GIT_SSH_KEYFILE" != "" ]]; then
+        export GIT_SSH_COMMAND="$SSH -i \"$GIT_SSH_KEYFILE\""
+    fi
+
+    if [[ ! -d "$target_git_path/.git" ]]; then
+		my_echo -e "Clone branch $branch_name from $layer_git_url into $target_git_path"
+		if do_exec "git clone -b "$branch_name" "$layer_git_url" "$target_git_path""; then
+			do_exec "git -C "$target_git_path" checkout "$branch_hash" -b "$IMAGE_VERSION""
+			do_exec "git -C "$target_git_path" pull -r origin "$branch_name""
+		else
+			my_echo -e "\033[31;1mError cloning $layer_name from $layer_git_url\033[0m"
+			return 1
+		fi
+		## Patching
+		if [[ -n "$patch_list" ]]; then
+			for patch_file in $patch_list; do
+				# First, check if the patch can be applied cleanly
+				my_echo -e "Applying patch: $patch_file"
+				if do_exec "git -C "$target_git_path" apply --check "$FILES_DIR/$patch_file""; then
+					# Attempt to apply the patch if 'apply --check' was successful
+					if ! do_exec "git -C "$target_git_path" am < "$FILES_DIR/$patch_file""; then
+						# Error message if 'git am' fails
+						my_echo -e "\033[31;1mFailed to apply patch $patch_file to $layer_name\033[0m"
+						return 1
+					fi
+				else
+					# Message about skipping if 'apply --check' fails
+					my_echo -e "\033[33;1mSkipping patch $patch_file already applied or cannot be applied cleanly.\033[0m"
+				fi
+			done
+		fi
+    else
+		if [[ $DO_UPDATE == "$true" ]]; then
+			my_echo -e "Update $target_git_path on branch $branch_name"
+			if [[ $(git -C "$target_git_path" stash list) ]]; then
+				my_echo -e "Stashing changes in $target_git_path"
+				do_exec "git -C "$target_git_path" stash push --include-untracked"
+				local stash_applied=true
+			fi
+			do_exec "git -C "$target_git_path" checkout "$branch_name"" || do_exec "git -C "$target_git_path" checkout -b "$branch_name""
+			do_exec "git -C "$target_git_path" pull -r origin "$branch_name""
+			if [[ "$stash_applied" == true ]]; then
+				if do_exec "git -C "$target_git_path" stash pop"; then
+					my_echo -e "Stash applied successfully."
+				else
+					my_echo -e "\033[33;1mNote: Stash could not be applied. Manual intervention required.\033[0m"
+					return 1
+				fi
+			fi
+        fi
+    fi
+
+    return 0
+}
+
+# clone/update required branch from tuxbox bsp layers
+function is_required_machine_layer ()
+{
+	local HIM1=$1
+	for M in $HIM1 ; do
+		if [ "$M" == "$MACHINE" ]; then
+			echo true
+			return 1
+		fi
+	done
+	echo false
+	return 0
+}
+
+# get matching machine type from machine build id
+function get_real_machine_type() {
+	local MACHINE_TYPE=$1
+	if  [ "$MACHINE_TYPE" == "mutant51" ] || [ "$MACHINE_TYPE" == "ax51" ] || [ "$MACHINE_TYPE" == "hd51" ]; then
+		RMT_RES="hd51"
+	elif  [ "$MACHINE_TYPE" == "hd60" ] || [ "$MACHINE_TYPE" == "ax60" ]; then
+		RMT_RES="hd60"
+	elif  [ "$MACHINE_TYPE" == "hd61" ] || [ "$MACHINE_TYPE" == "ax61" ]; then
+		RMT_RES="hd61"
+	elif  [ "$MACHINE_TYPE" == "zgemmah7" ] || [ "$MACHINE_TYPE" == "h7" ]; then
+		RMT_RES="h7"
+	else
+		RMT_RES=$MACHINE_TYPE
+	fi
+	echo $RMT_RES
+}
+
+# get matching machine build id from machine type
+function get_real_machine_id() {
+	local MACHINEBUILD=$1
+	if  [ "$MACHINEBUILD" == "hd51" ]; then
+		RMI_RES="ax51"
+	elif  [ "$MACHINEBUILD" == "hd60" ]; then
+		RMI_RES="ax60"
+	elif  [ "$MACHINEBUILD" == "hd61" ]; then
+		RMI_RES="ax61"
+	elif  [ "$MACHINEBUILD" == "h7" ]; then
+		RMI_RES="zgemmah7"
+	else
+		RMI_RES=$MACHINEBUILD
+	fi
+	echo $RMI_RES
+}
+
+# function to create file entries into a file, already existing entry will be ignored
+function set_file_entry () {
+	local FILE_NAME=$1
+	local FILE_SEARCH_ENTRY=$2
+	local FILE_NEW_ENTRY=$3
+	if test ! -f $FILE_NAME; then
+		echo $FILE_NEW_ENTRY > $FILE_NAME
+		return 1
+	else
+		OLD_CONTENT=`cat $FILE_NAME`
+		HAS_ENTRY=`grep -c -w $FILE_SEARCH_ENTRY $FILE_NAME`
+		if [ "$HAS_ENTRY" == "0" ] ; then
+			echo $FILE_NEW_ENTRY >> $FILE_NAME
+		fi
+		NEW_CONTENT=`cat $FILE_NAME`
+		if [ "$OLD_CONTENT" == "$NEW_CONTENT" ] ; then
+			return 1
+		fi
+	fi
+	return 0
+}
+
+
+# function to create configuration for box types
+function create_local_config () {
+	local machine=$1
+
+	if [ "$machine" != "all" ]; then
+
+		MACHINE_BUILD_DIR=$BUILD_ROOT/$machine
+		do_exec "mkdir -p $BUILD_ROOT"
+
+		BACKUP_CONFIG_DIR="$BACKUP_PATH/$machine/conf"
+		do_exec "mkdir -p $BACKUP_CONFIG_DIR"
+
+		LOCAL_CONFIG_FILE_PATH=$MACHINE_BUILD_DIR/conf/local.conf
+
+		if test -d $BUILD_ROOT_DIR/$machine; then
+			if test ! -L $BUILD_ROOT_DIR/$machine; then
+				# generate build/config symlinks for compatibility
+				my_echo -e "\033[37;1m\tcreate compatible symlinks directory for $machine environment ...\033[0m"
+				do_exec "mv $BUILD_ROOT_DIR/$machine $BUILD_ROOT"
+				do_exec "ln -s $MACHINE_BUILD_DIR $BUILD_ROOT_DIR/$machine"
+			fi
+		fi
+
+		# generate default config
+		if test ! -d $MACHINE_BUILD_DIR/conf; then
+			my_echo -e "\033[37;1m\tcreating build directory for $machine environment ...\033[0m"
+			do_exec "cd $BUILD_ROOT_DIR"
+			do_exec ". ./oe-init-build-env $MACHINE_BUILD_DIR"
+			# we need a clean config file
+			if test -f $LOCAL_CONFIG_FILE_PATH & test ! -f $LOCAL_CONFIG_FILE_PATH.origin; then
+				# so we save the origin local.conf
+				do_exec "mv $LOCAL_CONFIG_FILE_PATH $LOCAL_CONFIG_FILE_PATH.origin"
+			fi
+			do_exec "cd $BASEPATH"
+			echo "[Desktop Entry]" > $BUILD_ROOT/.directory
+			echo "Icon=folder-green" >> $BUILD_ROOT/.directory
+		fi
+
+		# modify or upgrade config files inside conf directory
+		LOCAL_CONFIG_FILE_INC_PATH=$BASEPATH/local.conf.common.inc
+		if test -f $LOCAL_CONFIG_FILE_INC_PATH; then
+
+			if test -f $LOCAL_CONFIG_FILE_PATH; then
+				HASHSTAMP=`MD5SUM $LOCAL_CONFIG_FILE_PATH`
+				do_exec "cp $LOCAL_CONFIG_FILE_PATH $BACKUP_CONFIG_DIR/local.conf.$HASHSTAMP.$BACKUP_SUFFIX"
+
+				# migrate settings after server switch
+				my_echo "migrate settings within $LOCAL_CONFIG_FILE_INC_PATH..."
+				do_exec "sed -i -e 's|http://archiv.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+				do_exec "sed -i -e 's|https://archiv.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+
+				do_exec "sed -i -e 's|http://archiv.tuxbox-neutrino.org/sources|https://n4k.sourceforge.io/sources|' $LOCAL_CONFIG_FILE_INC_PATH"
+				do_exec "sed -i -e 's|https://archiv.tuxbox-neutrino.org/sources|https://n4k.sourceforge.io/sources|' $LOCAL_CONFIG_FILE_INC_PATH"
+
+				do_exec "sed -i -e 's|http://sstate.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+				do_exec "sed -i -e 's|https://sstate.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+
+				do_exec "sed -i -e 's|archiv.tuxbox-neutrino.org|n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+				do_exec "sed -i -e 's|sstate.tuxbox-neutrino.org|n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_INC_PATH"
+
+				my_echo "migrate settings within $LOCAL_CONFIG_FILE_PATH"
+				do_exec "sed -i -e 's|http://archiv.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+				do_exec "sed -i -e 's|https://archiv.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+
+				do_exec "sed -i -e 's|http://archiv.tuxbox-neutrino.org/sources|https://n4k.sourceforge.io/sources|' $LOCAL_CONFIG_FILE_PATH"
+				do_exec "sed -i -e 's|https://archiv.tuxbox-neutrino.org/sources|https://n4k.sourceforge.io/sources|' $LOCAL_CONFIG_FILE_PATH"
+
+				do_exec "sed -i -e 's|http://sstate.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+				do_exec "sed -i -e 's|https://sstate.tuxbox-neutrino.org|https://n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+
+				do_exec "sed -i -e 's|archiv.tuxbox-neutrino.org|n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+				do_exec "sed -i -e 's|sstate.tuxbox-neutrino.org|n4k.sourceforge.io|' $LOCAL_CONFIG_FILE_PATH"
+
+				search_line="#UPDATE_SERVER_URL = \"http:\/\/@hostname@\""
+				add_line="UPDATE_SERVER_URL = \"http://$HTTP_ADDRESS\""
+				if ! grep -qF -- "$add_line" "$LOCAL_CONFIG_FILE_INC_PATH"; then
+					# Wenn nicht, füge die neue Zeile nach der spezifischen Zeile ein
+					sed -i -e "/$search_line/a $add_line" "$LOCAL_CONFIG_FILE_INC_PATH"
+				fi
+			fi
+
+			# add init note
+			set_file_entry $LOCAL_CONFIG_FILE_PATH "generated" "# auto generated entries by init script"
+
+			# add line 1, include for local.conf.common.inc
+			set_file_entry $LOCAL_CONFIG_FILE_PATH "$BASEPATH/local.conf.common.inc" "include $BASEPATH/local.conf.common.inc"
+
+			# add line 2, machine type
+			M_TYPE='MACHINE = "'`get_real_machine_type $machine`'"'
+			if set_file_entry $LOCAL_CONFIG_FILE_PATH "MACHINE" "$M_TYPE" == 1; then
+				my_echo -e "\t\033[37;1m$LOCAL_CONFIG_FILE_PATH has been upgraded with entry: $M_TYPE \033[0m"
+			fi
+
+			# add line 3, machine build
+			M_ID='MACHINEBUILD = "'`get_real_machine_id $machine`'"'
+			if set_file_entry $LOCAL_CONFIG_FILE_PATH "MACHINEBUILD" "$M_ID" == 1; then
+				my_echo -e "\t\033[37;1m$LOCAL_CONFIG_FILE_PATH has been upgraded with entry: $M_ID \033[0m"
+			fi
+		else
+			my_echo -e "\033[31;1mERROR:\033[0m:\ttemplate $BASEPATH/local.conf.common.inc not found..."
+			exit 1
+		fi
+
+		BBLAYER_CONF_FILE="$MACHINE_BUILD_DIR/conf/bblayers.conf"
+
+		# craete backup for bblayer.conf
+		if test -f $BBLAYER_CONF_FILE; then
+			HASHSTAMP=`MD5SUM $BBLAYER_CONF_FILE`
+			do_exec "cp $BBLAYER_CONF_FILE $BACKUP_CONFIG_DIR/bblayer.conf.$HASHSTAMP.$BACKUP_SUFFIX"
+		fi
+
+		META_MACHINE_LAYER=meta-`get_metaname $machine`
+
+		# add layer entries into bblayer.conf
+		set_file_entry $BBLAYER_CONF_FILE "generated" '# auto generated entries by init script'
+		LAYER_LIST=" $TUXBOX_LAYER_NAME $META_MACHINE_LAYER $OE_LAYER_NAME/meta-oe $OE_LAYER_NAME/meta-networking $PYTHON2_LAYER_NAME $QT5_LAYER_NAME "
+		for LL in $LAYER_LIST ; do
+			if set_file_entry $BBLAYER_CONF_FILE $LL 'BBLAYERS += " '$BUILD_ROOT_DIR'/'$LL' "' == 1;then
+				my_echo -e "\t\033[37;1m$BBLAYER_CONF_FILE has been upgraded with entry: $LL... \033[0m"
+			fi
+		done
+	fi
+}
+
+# function create local dist directory to prepare for web access
+function create_dist_tree () {
+
+	# create dist dir
+	DIST_BASEDIR="$BASEPATH/dist/$IMAGE_VERSION"
+	if test ! -d "$DIST_BASEDIR"; then
+		my_echo -e "\033[37;1mcreate dist directory:\033[0m   $DIST_BASEDIR"
+		do_exec "mkdir -p $DIST_BASEDIR"
+	fi
+
+	# create link sources
+	DIST_LIST=`ls $BUILD_ROOT`
+	for DL in  $DIST_LIST ; do
+		DEPLOY_DIR="$BUILD_ROOT/$DL/tmp/deploy"
+		do_exec "ln -sf $DEPLOY_DIR $DIST_BASEDIR/$DL"
+		if test -L "$DIST_BASEDIR/$DL/deploy"; then
+			do_exec "unlink -v $DIST_BASEDIR/$DL/deploy"
+		fi
+	done
+}
+
+function MD5SUM () {
+	local MD5SUM_FILE=$1
+	MD5STAMP=`md5sum $MD5SUM_FILE |cut -f 1 -d " "`
+	echo $MD5STAMP
+}

init.sh

@@ -1,420 +1,335 @@
 #!/bin/bash
-
+source init.functions.sh
 #set -x
 
-BASEPATH=`pwd`
-FILES_DIR=$BASEPATH/files
-MACHINES="h7 hd51 hd60 hd61 osmio4k osmio4kplus"
-HINT_SYNTAX='Usage '$0' <machine> <image-version>'
-HINT_MACHINES="<$MACHINES all>"
-HINT_IMAGE_VERSIONS='<3.2> <3.1> <3.0>'
- 
+## Comatible image version
+IMAGE_VERSION="3.2.4"
+
+## global vars
+BASEPATH=$(pwd)
+SSH=$(which ssh)
+GIT_SSH_KEYFILE=""
+true="1"
+false="0"
+DO_UPDATE=$false
+FILES_DIR="$BASEPATH/files"
+HTTPD_DIST_HOSTNAME="localhost"
+HTTPD_DIST_DIR="/var/www/html/dist"
+USER_CALL="$0 $@"
+
+## Basename of this script
+NAME=$(basename $0)
+
+## Timestamp for logging
+TIMESTAMP=$(date '+%Y%m%d_%H%M%S')
+## Logfile
 LOG_PATH=$BASEPATH/log
 mkdir -p $LOG_PATH
-LOGFILE_NAME="$0_`date '+%Y%m%d_%H%M%S'`.log"
-LOGFILE=$LOG_PATH/$LOGFILE_NAME
-TMP_LOGFILE=$LOG_PATH/.tmp.log
-touch $LOGFILE
-
-LOGFILE_LINK=$BASEPATH/$0.log
-
+TMP_LOGFILE="$LOG_PATH/.$0-tmp.log"
 rm -f $TMP_LOGFILE
-rm -f $LOGFILE_LINK
+LOGFILE_NAME="$NAME"_"$TIMESTAMP.log"
+LOGFILE=$LOG_PATH/$LOGFILE_NAME
+LOGFILE_LINK=$LOG_PATH/$NAME.log
+echo "" >  $LOGFILE
 ln -sf $LOGFILE $LOGFILE_LINK
+my_echo "true" "$USER_CALL"
 
-
-# set passed parameters
-if [ "$1" = "" ]; then
-	MACHINE="all"
-else
-	MACHINE=$1
+## Current build env script version
+VERSION=$(git -C $BASEPATH describe --tags 2>/dev/null)
+if [ -z "$VERSION" ]; then
+	VERSION="$IMAGE_VERSION"
 fi
+INIT_VERSION="$NAME $VERSION"
 
-if [ "$2" = "" ]; then
-	IMAGE_VERSION="3.2"
-else
-	IMAGE_VERSION=$2
-fi
+## Preset required branches and revs
+COMPATIBLE_BRANCH="gatesgarth"
+COMPATIBLE_TAG="$IMAGE_VERSION"
+YOCTO_SRCREV="bc71ec0"
+PYTHON2_SRCREV="27d2aeb"
+OE_SRCREV="f3f7a5f"
 
-# check for empty machine
-if [ -z "$MACHINE" ]; then
-    echo -e "\033[31;1mERROR:\tNo machine defined. Possible machines are $HINT_MACHINES. $HINT_SYNTAX ...\033[0m"
-    exit 1
-fi
 
-# check for valid machine
-if [ "$MACHINE" != "hd51" ] && [ "$MACHINE" != "h7" ] && [ "$MACHINE" != "hd60" ] && [ "$MACHINE" != "hd61" ] && [ "$MACHINE" != "osmio4k" ] && [ "$MACHINE" != "osmio4kplus" ] && [ "$MACHINE" != "all" ]; then
-    echo -e "\033[31;1mERROR:\tInvalid machine defined. $HINT_SYNTAX. Possible machines are $HINT_MACHINES\033[0m"
-    exit 1
-fi
+## Machines
+# Identical listings
+MACHINES_IDENTICAL_HD51="hd51 ax51 mutant51"
+MACHINES_IDENTICAL_H7="h7 zgemmah7"
+MACHINES_IDENTICAL_HD60="hd60 ax60" #TODO: move into gfutures
+MACHINES_IDENTICAL_HD61="hd61 ax61" #TODO: move into gfutures
 
-# check for image versions
-if [ "$IMAGE_VERSION" != "3.2" ] && [ "$IMAGE_VERSION" != "3.1" ] && [ "$IMAGE_VERSION" != "3.0" ]; then
-    echo -e "\033[31;1mERROR:\tInvalid image version defined. $HINT_SYNTAX. Possible image versions are $HINT_IMAGE_VERSIONS, keep empty for current version\033[0m"
-    exit 1    
-fi
+# gfutures listing
+MACHINES_GFUTURES="$MACHINES_IDENTICAL_HD51 bre2ze4k"
+# hisilcon listing  #TODO: move into gfutures
+MACHINES_HISI="$MACHINES_IDENTICAL_HD60 $MACHINES_IDENTICAL_HD61"
+# airdigital listing
+MACHINES_AIRDIGITAL="$MACHINES_IDENTICAL_H7"
+# edision listing
+MACHINES_EDISION="osmio4k osmio4kplus"
+# ceryon listing
+MACHINES_CERYON="e4hdultra"
 
-echo -e "\033[37;1mNOTE:\tInitialze build environment for image version $IMAGE_VERSION and machine: $MACHINE \033[0m\n"
+# valid machine list
+MACHINES="$MACHINES_GFUTURES $MACHINES_HISI $MACHINES_AIRDIGITAL $MACHINES_EDISION $MACHINES_CERYON"
 
-function do_exec() {
-	DEX_ARG1=$1
-	DEX_ARG2=$2
-	DEX_ARG3=$3
-	rm -f $TMP_LOGFILE
-	if [ "$DEX_ARG3" == "show_output" ]; then
-		$DEX_ARG1
-	else
-		$DEX_ARG1 > /dev/null 2>> $TMP_LOGFILE
-	fi
-#	echo -e "DEX_ARG1 [$DEX_ARG1] DEX_ARG2 [$DEX_ARG2] DEX_ARG3 [$DEX_ARG3]"
-	if [ $? != 0 ]; then
-		LOGTEXT=`cat $TMP_LOGFILE`
-		echo "$LOGTEXT" >> $LOGFILE
-		if [ "$DEX_ARG2" != "no_exit" ]; then
-			if [ "$LOGTEXT" != "" ]; then
-				echo -e "\033[31;1mERROR:\t\033[0m $LOGTEXT"
-			fi
-			exit 1
-		else
-			if [ "$LOGTEXT" != "" ]; then
-				echo -e "\033[37;1mNOTE:\t\033[0m $LOGTEXT"
- 			fi
-		fi
-	fi
-# 	if [ $DEX_ARG2 == "no_exit" ]; then
-# 		echo -e "\033[32;1mOK:\033[0m `cat $LOGFILE`"
-# 	fi
-}
-
-POKY_NAME=poky-$IMAGE_VERSION
-BUILD_ROOT_DIR=$BASEPATH/$POKY_NAME
-GUI_LAYER_NAME=meta-neutrino
+MACHINE="all" # default for MACHINE, if not set
+HINT_MACHINES="Select a valid machine type (empty means <all> as default) <$MACHINES>"
+ 
+## Backups
+BACKUP_PATH=$BASEPATH/backups
+mkdir -p $BACKUP_PATH
 BACKUP_SUFFIX=bak
 
-YOCTO_GIT_URL=https://git.yoctoproject.org/git/poky
-TUXBOX_LAYER_GIT_URL=https://github.com/neutrino-hd
+## Layer sources
+YOCTO_GIT_URL="https://git.yoctoproject.org/git/poky"
+POKY="poky"
+POKY_NAME="$IMAGE_VERSION"
+BUILD_ROOT_DIR="$BASEPATH/$POKY-$IMAGE_VERSION"
+BUILD_ROOT="$BUILD_ROOT_DIR/build"
 
-PYTHON2_LAYER_NAME=meta-python2
-PYTHON2_LAYER_GIT_URL=https://git.openembedded.org
-PYTHON2_LAYER_DO_UPDATE=1
+OE_LAYER_NAME=meta-openembedded
+OE_LAYER_GIT_URL=https://git.openembedded.org/meta-openembedded
+OE_LAYER_PATCH_LIST="0001-openembedded-disable-meta-python.patch 0002-openembedded-disable-openembedded-layer-meta-phyton.patch"
 
-GIT_CLONE='git clone'
-GIT_PULL='git pull -r'
-GIT_STASH='git stash'
-GIT_STASH_POP='git stash pop'
+OE_CORE_LAYER_NAME=openembedded-core
+OE_CORE_LAYER_GIT_URL=https://github.com/openembedded/openembedded-core.git
 
+# meta-neutrino project URL:
+PROJECT_URL="https://github.com/tuxbox-neutrino"
 
-# set required branch
-YOCTO_BRANCH_NAME=""
-if [ "$IMAGE_VERSION" = "3.0" ]; then
-	YOCTO_BRANCH_NAME=zeus
-	YOCTO_BRANCH_HASH=d88d62c
-elif [ "$IMAGE_VERSION" = "3.1" ]; then
-	YOCTO_BRANCH_NAME=dunfell
-	YOCTO_BRANCH_HASH=2181825
-elif [ "$IMAGE_VERSION" = "3.2" ]; then
-	YOCTO_BRANCH_NAME=gatesgarth
-	YOCTO_BRANCH_HASH=4e4a302
-	PYTHON2_BRANCH_HASH=27d2aeb
-fi
-
-# clone required branch from yocto
-if test ! -d $BUILD_ROOT_DIR/.git; then
-	echo -e "\033[36;1mCLONE POKY:\033[0m\nclone branch $YOCTO_BRANCH_NAME from $YOCTO_GIT_URL into $BUILD_ROOT_DIR..."
-	do_exec "$GIT_CLONE -b $YOCTO_BRANCH_NAME $YOCTO_GIT_URL $POKY_NAME" ' ' 'show_output'
-	do_exec "cd $BUILD_ROOT_DIR"
-	do_exec "git checkout $YOCTO_BRANCH_HASH -b $IMAGE_VERSION"
-	do_exec "git tag $IMAGE_VERSION"
-	do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-	echo -e "\033[36;1mdone ...\033[0m\n"
-else
-	do_exec "cd $BUILD_ROOT_DIR"
-	CURRENT_YOCTO_BRANCH=`git -C $BUILD_ROOT_DIR rev-parse --abbrev-ref HEAD`
-
-	echo -e "\033[36;1mUPDATE poky:\033[0m\nupdate $CURRENT_YOCTO_BRANCH..."
-
-	echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch from $CURRENT_YOCTO_BRANCH to $IMAGE_VERSION..."
-	do_exec "git checkout $IMAGE_VERSION"
-
-	echo -e "\033[37;1mUPDATE:\033[0m\nupdate $POKY_NAME from (branch $YOCTO_BRANCH_NAME) $YOCTO_GIT_URL ..."
-	do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-
-	echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch back to $YOCTO_BRANCH_NAME ..."
-	do_exec "git checkout $YOCTO_BRANCH_NAME"
-	do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-
-	echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch back to $IMAGE_VERSION ..."
-	do_exec "git checkout $IMAGE_VERSION"
-
-	echo -e "\033[36;1mdone ...\033[0m\n"
-fi
-
-
-# clone or update required branch from gui meta layer
-if test ! -d $BUILD_ROOT_DIR/$GUI_LAYER_NAME/.git; then
-	echo -e "\033[33;1mCLONE $GUI_LAYER_NAME:\033[0m\nclone $GUI_LAYER_NAME (branch $YOCTO_BRANCH_NAME) from $TUXBOX_LAYER_GIT_URL ..."
-	do_exec "cd $BUILD_ROOT_DIR"
-	do_exec "$GIT_CLONE -b $YOCTO_BRANCH_NAME $TUXBOX_LAYER_GIT_URL/$GUI_LAYER_NAME.git $GUI_LAYER_NAME" ' ' 'show_output'
-	echo -e "\033[33;1mdone ...\033[0m\n"
-else
-	do_exec "cd $BUILD_ROOT_DIR/$GUI_LAYER_NAME"
-	CURRENT_GUI_LAYER_BRANCH=`git -C $BUILD_ROOT_DIR/$GUI_LAYER_NAME rev-parse --abbrev-ref HEAD`
-	echo -e "\033[33;1mUPDATE: update $GUI_LAYER_NAME $CURRENT_GUI_LAYER_BRANCH\033[0m"
-	do_exec "$GIT_STASH" 'no_exit'
-
-	if [ "$CURRENT_GUI_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-		echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch from $CURRENT_GUI_LAYER_BRANCH to $YOCTO_BRANCH_NAME..."
-		do_exec "git checkout  $YOCTO_BRANCH_NAME"
-	fi
-
-	#echo -e "\033[37;1mUPDATE:\033[0m\nupdate $GUI_LAYER_NAME from (branch $YOCTO_BRANCH_NAME) $TUXBOX_LAYER_GIT_URL ..."
-	do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-
-	if [ "$CURRENT_GUI_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-		echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch back to $CURRENT_GUI_LAYER_BRANCH ..."
-		do_exec "git checkout  $CURRENT_GUI_LAYER_BRANCH"
-		echo -e "\033[37;1mREBASE:\033[0m\nrebase branch $YOCTO_BRANCH_NAME into $CURRENT_GUI_LAYER_BRANCH"
-		do_exec "git rebase  $YOCTO_BRANCH_NAME" ' ' 'show_output'
-	fi
-
-	do_exec "$GIT_STASH_POP" 'no_exit'
-	echo -e "\033[33;1mdone ...\033[0m\n"
-fi
-
-
-# clone or update required branch for python2 from https://git.openembedded.org/meta-python2
-function clone_meta_python2 () {
-	META_MACHINE_LAYER=meta-$1
-
-	if [ $PYTHON2_LAYER_DO_UPDATE == "1" ] && [ "$IMAGE_VERSION" != "3.0" ] && [ "$IMAGE_VERSION" != "3.1" ] && test -d $BUILD_ROOT_DIR/$META_MACHINE_LAYER/recipes-multimedia/kodi; then
-
-		$CURRENT_PYTHON_LAYER_BRANCH
-
-		if test ! -d $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME/.git; then
-			echo -e "\033[35;1mCLONE $PYTHON2_LAYER_NAME:\033[0m\nclone $PYTHON2_LAYER_NAME (branch $YOCTO_BRANCH_NAME) from $PYTHON2_LAYER_GIT_URL ..."
-			do_exec "cd $BUILD_ROOT_DIR"
-			do_exec "$GIT_CLONE -b $YOCTO_BRANCH_NAME $PYTHON2_LAYER_GIT_URL/$PYTHON2_LAYER_NAME $PYTHON2_LAYER_NAME" ' ' 'show_output'
-			do_exec "git -C $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME checkout $PYTHON2_BRANCH_HASH -b $IMAGE_VERSION"
-			do_exec "git -C $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME am $FILES_DIR/0001-local_conf_outcomment_line_15.patch" ' ' 'show_output'
-			do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-			echo -e "\033[35;1mdone ...\033[0m\n"
-		else
-			do_exec "cd $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME"
-			CURRENT_PYTHON_LAYER_BRANCH=`git -C $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME rev-parse --abbrev-ref HEAD`
-			echo -e "\033[35;1mUPDATE: update $PYTHON2_LAYER_NAME $CURRENT_PYTHON_LAYER_BRANCH\033[0m"
-			do_exec "$GIT_STASH" 'no_exit'
-
-			if [ "$CURRENT_PYTHON_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-				echo -e "\033[35;1mCHECKOUT:\033[0m\nswitch from $CURRENT_PYTHON_LAYER_BRANCH to $YOCTO_BRANCH_NAME..."
-				do_exec "git checkout  $YOCTO_BRANCH_NAME"
-			fi
-
-			#echo -e "\033[35;1mUPDATE:\033[0m\nupdate $PYTHON2_LAYER_NAME from (branch $YOCTO_BRANCH_NAME) $PYTHON2_LAYER_GIT_URL ..."
-			do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-
-			if [ "$CURRENT_PYTHON_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-				echo -e "\033[35;1mCHECKOUT:\033[0m\nswitch back to $CURRENT_PYTHON_LAYER_BRANCH ..."
-				do_exec "git checkout  $CURRENT_PYTHON_LAYER_BRANCH"
-				echo -e "\033[35;1mREBASE:\033[0m\nrebase branch $YOCTO_BRANCH_NAME into $CURRENT_PYTHON_LAYER_BRANCH"
-				do_exec "git rebase  $YOCTO_BRANCH_NAME" ' ' 'show_output'
-			fi
-
-			do_exec "$GIT_STASH_POP" 'no_exit'
-			echo -e "\033[35;1mdone ...\033[0m\n"
-			PYTHON2_LAYER_DO_UPDATE=0
-		fi
-	fi
-}
-
-function get_metaname () {
-	TMP_NAME=$1
-
-	if [ "$TMP_NAME" == "hd51" ]; then
-		META_NAME="hd51"
-	elif [ "$TMP_NAME" == "h7" ]; then
-		META_NAME="zgemma"
-	elif [ "$TMP_NAME" == "hd60" ] || [ "$TMP_NAME" == "hd61" ]; then
-		META_NAME="hisilicon"
-	elif [ "$TMP_NAME" == "osmio4k" ] || [ "$TMP_NAME" == "osmio4kplus" ]; then
-		META_NAME="edision"
+## Help
+show_help() {
+	if [[ $LANG == de_* ]]; then
+        echo "Dieses Skript initialisiert und aktualisiert die Entwicklungsumgebung für den Bau von Images und Paketen für verschiedene Maschinenkonfigurationen."
+        echo "Es klont und aktualisiert Meta-Layer aus vorgegebenen Repositories, bereitet die Build-Umgebung vor und unterstützt die Konfiguration für spezifische Maschinentypen."
 	else
-		META_NAME=$TMP_NAME
+        echo "This script initializes and updates the development environment for building images and packages for various machine configurations."
+        echo "It clones and updates meta-layers from specified repositories, prepares the build environment, and supports configuration for specific machine types."
 	fi
-	echo "$META_NAME"
+	echo ""
+    echo "Usage: $0 [OPTIONS]..."
+    echo ""
+    echo "Options:"
+    echo "  -m, --machine             $HINT_MACHINES"
+    echo "      --httpd-dist-hostname IP or hostname (optional with portname) to define the update server address for local.conf.common.inc, default: $HTTPD_DIST_HOSTNAME"
+    echo "      --httpd-dist-dir      Directory where the local httpd server find the deployed images and packages, default: $HTTPD_DIST_DIR"
+    echo "  -p, --project-url         Project-URL where to find project meta layers,"
+    echo "                            e.g. for read and write access: git@github.com:tuxbox-neutrino, default = $PROJECT_URL"
+    echo "  -u, --update              Update your project meta layers"
+    echo "  -i, --id-rsa-file         Path to your preferred id rsa file, default: users id rsa file, e.g. $HOME/.ssh/id_rsa"
+    echo ""
+    echo "  -h, --help                Show this help"
+    echo "  --version                 Show version information"
 }
 
-# function for clone or update required branch(es) from machine meta layer
-function clone_box_layer () {
-	NAME=`get_metaname $1`
-	
-	if [ "$NAME" != "all" ]; then
-		if test ! -d $BUILD_ROOT_DIR/meta-$NAME/.git; then
-			echo -e "\033[34;1mCLONE: clone meta-$NAME (branch $YOCTO_BRANCH_NAME) from $TUXBOX_LAYER_GIT_URL ...\033[0m"
-			do_exec "cd $BUILD_ROOT_DIR"
-			do_exec "$GIT_CLONE -b $YOCTO_BRANCH_NAME $TUXBOX_LAYER_GIT_URL/meta-$NAME.git" ' ' 'show_output'
-			echo -e "\033[34;1mdone ...\033[0m\n"
-
-			if test ! -d $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME; then
-				clone_meta_python2 $NAME
-			fi
-		else
-			do_exec "cd $BUILD_ROOT_DIR/meta-$NAME"
-			do_exec "$GIT_STASH" 'no_exit'
-
-			CURRENT_MACHINE_LAYER_BRANCH=`git -C $BUILD_ROOT_DIR/meta-$NAME rev-parse --abbrev-ref HEAD`
-			if [ "$CURRENT_MACHINE_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-				echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch from $CURRENT_MACHINE_LAYER_BRANCH to $YOCTO_BRANCH_NAME..."
-				do_exec "git checkout  $YOCTO_BRANCH_NAME"
-			fi
-
-			echo -e "\033[34;1mUPDATE: update meta-$NAME (branch $YOCTO_BRANCH_NAME) from $TUXBOX_LAYER_GIT_URL ...\033[0m"
-			do_exec "$GIT_PULL origin $YOCTO_BRANCH_NAME" ' ' 'show_output'
-
-			if [ "$CURRENT_MACHINE_LAYER_BRANCH" != "$YOCTO_BRANCH_NAME" ]; then
-				echo -e "\033[37;1mCHECKOUT:\033[0m\nswitch back  to $CURRENT_MACHINE_LAYER_BRANCH ..."
-				do_exec "git checkout  $CURRENT_MACHINE_LAYER_BRANCH"
-				echo -e "\033[37;1mREBASE:\033[0m\nrebase branch $YOCTO_BRANCH_NAME into $CURRENT_MACHINE_LAYER_BRANCH"
-				do_exec "git rebase  $YOCTO_BRANCH_NAME" ' ' 'show_output'
-			fi
-
-			do_exec "$GIT_STASH_POP" 'no_exit'
-			echo -e "\033[34;1mdone ...\033[0m\n"
-
-			clone_meta_python2 $NAME
-		fi
-	fi
-}
-
-# clone or update meta layers
-if [ "$MACHINE" == "all" ]; then
-	for M in  $MACHINES ; do
-		clone_box_layer $M;
-	done
-else
-	clone_box_layer $MACHINE;
+## Processing command line arguments
+TEMP=$(getopt -o up:m:i:h --long httpd-dist-hostname:,httpd-dist-dir:,update,project-url:,machine:,id-rsa-file,help,version -n 'init' -- "$@")
+if [ $? != 0 ] ; then
+	my_echo "Error while process arguments" >&2
+	show_help
+	exit 1
 fi
 
+# Note the quotes around `$TEMP`: they are essential!
+eval set -- "$TEMP"
 
-# create included config file from sample file
+# Extract arguments.
+while true ; do
+    case "$1" in
+        -p|--project-url)
+            PROJECT_URL="$2"; shift 2 ;;
+        -m|--machine)
+            MACHINE="$2"; shift 2 ;;
+		-i|--id-rsa-file)
+            GIT_SSH_KEYFILE="$2"; shift 2 ;;
+		   --httpd-dist-hostname)
+            HTTPD_DIST_HOSTNAME="$2"; shift 2 ;;
+		   --httpd-dist-dir)
+            HTTPD_DIST_DIR="$2"; shift 2 ;;
+		-u|--update)
+			DO_UPDATE="$true"; shift ;;
+        -h|--help)
+            show_help
+            exit 0 ;;
+		  --version)
+		    echo "$INIT_VERSION"
+		    exit 0 ;;
+        --) shift ; break ;;
+        *) echo "Internal Error!" ; exit 1 ;;
+    esac
+done
+
+# Check machine type
+if [ $(is_valid_machine "$MACHINE") == false ]; then
+    my_echo "\033[31;1mNo valid machine defined.\033[0m"
+    my_echo "$HINT_MACHINES"
+    exit 1
+fi
+
+my_echo "------------------------------------------------------------------------------------------"
+my_echo "Buildenv Version:          \033[37;1m$INIT_VERSION\033[0m "
+my_echo "Image Version:             \033[37;1m$IMAGE_VERSION\033[0m "
+my_echo "Compatible OE-branch:      \033[37;1m$COMPATIBLE_BRANCH\033[0m "
+my_echo "httpd Dist hostname:       \033[37;1m$HTTPD_DIST_HOSTNAME\033[0m "
+my_echo "httpd Dist directory:      \033[37;1m$HTTPD_DIST_DIR\033[0m "
+my_echo "Machine:                   \033[37;1m$MACHINE\033[0m "
+my_echo "Project Repository URL:    \033[37;1m$PROJECT_URL\033[0m "
+my_echo "SRCREV Yocto:              \033[37;1m$YOCTO_SRCREV\033[0m "
+my_echo "SRCREV OE:                 \033[37;1m$OE_SRCREV\033[0m "
+my_echo "SRCREV Python2:            \033[37;1m$PYTHON2_SRCREV\033[0m "
+my_echo "------------------------------------------------------------------------------------------"
+
+## Fetch meta sources
+# fetch required branch from yocto
+fetch_meta "" $COMPATIBLE_BRANCH $YOCTO_GIT_URL $YOCTO_SRCREV $BUILD_ROOT_DIR
+
+# fetch required branch from openembedded
+fetch_meta "" $COMPATIBLE_BRANCH $OE_LAYER_GIT_URL $OE_SRCREV $BUILD_ROOT_DIR/$OE_LAYER_NAME "$OE_LAYER_PATCH_LIST"
+
+# fetch required branch of oe-core from openembedded
+fetch_meta "" master $OE_CORE_LAYER_GIT_URL "" $BUILD_ROOT_DIR/$OE_CORE_LAYER_NAME
+
+# fetch required branch for meta-python2
+PYTHON2_LAYER_NAME=meta-python2
+PYTHON2_LAYER_GIT_URL=https://git.openembedded.org/$PYTHON2_LAYER_NAME
+PYTHON2_PATCH_LIST="0001-local_conf_outcomment_line_15.patch"
+fetch_meta "" $COMPATIBLE_BRANCH $PYTHON2_LAYER_GIT_URL $PYTHON2_SRCREV $BUILD_ROOT_DIR/$PYTHON2_LAYER_NAME "$PYTHON2_PATCH_LIST"
+
+# fetch required branch for meta-qt5
+QT5_LAYER_NAME=meta-qt5
+QT5_LAYER_GIT_URL=https://github.com/meta-qt5/$QT5_LAYER_NAME
+fetch_meta "" $COMPATIBLE_BRANCH $QT5_LAYER_GIT_URL "" $BUILD_ROOT_DIR/$QT5_LAYER_NAME
+
+# fetch required branch from meta-neutrino
+TUXBOX_LAYER_NAME="meta-neutrino"
+TUXBOX_LAYER_BRANCH="master"
+TUXBOX_LAYER_SRCREV="ffc1b65ec3cfd2c6bbd339d3ce201d6b39abd527"
+TUXBOX_LAYER_GIT_URL="${PROJECT_URL}/$TUXBOX_LAYER_NAME.git"
+fetch_meta "" $TUXBOX_LAYER_BRANCH $TUXBOX_LAYER_GIT_URL "$TUXBOX_LAYER_SRCREV" $BUILD_ROOT_DIR/$TUXBOX_LAYER_NAME
+safe_dir="$BUILD_ROOT_DIR/$TUXBOX_LAYER_NAME"
+if ! git config --global --get safe.directory | grep -qxF "$safe_dir"; then
+	do_exec "git config --global --add safe.directory \"$safe_dir\""
+fi
+
+# fetch required branch from meta-airdigital
+AIRDIGITAL_LAYER_NAME="meta-airdigital"
+AIRDIGITAL_LAYER_BRANCH="master"
+AIRDIGITAL_LAYER_SRCREV="ac8f769e35f839bbcf9c38d2b2b98513be907ac1"
+AIRDIGITAL_LAYER_GIT_URL="$PROJECT_URL/$AIRDIGITAL_LAYER_NAME.git"
+if [ "$MACHINE" == "all" ] || [ $(is_required_machine_layer "' $MACHINES_AIRDIGITAL '") == true ]; then
+	fetch_meta "" $AIRDIGITAL_LAYER_BRANCH $AIRDIGITAL_LAYER_GIT_URL "$AIRDIGITAL_LAYER_SRCREV" $BUILD_ROOT_DIR/$AIRDIGITAL_LAYER_NAME
+fi
+
+# fetch required branch from meta-gfutures
+GFUTURES_LAYER_NAME=meta-gfutures
+GFUTURES_LAYER_BRANCH="master"
+GFUTURES_LAYER_SRCREV="bfceb9d2f79a8403ce1bdf1ad14a1714f781fed3"
+GFUTURES_LAYER_GIT_URL="$PROJECT_URL/$GFUTURES_LAYER_NAME.git"
+if [ "$MACHINE" == "all" ] || [ $(is_required_machine_layer "' $MACHINES_GFUTURES '") == true ]; then
+	# gfutures
+	fetch_meta "" $GFUTURES_LAYER_BRANCH $GFUTURES_LAYER_GIT_URL "$GFUTURES_LAYER_SRCREV" $BUILD_ROOT_DIR/$GFUTURES_LAYER_NAME
+fi
+
+# fetch required branch from meta-ceryon
+CERYON_LAYER_NAME=meta-ceryon
+CERYON_LAYER_BRANCH="master"
+CERYON_LAYER_SRCREV="4a02145fc4c233b64f6110d166c46b59ebe73371"
+CERYON_LAYER_GIT_URL="$PROJECT_URL/$CERYON_LAYER_NAME.git"
+if [ "$MACHINE" == "all" ] || [ $(is_required_machine_layer "' $MACHINES_CERYON '") == true ]; then
+	fetch_meta "" $CERYON_LAYER_BRANCH $CERYON_LAYER_GIT_URL "$CERYON_LAYER_SRCREV" $BUILD_ROOT_DIR/$CERYON_LAYER_NAME
+fi
+
+# fetch required branch from meta-hisilicon #TODO: move into gfutures
+HISI_LAYER_NAME=meta-hisilicon  #TODO: move into gfutures
+HISI_LAYER_BRANCH="master"
+HISI_LAYER_SRCREV="e85e1781704d96f5dfa0c554cf81d24c147d888c"
+HISI_LAYER_GIT_URL="$PROJECT_URL/$HISI_LAYER_NAME.git"
+if [ "$MACHINE" == "all" ] || [ $(is_required_machine_layer "' $MACHINES_HISI '") == true; then
+	fetch_meta "" $HISI_LAYER_BRANCH $HISI_LAYER_GIT_URL "$HISI_LAYER_SRCREV" $BUILD_ROOT_DIR/$HISI_LAYER_NAME
+fi
+
+# fetch required branch from meta-edision
+EDISION_LAYER_NAME=meta-edision
+EDISION_LAYER_BRANCH="master"
+EDISION_LAYER_SRCREV="1b2c422d9218e86ca1cd9d20431d42e716b1d714"
+EDISION_LAYER_GIT_URL="$PROJECT_URL/$EDISION_LAYER_NAME.git"
+if [ "$MACHINE" == "all" ] || [ $(is_required_machine_layer "' $MACHINES_EDISION '") == true ]; then
+	fetch_meta '' $EDISION_LAYER_BRANCH $EDISION_LAYER_GIT_URL "$EDISION_LAYER_SRCREV" $BUILD_ROOT_DIR/$EDISION_LAYER_NAME
+fi
+
+## Configure buildsystem
+# Create included config file from sample file
 if test ! -f $BASEPATH/local.conf.common.inc; then
-	echo -e "\033[37;1mCONFIG:\033[0m\tcreate $BASEPATH/local.conf.common.inc as include file for layer configuration ..."
+	my_echo "\033[37;1mCONFIG:\033[0mCreate $BASEPATH/local.conf.common.inc as include file for local layer configuration ..."
 	do_exec "cp -v $BASEPATH/local.conf.common.inc.sample $BASEPATH/local.conf.common.inc"
-else
-	echo -e "\033[37;1mNOTE:\t Local configuration not considered\033[0m"
-	echo -e "\t##########################################################################################"
-	echo -e "\t# $BASEPATH/local.conf.common.inc already exists.				 #"
-	echo -e "\t# Nothing was changed on this file for your configuration.				 #"
-	echo -e "\t# Possible changes at sample configuration will be ignored.				 #"
-	echo -e "\t# You should check local configuration and modify your configuration if required.	 #"
-	echo -e "\t# \033[37;1m$BASEPATH/local.conf.common.inc\033[0m						 #"
-	echo -e "\t##########################################################################################"
 fi
 
-
-# function to create configuration for box types
-function create_local_config () {
-	CLC_ARG1=$1
-	if [ "$CLC_ARG1" != "all" ]; then
-		BOX_BUILD_DIR=$BUILD_ROOT_DIR/$CLC_ARG1
-		
-		# generate default config
-		if test ! -d $BOX_BUILD_DIR/conf; then
-			echo -e "\033[37;1m\tcreate directory for $CLC_ARG1 environment ...\033[0m"
-			do_exec "cd $BUILD_ROOT_DIR"
-			do_exec ". ./oe-init-build-env $CLC_ARG1"
-			do_exec "cd $BASEPATH"
-		fi
-
-		# move config files into conf directory
-		if test -f $BASEPATH/local.conf.common.inc; then
-			if test ! -f $BOX_BUILD_DIR/conf/local.conf.$BACKUP_SUFFIX; then
-				echo -e "\tset base configuration for $CLC_ARG1 ... "
-				do_exec "mv -v $BOX_BUILD_DIR/conf/local.conf $BOX_BUILD_DIR/conf/local.conf.$BACKUP_SUFFIX"
-				echo 'MACHINE ?= "'$CLC_ARG1'"' > $BOX_BUILD_DIR/conf/local.conf
-				echo "include $BASEPATH/local.conf.common.inc" >> $BOX_BUILD_DIR/conf/local.conf
-			fi
-		else
-			echo -e "\033[31;1mERROR:\033[0m:\ttemplate $BASEPATH/local.conf.common.inc not found..."
-			exit 1
-		fi
-
-		if test ! -f $BOX_BUILD_DIR/conf/bblayers.conf.$BACKUP_SUFFIX; then
-			echo -e "\033[37;1m\tset base bblayer configuration for $CLC_ARG1...\033[0m"
-			do_exec "cp -v $BOX_BUILD_DIR/conf/bblayers.conf $BOX_BUILD_DIR/conf/bblayers.conf.$BACKUP_SUFFIX"
-			META_MACHINE_LAYER=meta-`get_metaname $CLC_ARG1`
-			echo 'BBLAYERS += " \
-			'$BUILD_ROOT_DIR'/meta-neutrino \
-			'$BUILD_ROOT_DIR'/'$META_MACHINE_LAYER' \
-			"' >> $BOX_BUILD_DIR/conf/bblayers.conf
-			if test -d $BUILD_ROOT_DIR/$META_MACHINE_LAYER/recipes-multimedia/kodi; then
-				echo 'BBLAYERS += " \
-				'$BUILD_ROOT_DIR'/'$PYTHON2_LAYER_NAME' \
-				"' >> $BOX_BUILD_DIR/conf/bblayers.conf
-			fi
-		fi
-	fi
-}
-
-# function create local dist directory to prepare for web access
-function create_dist_tree () {
-	PAR1=$1
-	if [ "$PAR1" != "all" ]; then
-
-		DIST_BASEDIR="$BASEPATH/dist/$IMAGE_VERSION"
-		DIST_LINK=$DIST_BASEDIR/$PAR1
-		DIST_LINK_IMAGES=$DIST_BASEDIR/$PAR1/images
-		DIST_LINK_IPK=$DIST_BASEDIR/$PAR1/ipk
-		DIST_LINK_LICENSE=$DIST_BASEDIR/$PAR1/licenses
-
-		if test ! -d "$DIST_LINK"; then
-			echo -e "\n\033[37;1mcreate directory:\033[0m   $DIST_LINK"
-			do_exec "mkdir -p $DIST_LINK"
-		fi
-
-		DEPLOY_DIR=$BUILD_ROOT_DIR/$PAR1/tmp/deploy
-		DEPLOY_DIR_IMAGES=$DEPLOY_DIR/images/$PAR1
-		DEPLOY_DIR_IPK=$DEPLOY_DIR/ipk
-		DEPLOY_DIR_LICENSE=$DEPLOY_DIR/licenses
-
-		if test ! -L "$DIST_LINK_IMAGES"; then
-			echo -e "\033[37;1mcreate symlink:\033[0m     $DIST_LINK_IMAGES"
-			do_exec "ln -sf $DEPLOY_DIR_IMAGES $DIST_LINK_IMAGES"
-		fi
-
-		if test ! -L "$DIST_LINK_IPK"; then
-			echo -e "\033[37;1mcreate symlink:\033[0m     $DIST_LINK_IPK"
-			do_exec "ln -sf $DEPLOY_DIR_IPK $DIST_LINK_IPK"
-		fi
-
-		if test ! -L "$DIST_LINK_LICENSE"; then
-			echo -e "\033[37;1mcreate symlink:\033[0m     $DIST_LINK_LICENSE"
-			do_exec "ln -sf $DEPLOY_DIR_LICENSE $DIST_LINK_LICENSE"
-		fi
-	fi
-}
-
-# create configuration for machine
+# Create configuration for machine
+my_echo "\033[37;1mCreate configurations ...\033[0m"
 if [ "$MACHINE" == "all" ]; then
 	for M in  $MACHINES ; do
 		create_local_config $M;
-		create_dist_tree $M;
 	done
+	my_echo "\033[32;1mdone!\033[0m\n"
 else
 	create_local_config $MACHINE;
-	create_dist_tree $MACHINE;
+	my_echo "\033[32;1mdone!\033[0m\n"
 fi
 
-# check and create distribution directory inside html directory for online update
-if test ! -L /var/www/html/dist; then
-	echo -e "\033[37;1mNOTE:\t Online update usage.\033[0m"
-	echo -e "\t##########################################################################################"
-	echo -e "\t# /var/www/html/dist doesn't exists.                                                     #"
-	echo -e "\t# If you want to use online update, please configure your webserver and use dist content #"
-	echo -e "\t# Super user permissions are required to create symlink...                               #"
-	echo -e "\t# An easy way is to create a symlink to dist directory:                                  #"
-	echo -e "\t# \033[37;1msudo ln -s $BASEPATH/dist /var/www/html/dist\033[0m                                    #"
-	echo -e "\t########################################################################################## "
+## Create distribution structure
+create_dist_tree;
+
+## check and create distribution directory inside httpd directory for online update
+if test ! -L $HTTPD_DIST_DIR; then
+	my_echo "\033[37;1mLocal setup for package online update.\033[0m"
+	my_echo "------------------------------------------------------------------------------------------------"
+	my_echo "The httpd directory $HTTPD_DIST_DIR doesn't exists."
+	my_echo "If you want to use online update, please configure your webserver and use dist content"
+	my_echo ""
+	my_echo "An easy way is to create a symlink to dist directory:"
+	my_echo ""
+	my_echo "\033[37;1m\tsudo ln -s $BASEPATH/dist $HTTPD_DIST_DIR\033[0m"
 fi
 
-echo -e "\033[32;1mDONE!\033[0m"
+## Show results
+my_echo "\033[32;1m\nSummary:\033[0m"
+my_echo "\033[32;1m------------------------------------------------------------------------------------------------\033[0m"
+my_echo ""
+my_echo "\033[37;1mLocal environment setup was created\033[0m"
+my_echo "------------------------------------------------------------------------------------------------"
+my_echo "On 1st call of $0 Your config was created at this file from the template sample file"
+my_echo ""
+my_echo "\033[37;1m\t$BASEPATH/local.conf.common.inc\033[0m"
+my_echo ""
+my_echo "If this file has already exists some entries could be migrated or added on this file."
+my_echo "You should check $BASEPATH/local.conf.common.inc and modify it if required."
+my_echo ""
+my_echo "Unlike here: Please check this files for modifications or upgrades:"
+my_echo ""
+my_echo "\033[37;1m\t$BUILD_ROOT/<machine>/bblayer.conf\033[0m"
+my_echo "\033[37;1m\t$BUILD_ROOT/<machine>/local.conf\033[0m"
+
+my_echo ""
+my_echo "\033[37;1mStart build\033[0m"
+my_echo "------------------------------------------------------------------------------------------------"
+my_echo "Now you are ready to build your own images and packages."
+my_echo "Selectable machines are:"
+my_echo ""
+my_echo "\033[37;1m\t$MACHINES\033[0m"
+my_echo ""
+my_echo "Select your favorite machine (or identical) and the next steps are:\033[37;1m"
+my_echo ""
+my_echo "\tcd $BUILD_ROOT_DIR"
+my_echo "\t. ./oe-init-build-env build/<machine>"
+my_echo "\tbitbake neutrino-image"
+my_echo "\033[0m"
+
+my_echo ""
+my_echo "\033[37;1mUpdating build evironment and meta-layers\033[0m"
+my_echo "------------------------------------------------------------------------------------------------"
+my_echo ""
+my_echo "\033[37;1m\texecute: $USER_CALL\033[0m \033[32;1m--update\033[0m"
+my_echo ""
+my_echo "------------------------------------------------------------------------------------------------"
+my_echo "For more informations and next steps take a look at the README.md!"
+my_echo "\033[32;1mDONE!\033[0m"
+
 exit 0

local.conf.common.inc.sample

@@ -1,295 +1,434 @@
-### Host variables
-#
-# Determine how many tasks bitbake should run in parallel:
-BB_NUMBER_THREADS ?= "8"
-#
-# Determine how many processes make should run in parallel when running compile tasks:
-PARALLEL_MAKE ?= "-j 4"
-
-DISTRO = "tuxbox"
-
-
-### System variables
-#
-#DL_DIR ?= "${COREBASE}/yocto-downloads"
-DL_DIR = "${HOME}/Downloads"
-
-### sdk options
-#
-#SDKMACHINE ?= "i686"
-SDKMACHINE = "x86_64"
-#SDKIMAGE_FEATURES="dev-pkgs dbg-pkgs src-pkgs "
-
-
-### time zone
-#
-DEFAULT_TIMEZONE = "Europe/Berlin"
-
-
-### base build and source directory
-#
-YOCTO_BASEDIR = "${COREBASE}"
-
-
-### Disk Space Monitoring during the build
-#
-BB_DISKMON_DIRS = "\
-    STOPTASKS,${TMPDIR},1G,100K \
-    STOPTASKS,${DL_DIR},1G,100K \
-    STOPTASKS,${SSTATE_DIR},1G,100K \
-    ABORT,${TMPDIR},100M,1K \
-    ABORT,${DL_DIR},100M,1K \
-    ABORT,${SSTATE_DIR},100M,1K" 
-
-
-### Hash Equivalence
-#
-# Enable support for automatically running a local hash equivalence server and
-# instruct bitbake to use a hash equivalence aware signature generator. Hash
-# equivalence improves reuse of sstate by detecting when a given sstate
-# artifact can be reused as equivalent, even if the current task hash doesn't
-# match the one that generated the artifact.
-#
-# A shared hash equivalent server can be set with "<HOSTNAME>:<PORT>" format+#
-#
-BB_HASHSERVE = "auto"
-BB_SIGNATURE_HANDLER = "OEEquivHash"
-
-BB_DANGLINGAPPENDS_WARNONLY = "1"
-
-### Qemu configuration
-#
-PACKAGECONFIG_pn-qemu-native = "sdl"
-
-CONF_VERSION = "1"
-
-
-### Image settings
-# Image size:
-# possible are "small" or "normal" (normal means the same like empty string)
-#
-#IMAGESIZE = "normal"
-#IMAGESIZE = "small"
-#
-# Which neutrino source will be used:
-# Choose neutrino source. Possible values are "tuxbox", "tango" or "ni"
-# Note: Successful build of foreign neutrino source is not guaranteed.
-#
-FLAVOUR = "tuxbox"
-#
-# Name of the image, default target name "neutrino-image"
-#IMAGE_BASENAME = "neutrino-image"
-IMAGE_BASENAME = "${SDK_NAME}"
-#
-# Image version tags:
-# Allow usage of customized version tag within image file name. Default = "1" means: not allowed
-# For default result: neutrino-image-hd51-20200926170603_ofgwrite.zip
-INHIBIT_EXTENDED_IMAGE_VERSION = "1"
-#
-# For customized results:
-#INHIBIT_EXTENDED_IMAGE_VERSION = "0"
-# If INHIBIT_EXTENDED_IMAGE_VERSION = 0 then you can use the following options to create useful version labels for image files.
-#
-# Modify ${DISTRO_VERSION_NUMBER} for extended or custom version tag with what ever you want. This will be append a tag to the output file names, keep empty for nothing.
-# sample result, without any effect: neutrino-image_hd51-20200926170603_usb.zip
-#DISTRO_CUSTOM_VERSION = ""
-#
-# sample result: neutrino-image_hd51-20200926170603_v2020.39_usb.zip
-#DISTRO_CUSTOM_VERSION = "2020.39"
-#
-# sample result with increment: neutrino-image_hd51-20200926170603_v20.0_usb.zip
-# Result for next build will be: neutrino-image_hd51-20200926170603_v20.1_usb.zip
-#DISTRO_CUSTOM_VERSION = "${IMAGE_YEARLY_TAG}.${IMAGE_BUILD_INCREMENT}"
-
-
-### default image root password
-# set initial password for user root. Keep empty for root:
-#
-ROOTPW = ""
-
-
-### Choose which plugins should be installed
-#
-PLUGIN_INSTALL += "msgbox tuxcom shellexec input tuxwetter"
-
-
-### Add Image Maintainer here
-#
-CREATOR = "${USER}"
-KBUILD_BUILD_USER = "${CREATOR}"
-KBUILD_BUILD_HOST = "blue"
-
-
-### git configuration ... needed for etckeeper
-#
-GIT_USER = "root"
-MAIL = "root@tuxbox-${MACHINE}"
-
-
-### dev keys for neutrino gui
-# NOTE: Here you see empty entries! NOT WORKING!
-#
-# You can also include a file eg. named "local.conf.devkeys.inc"
-# and add these lines into your included file:
-# include /<path>/<to>/local.conf.devkeys.inc
-YT_DEV_KEY = ""
-TMDB_DEV_KEY = ""
-SHOUTCAST_DEV_KEY = ""
-OMDB_API_KEY = ""
-WEATHER_DEV_KEY = ""
-
-
-### extra build config options for neutrino build
-# e.g: to enable the neutrino test menu
-#EXTRA_OECONF_append_pn-neutrino-mp = " \
-#	--enable-testing \
-#"
-#EXTRA_OECONF_append_pn-gdb = "--with-system-gdbinit=/etc/gdbinit"
-
-
-### package feed configuration
-#
-PACKAGE_CLASSES ?= "package_ipk"
-#
-### Update feeds
-# Web server from which packages and images are updated. Points as default to this host
-# URL-template (only local in this config file)
-# for usage of these url's you should make a symlink as super user to the image and package directories
-#
-#UPDATE_SERVER_URL = "http://${KBUILD_BUILD_HOST}"
-#UPDATE_SERVER_URL = "http://192.168.1.202"
-#UPDATE_SERVER_URL = "http://localhost"
-#UPDATE_SERVER_URL = "file:///var/www/html"
-UPDATE_SERVER_URL = "https://update.tuxbox-neutrino.org"
-
-### Package manager configuration
-#
-#IPK_FEED_SERVER = "file:///media/sda1/service/ipk"
-# local feed if Tuxbox-Builder VM is in use
-DISTRO_FEED_VERSION = "${DISTRO_VERSION_NUMBER}"
-#DISTRO_FEED_VERSION = "3.2"
-IPK_FEED_SERVER = "${UPDATE_SERVER_URL}/dist/${DISTRO_FEED_VERSION}/${MACHINE}/ipk"
-
-
-### Image update configuration
-# IMAGE_LOCATION = "file:////media/sda1/service/image/flashimage.img"
-IMAGE_LOCATION = "${UPDATE_SERVER_URL}/dist/${DISTRO_FEED_VERSION}/${MACHINE}/images"
-
-# RELEASE_TEXT_LOCATION = "file:///media/sda1/service/image/imageversion"
-RELEASE_TEXT_LOCATION_HOST = "${DEPLOY_DIR_IMAGE}/beta.txt"
-RELEASE_TEXT_LOCATION = "${UPDATE_SERVER_URL}/dist/${DISTRO_FEED_VERSION}/${MACHINE}/images/beta.txt"
-#
-#
-# Image release state within release text, default = "0" (release), "1" (beta), 2 " (nightly)
-# This will be set as suffix within image version file in entry imagedescription
-#RELEASE_STATE = "0"
-RELEASE_STATE = "1"
-
-
-### Some additional lines for /etc/os-release and .version contents
-#
-OS_RELEASE_FIELDS_append = " HOME_URL SUPPORT_URL BUG_REPORT_URL BUILD_ID"
-HOME_URL = "https://github.com/tuxbox-neutrino"
-SUPPORT_URL = "https://wiki.tuxbox-neutrino.org"
-BUG_REPORT_URL = "https://forum.tuxbox-neutrino.org"
-
-### download mirrors
-#
-PREMIRRORS_prepend = "\
-     https://.*/.* https://archiv.tuxbox-neutrino.org/ \n \
-     git://.*/.* http://www.yoctoproject.org/sources/ \n \
-     ftp://.*/.* http://www.yoctoproject.org/sources/ \n \
-     http://.*/.* http://www.yoctoproject.org/sources/ \n \
-     https://.*/.* http://www.yoctoproject.org/sources/ \n \
-"
-
-#see: https://wiki.yoctoproject.org/wiki/How_do_I#Q:_How_do_I_create_my_own_source_download_mirror_.3F
-#
-SOURCE_MIRROR_URL ?= "https://archiv.tuxbox-neutrino.org"
-INHERIT += "own-mirrors" 
-BB_GENERATE_MIRROR_TARBALLS = "1" 
-#BB_NO_NETWORK = "1"
-
-PREMIRRORS_prepend = "\
-    file://.*/.*     file://${HOME}/Downloads/* \n"
-
-### Tip: use sstate mirrors
-#
-# Speed up your complete new package build or after deleted tmp dir or sstate-cache and guard against fetcher failures.
-# Official mirrors to find here: http://sstate.yoctoproject.org/
-# Ensure you have a fast internet. After 1st build you can disable this
-# SSTATE_MIRRORS += "\
-#     file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/2.7.3/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/3.0.3/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/3.1/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/3.1.1/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/3.1.2/PATH;downloadfilename=PATH \n \
-#     file://.* http://sstate.yoctoproject.org/3.2/PATH;downloadfilename=PATH \n \
-# "
-# This is our own stock of sstate cache related of last tuxbox builds.
-SSTATE_MIRRORS = "\
-     file://.* https://sstate.tuxbox-upload.de/all/sstate-cache/PATH;downloadfilename=PATH \n \
-"
-
-
-### masked recipes
-# This will ignore recipes to build.
-# NOTE: Some masked targets with related depends could break the build.
-# BBMASK += "/meta-neutrino/recipes-qt/qt5"
-
-# These entries replace default installed entries which are contained in ./meta-neutrino/recipes-images/images/neutrino-image-base.inc.
-# You can add more entries with variable IMAGE_INSTALL_append see below...
-#
-# IMAGE_INSTALL += " \
-# 	vsftpd \
-# "
-# IMAGE_INSTALL = " \
-# 	autofs \
-# 	ca-certificates \
-# 	curl \
-# 	dosfstools \
-# 	e2fsprogs \
-# 	e2fsprogs-resize2fs \
-# 	findutils \
-# 	gptfdisk \
-# 	hdparm \
-# 	ifupdown \
-# 	less \
-# 	libswscale \
-# 	libusb1 \
-# 	minidlna \
-# 	nano \
-# 	nfs-utils \
-# 	nfs-utils-client \
-# 	ntpdate \
-# 	ofgwrite \
-# 	openssh \
-# 	openssl \
-# 	opkg \
-# 	pv \
-# 	rpcbind \
-# 	rsync \
-# 	samsunglcd4linux \
-# 	tar \
-# 	tzdata \
-# 	tzdata-europe \
-# 	udev-extraconf \
-# 	udpxy \
-# 	util-linux-blkid \
-# 	util-linux-mount \
-# 	util-linux-swaponoff \
-# 	util-linux-umount \
-# 	virtual/screengrabber \
-# 	virtual/neutrino \
-# 	neutrino-plugins \
-# 	neutrino-lua-plugins \
-# 	neutrino-plugin-mediathek \
-# 	xupnpd \
-# 	zip \
-# "
-
-# Put additional packages that should be packaged into your image. Separated with a whitespace. or use IMAGE_INSTALL += ...
-#
-# IMAGE_INSTALL_append = " gdb-dbg glibc-dbg glibc-thread-db qtwebflix webmin rpm"
-# IMAGE_INSTALL_append = " gdb-dbg glibc-dbg glibc-thread-db webmin rpm"
+### See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-CONF_VERSION
+CONF_VERSION = "1"
+
+### Host options
+#   Determine how many tasks bitbake should run in parallel:
+#   NOTE: The build system already calculates the optimized values for your host system.
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-BB_NUMBER_THREADS
+#BB_NUMBER_THREADS = "16"
+#   Determine how many processes make should run in parallel when running compile tasks.
+#   NOTE: For your decision you can get information about core and threads at your machine with this command:
+#   ~ $  lscpu | grep -E '^Thread|^CPU\('
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-PARALLEL_MAKE
+#PARALLEL_MAKE = "-j 8"
+
+### Specifies the time (in seconds) after which to unload the BitBake server due to inactivity.
+#   Set BB_SERVER_TIMEOUT to determine how long the BitBake server stays resident between invocations.
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-BB_SERVER_TIMEOUT
+#BB_SERVER_TIMEOUT = "20"
+
+### SDK options
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-SDKMACHINE
+#SDKMACHINE = "i686"
+SDKMACHINE = "x86_64"
+#SDKIMAGE_FEATURES="dev-pkgs dbg-pkgs src-pkgs "
+
+### time zone
+DEFAULT_TIMEZONE = "Europe/Berlin"
+
+### Disk Space Monitoring during the build. Default disabled, but it's a good Idea to enable.
+#   see: https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#var-BB_DISKMON_DIRS
+BB_DISKMON_DIRS = "\
+    STOPTASKS,${TMPDIR},1G,100K \
+    STOPTASKS,${DL_DIR},1G,100K \
+    STOPTASKS,${SSTATE_DIR},500M,100K \
+    ABORT,${TMPDIR},100M,1K \
+    ABORT,${DL_DIR},100M,1K \
+    ABORT,${SSTATE_DIR},100M,1K \
+" 
+
+### Hash Equivalence
+# Enable support for automatically running a local hash equivalence server and
+# instruct bitbake to use a hash equivalence aware signature generator. Hash
+# equivalence improves reuse of sstate by detecting when a given sstate
+# artifact can be reused as equivalent, even if the current task hash doesn't
+# match the one that generated the artifact.
+#
+# A shared hash equivalent server can be set with "<HOSTNAME>:<PORT>" format+#
+#
+BB_HASHSERVE = "auto"
+BB_SIGNATURE_HANDLER = "OEEquivHash"
+#
+# https://docs.yoctoproject.org/ref-manual/variables.html#term-BB_DANGLINGAPPENDS_WARNONLY
+BB_DANGLINGAPPENDS_WARNONLY = "1"
+
+### Qemu configuration
+PACKAGECONFIG_pn-qemu-native = "sdl"
+
+### Save disk space during build process.
+#   With rm_work enabled, this variable specifies that work directories should not be removed after build process.
+#   If this variable is activated, the memory requirement is significantly reduced.
+#   Defined exceptions are listed within variable RM_WORK_EXCLUDE.
+#   Comment out this entry, if you want to keep all built content within work directories.
+#   See: https://docs.yoctoproject.org/ref-manual/classes.html#ref-classes-rm-work
+INHERIT += "rm_work"
+#   These targets are exluded from rm_work.
+RM_WORK_EXCLUDE += "neutrino-image neutrino-webif neutrino-logos neutrino-feed-config openssl"
+
+### Source download storage location (read/write)
+#   It's recommended outsourcing the download archive.
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=sdkimage_features#term-DL_DIR
+#DL_DIR ?= "${COREBASE}/yocto-downloads"
+DL_DIR = "${HOME}/Archive"
+#WARN_QA = "fetch"
+
+### Base directory of the OpenEmbedded build system used by build output and intermediate files (other than the shared state cache).
+#   By default, the TMPDIR variable points to tmp within the build directory.
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=sdkimage_features#term-TMPDIR
+#TMPDIR = "${TOPDIR}/tmp"
+
+### base build and source directory
+YOCTO_BASEDIR = "${COREBASE}"
+
+### Some targets are using ccache. Here you can set the path for ccache store. Default it is located wthin the TMPDIR,
+#   but it's recommended to set outside of the buildsystem into a shared directory
+#   NOTE: ccache is not recommended for global usage by Yocto, but we have enabled this class only for some few recipes (eg. samba, neutrino). 
+#   According to current knowledge, there are no bad side effects for these recipes. On the contrary,
+#   this has proven to be helpful for these recipes.
+#   See: https://docs.yoctoproject.org/ref-manual/classes.html?highlight=ccache#ccache-bbclass
+#CCACHE_TOP_DIR = "${TMPDIR}/ccache"
+CCACHE_TOP_DIR = "${HOME}/.ccache"
+
+### Where the OpenEmbedded build system place images, packages, SDKs, and other output files that are ready
+#   to be used outside of the build system.
+#   See also: https://docs.yoctoproject.org/ref-manual/variables.html#term-DEPLOY_DIR
+#   By default, this directory resides within the Build Directory as ${TMPDIR}/deploy.
+#   NOTE: Change this path only, if it is really needed for by your requirement!
+#DEPLOY_DIR = "${TMPDIR}/deploy"
+#   Where to fo find the generated images.
+#DEPLOY_DIR_IMAGE = "${DEPLOY_DIR}/images"
+#   Where to fo find the generated packages. Only ipk's are supported by Neutrino package manager.
+#DEPLOY_DIR_IPK = "${DEPLOY_DIR}/ipk"
+
+### Directory for the shared state cache. By default, the SSTATE_DIR variable points to sstate-cache within the build directory as ${TOPDIR}/sstate-cache,
+#   but it's a good idea to place it into a shared directory, so that this folder is always available in case the build folder should be deleted anyway or
+#   you want to use sstate cache for other builds in future. It goes without saying that there is sufficient memory space available.
+#   NOTE: This directory is a very precious. Don't delete it lightly.
+#SSTATE_DIR = "${TOPDIR}/sstate-cache"
+SSTATE_DIR = "${HOME}/sstate-cache/${DISTRO_VERSION}"
+
+### Tipp: use sstate mirrors
+#   Speed up your complete new package build or after deleted tmp dir or sstate-cache and guard against fetcher failures.
+#   Official mirrors to find here: http://sstate.yoctoproject.org/
+#   Ensure you have a fast internet. After 1st build you can disable this
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=sdkimage_features#term-SSTATE_MIRRORS
+#SSTATE_MIRRORS += "\
+#     file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/2.7.3/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.0.3/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.1/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.1.1/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.1.2/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.2/PATH;downloadfilename=PATH \n \
+#     file://.* http://sstate.yoctoproject.org/3.2.4/PATH;downloadfilename=PATH \n \
+# "
+#SSTATE_MIRRORS += "\
+#    file://.* http://sstate.yoctoproject.org/${DISTRO_VERSION}/PATH;downloadfilename=PATH \n \
+#"
+#   This is our own stock of sstate cache related of last tuxbox builds.
+SSTATE_MIRRORS += "\
+    file://.* https://n4k.sourceforge.io/sstate-cache/${DISTRO_VERSION}/sstate-cache/PATH;downloadfilename=PATH \n \
+"
+SSTATE_MIRRORS += "\
+    file://.* https://n4k.sourceforge.io/sstate-cache/devel/sstate-cache/PATH;downloadfilename=PATH \n \
+"
+
+#   If you are using the TuxboxBuilder VM and it's running, you can use its sstate cache related of last builds.
+#   NOTE: www server of Tuxbox-Builder VM must be enabled and configured so that it can be reached. 
+#   If required, replace the server url with your own TuxboxBuilder server url
+#SSTATE_MIRRORS += "\
+#     file://.* http://tuxbox-builder/sstate-cache/PATH;downloadfilename=PATH \n \
+#"
+
+#   If you want to use any local sstate caches, you can add your own local directory.
+#   You should ensure directories are exist.
+#   These are samples for usage your own local sstate mirror (read only)
+# SSTATE_MIRRORS += "\
+#       file://.* file:///${HOME}/sstate-cache/PATH;downloadfilename=PATH \n \
+# "
+# SSTATE_MIRRORS += "\
+#       file://.* file:///${HOME}/sstate-cache/3.2/PATH;downloadfilename=PATH \n \
+# "
+# SSTATE_MIRRORS += "\
+#       file://.* file:///${HOME}/sstate-cache/3.2.4/PATH;downloadfilename=PATH \n \
+# "
+
+### Image settings
+#   Image size:
+#   possible are "small" or "normal" (normal means the same like empty string)
+IMAGESIZE = "normal"
+#IMAGESIZE = "small"
+
+### Set DISTRO
+#   NOTE: don't remove, it's required, but you can set an own name
+DISTRO = "tuxbox"
+
+### Which neutrino and libstb-hal sources will be used. Possible values are "tuxbox", "tango" or "ni"
+#   NOTE:
+#   This option is only to be understood as a relic from the early days of this meta layer 
+#   and is therefore not necessarily maintained anymore. There is no guarantee that the build process 
+#   for foreign sources will be successful.
+#   The more effective method would be to transfer the Neutrino and 
+#   libstb-hal sources together into the workspace and use Git's functionality to integrate 
+#   third-party repositories. So you are not be limited to few selected sources and can also use 
+#   their branches and adapt the build process accordingly.
+#   Therefore, it must be expected that FLAVOUR option will soon be completely removed.
+#   See: https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html#modifying-an-existing-recipe
+#   and: https://docs.yoctoproject.org/current/ref-manual/devtool-reference.html
+#FLAVOUR = "tuxbox"
+
+### Image filename arranging
+#   set a distro name if required
+#DISTRO_NAME = "${DISTRO}"
+
+### General image name
+#IMAGE_BASENAME = "${DISTRO_NAME}"
+IMAGE_BASENAME = "my-image"
+
+### This variable controls the emission of warnings
+#   when GITPKGVTAG is used but no Git tags are found in the repository.
+#   By default, it is set to "0", which means warnings are enabled.
+#   Set this variable to "1" to suppress these warnings.
+#GITPKGVTAG_NO_WARN_ON_NO_TAG = "1"
+#   Use this for a specific recipe:
+#GITPKGVTAG_NO_WARN_ON_NO_TAG:pn-myrecipe = "1"
+
+### Release distro type string
+#   Possible types as plain text are "beta", "release", "nightly", all others means what ever you want
+DISTRO_TYPE = "beta"
+#DISTRO_TYPE = "release"
+#DISTRO_TYPE = "nightly"
+#   ...or what ever you want, e.g."
+#DISTRO_TYPE = "private"
+
+### Distro codename
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html?highlight=distro_codename#term-DISTRO_CODENAME
+#DISTRO_CODENAME = ""
+
+### Distro version: required for version string within the .version file and defined image version
+#DISTRO_VERSION_NUMBER_MAJOR = "3"
+#DISTRO_VERSION_NUMBER_MINOR = "2"
+#DISTRO_VERSION_NUMBER_MICRO = "4"
+#DISTRO_VERSION_NUMBER_CYCLE = "${DISTRO_VERSION_NUMBER_MAJOR}${DISTRO_VERSION_NUMBER_MINOR}${DISTRO_VERSION_NUMBER_MICRO}"
+#DISTRO_VERSION = "${DISTRO_VERSION_NUMBER_MAJOR}.${DISTRO_VERSION_NUMBER_MINOR}.${DISTRO_VERSION_NUMBER_MICRO}"
+
+### Image name suffixes:
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html#term-IMAGE_NAME
+#IMAGE_VERSION_SUFFIX="-${DATETIME}"
+### proposed samples:
+#IMAGE_VERSION_SUFFIX="-${DISTRO_TYPE}"
+#IMAGE_VERSION_SUFFIX="-${DATETIME}-${DISTRO_TYPE}"
+#IMAGE_VERSION_SUFFIX="-${PR}"
+#IMAGE_VERSION_SUFFIX="-${PR}-${DISTRO_TYPE}"
+### Usage of ${DATE} is possible but not recommended, makes only sense for really once daily build. 
+#IMAGE_VERSION_SUFFIX="-${PR}.${DATE}"
+#IMAGE_VERSION_SUFFIX="-${PR}.${DATE}-${DISTRO_TYPE}"
+### For usage of ${META_VERSION}, uncomment the inherit line and the IMAGE_VERSION_SUFFIX line, to set the current git version of meta layer
+#   You can define an other meta-layer with variable META_NAME within the COREBASE directory.
+#META_NAME = "meta-neutrino"
+#inherit metaversion
+#IMAGE_VERSION_SUFFIX=".${META_VERSION}"
+
+### Set image name
+#   The name of the output image files minus the extension. This variable is derived using the IMAGE_BASENAME, MACHINE, and IMAGE_VERSION_SUFFIX variables:
+#   Default and origin by yocto its set to: IMAGE_NAME = "${IMAGE_BASENAME}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
+#   We are using this as default image name:
+#IMAGE_NAME = "${IMAGE_BASENAME}-${MACHINE_BRAND}-${MACHINE_NAME}-${DISTRO_VERSION}${IMAGE_VERSION_SUFFIX}"
+
+### Update server configuration for update feeds and update server configuration
+#   Web server from which packages and images are updated. Points as default to the www directory of the host
+#   URL-template (only local in this config file)
+#   for usage of these url's you should make a symlink as super user to the image and package directories
+#   where do find the buildsystem the distro type file (beta.txt, release.txt ...), this file contains list of image urls for download
+#RELEASE_TEXT_LOCATION_FILE = "${DEPLOY_DIR_IMAGE}/${DISTRO_TYPE}.txt"
+
+### Server URL which contains update and packages. 
+#   Web server must be running and html content must point to the toplevel directory which contains the deployed images
+#   NOTE: @hostname@ is only a placeholder and will be replaced with current hostname of your build host automatically. @hostname@ could be the current host IP too. 
+#   or any other domain.tld. If required, replace @hostname@ with the host IP or Domain.
+#UPDATE_SERVER_URL = "http://@hostname@"
+
+##  URL to the dist directory, must contain the content of the deployed images and packages
+#DIST_URL = "${UPDATE_SERVER_URL}/dist"
+
+##  URL to the images, must contain the content of the image dir and its a sub dir to specific machine build and image dir which contains machine images
+#IMAGE_LOCATION_URL = "${DIST_URL}/${DISTRO_VERSION}/${MACHINE}/images/${MACHINE}"
+
+##  URL to package feed
+#IPK_FEED_SERVER ?= "${DIST_URL}/${DISTRO_VERSION}/${MACHINE}/ipk"
+
+### Package type configuration
+#   See: https://docs.yoctoproject.org/ref-manual/variables.html#term-PACKAGE_CLASSES
+#   NOTE: Only ipk's are suported by Neutrino package manager.
+PACKAGE_CLASSES = "package_ipk"
+
+### Prevent splitting out debug information during packaging
+#   see: https://docs.yoctoproject.org/ref-manual/variables.html#term-INHIBIT_PACKAGE_DEBUG_SPLIT
+#INHIBIT_PACKAGE_DEBUG_SPLIT = "1"
+
+### Add additional lines for /etc/os-release and .version contents 
+#HOME_URL = "https://github.com/tuxbox-neutrino"
+#SUPPORT_URL = "https://wiki.tuxbox-neutrino.org"
+#BUG_REPORT_URL = "https://forum.tuxbox-neutrino.org"
+
+### Default image root password
+#   set initial password for user root. Keep empty for root:
+ROOTPW = ""
+
+### Add Image Maintainer and host build machine here
+#CREATOR = "${USER}"
+#KBUILD_BUILD_USER = "${CREATOR}"
+KBUILD_BUILD_HOST = "127.0.0.1"
+
+### Git configuration on target machine.
+#   To utilize Etckeeper and Neutrino plugins, Git is a prerequisite.
+#   Thus, configuring Git on the target machine is imperative.
+#   However, keep in mind that Etckeeper should not be pre-installed on 
+#   the image as it would augment the image size and increase storage requirements
+#   during image creation. Therefore, it is recommended to install Etckeeper only 
+#   after successfully flashing the image. However, for devices with limited storage 
+#   space for the root filesystem, ensure that enough space is available for 
+#   installing Etckeeper to avoid runtime errors.
+#   Furthermore, note that Git's databases can bloat over time, 
+#   leading to unnecessarily large storage consumption. If Git is provided as an optional
+#   downloader in some plugins, it is advisable to avoid using it unless necessary.
+#   Use Git with caution.
+GIT_USER = "root"
+MAIL = "root@${MACHINE}"
+
+### dev keys for neutrino gui and weather plugin
+#   NOTE: Here you see empty entries! NOT WORKING! Own keys are required!
+#   You can also include a file eg. named "local.conf.devkeys.inc"
+#   Modify and add these line:
+#   include /<path>/<to>/local.conf.devkeys.inc
+##  TMDB, OMDB, ShoutCast
+TMDB_DEV_KEY = ""
+OMDB_API_KEY = ""
+SHOUTCAST_DEV_KEY = ""
+##  Weather
+#   NOTE: Beginning on March 31st, 2023 the Dark Sky API will not longer be available.
+#   WeatherKit, a new Apple API available on iOS, iPadOS, macOS, tvOS, 
+#   and web that provides access to the new Apple Weather forecast data.
+#   The WEATHER_DEV_KEY variable is not longer used for darksky keys
+#   Currently used provider is: openweather map
+WEATHER_DEV_KEY = ""
+#   NOTE: YouTube functionality of Neutrino was completely removed in 2022, this key has no effects anymore, but YouTube is usable further with plugins. 
+YT_DEV_KEY = ""
+
+## EXTRA_OECONF modifications for Neutrino.
+#   NOTE! For global use within build-system see: https://docs.yoctoproject.org/ref-manual/variables.html#term-EXTRA_OECONF 
+## Extra build config options for neutrino build
+#   eg: to enable the neutrino test menu.
+#   NOTE! --enable-testing Works only with FLAVOUR = "tuxbox".
+#   If you want to use a different FLAVOUR than 'tuxbox', keep these lines uncommented and
+#   add them to your local.conf within your build directory.
+#EXTRA_OECONF_append_pn-neutrino-mp += " \
+#		--enable-testing \
+#"
+## Uncomment these lines to disable debug mode for Neutrino.
+#EXTRA_OECONF_append_pn-neutrino-mp += " \
+#		--without-debug \
+#"
+
+### Extra build config options for gdb build
+#EXTRA_OECONF_append_pn-gdb = "--with-system-gdbinit=/etc/gdbinit"
+
+### Experimental kodi, qtwebflix
+#   NOTE: will build only with gatesgarth/3.2.4
+#   It's not guaranteed, that build will be successfully.
+#   Alternatively, you can add targets to EXTRA IMAGE DEPENDS or IMAGE_INSTALL.
+#
+#DEPENDS_pn-neutrino-image += "kodi qtwebflix"
+
+### URLs for download mirrors from Yocto or our own stock 
+#   global archive and source urls
+ARCHIVE_SOURCE_URL = "https://n4k.sourceforge.io/archive/Archive"
+YOCTO_SOURCE_URL = "http://www.yoctoproject.org/sources"
+
+PREMIRRORS_prepend = "\
+     https://.*/.* ${ARCHIVE_SOURCE_URL}/ \n \
+     git://.*/.* ${YOCTO_SOURCE_URL}/ \n \
+     ftp://.*/.* ${YOCTO_SOURCE_URL}/ \n \
+     http://.*/.* ${YOCTO_SOURCE_URL}/ \n \
+     https://.*/.* ${YOCTO_SOURCE_URL}/ \n \
+"
+### Download mirrors from Local file mirrors (read only)
+#PREMIRRORS_prepend = "\
+#     file://.*/.*     file://${HOME}/Downloads/* \n \
+# "
+
+### Source mirror urls
+#    see: https://wiki.yoctoproject.org/wiki/How_do_I#Q:_How_do_I_create_my_own_source_download_mirror_.3F
+#    This is our own stock of archives, those are created by our image builds.
+SOURCE_MIRROR_URL = "${ARCHIVE_SOURCE_URL}"
+INHERIT += "own-mirrors" 
+BB_GENERATE_MIRROR_TARBALLS = "0" 
+#BB_NO_NETWORK = "1"
+
+### Masked recipes
+#   This will ignore recipes to build.
+#   NOTE: Some masked targets with related depends could break the build.
+#BBMASK += "/meta-neutrino/recipes-qt/qt5"
+
+### Build packages but do not install packages into image
+#   https://www.yoctoproject.org/docs/current/mega-manual/mega-manual.html#var-EXTRA_IMAGEDEPENDS
+#EXTRA_IMAGEDEPENDS += " \
+# 			gdb \
+# 			samba \
+# 			vsftpd \
+# "
+#EXTRA_IMAGEDEPENDS += " \
+# 			kodi \
+# "
+
+### Put additional packages that should be packaged into your image. Separated with a whitespace. or use IMAGE_INSTALL += ...
+#   https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#var-IMAGE_INSTALL
+#   See: ./meta-neutrino/recipes-images/images/neutrino-image-base.inc.
+IMAGE_INSTALL += " \
+	stb-flash \
+	msgbox \
+	shellexec \
+	tuxcom \
+	input \
+"
+#IMAGE_INSTALL += " \
+# 	webmin \
+#"
+# IMAGE_INSTALL += " \
+#	neutrino-3rd-party-themes \
+#"
+# IMAGE_INSTALL += " qtwebflix"
+# IMAGE_INSTALL += " gdb-dbg glibc-dbg glibc-thread-db"
+
+### Examples to ...
+#   ... remove already contained packages from IMAGE_INSTALL use this:
+#I MAGE_INSTALL_remove += " \
+# 	<target1> \
+# 	<target2> \
+# "
+
+### ... build packages without install into image use PACKAGE_EXCLUDE
+#   see: https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#var-PACKAGE_EXCLUDE
+# PACKAGE_EXCLUDE += \
+#	<package1> \
+#	<package2> \
+#"
+
+### ... replace a source url via local.conf
+# SRC_URI_pn-x264 = "git://code.videolan.org/videolan/x264;branch=stable;protocol=https \
+# "
+
+### base-files rewrite
+#LICENSE_pn-base-files = "CLOSED"
+#LIC_FILES_CHKSUM_pn-base-files = ""
+#BBMASK += "/meta-neutrino/recipes-images/base-files/base-files_%.bbappend"
+#FILESEXTRAPATHS_prepend := "${HOME}/devel/local-yocto-files/base-files:"
+
+### Enabling and Disabling Build History
+#   see> https://docs.yoctoproject.org/singleindex.html#enabling-and-disabling-build-history
+#INHERIT += "buildhistory"
+#BUILDHISTORY_COMMIT = "1"
+
+### Replace some lame fetch urls
+#BINUTILS_GIT_URI = "git://github.com/bminor/binutils-gdb.git;branch=${BRANCH};protocol=https"
+#GLIBC_GIT_URI = "git://github.com/bminor/glibc.git;branch=release/2.32/master;name=glibc"