Merge pull request #47 from chrizzo-hb/main

Improved updates/bluetooth pages, added page about resetting system folder

Author: chrizzo-hb

docs/configure/bluetooth.de.md

@@ -4,13 +4,15 @@ KNULLI unterstützt eine ganze Reihe verschiedener Bluetooth-Geräte, z.B. Einga
 
 ## Bluetooth-Geräte verbinden
 
-Um ein Bluetooth-Gerät mit deinem KNULLI-Gerät zu verbinden, musst du zunächst sicherstellen, dass beide Geräte Bluetooth unterstützen. Wenn beide Geräte Bluetooth unterstützen, kannst du auf ++"Start"++ drücken, um das Hauptmenü zu öffnen und *Controller & Bluetooth Settings* auswählen. Hier kannst du bei *Enable Bluetooth* zunächst Bluetooth einschalten, falls es nicht schon eingeschaltet ist.
-
-Anschließend kannst du entweder versuchen, alle Eingabegeräte in deiner Nähe automatisch zu erkennen und zu verbinden, in dem du *Pair Bluetooth Pads Automatically* auswählst. Alternativ kannst du *Pair A Bluetooth Device Manually* auswählen, um dein Gerät aus einer Liste in der Nähe befindlicher Bluetooth-Geräte auszuwählen. Falls dein Gerät in der Liste nicht angezeigt wird, oder das Bluetooth-Pairing fehlschlägt, schau in das Handbuch deines Geräts und such dort nach der Anleitung für Bluetooth-Verbindungen.
-
 !!! info "Problemlösung"
 
     Falls dein KNULLI-Gerät dein Gerät nicht findet oder du Verbindungsprobleme hast, deaktiviere den W-LAN-Zugiff deines KNULLI-Geräts während des Verbindungsaufbaus (Pairing).
+    
+    Außerdem solltest du dir bewusst sein, dass manche Bluetooth-Controller so konstruiert sind, dass sie **ausschließlich** mit den Systemen verbinden, für die sie hergestellt wurden (z.B. Android oder Nintendo Switch). Wenn dein Bluetooth-Controller an deinem KNULLI-Gerät nicht funktioniert, solltest du zunächst überprüfen, ob dein Controller-Modell überhaupt via Bluetooth mit einem **PC** verbunden werden kann.
+
+Um ein Bluetooth-Gerät mit deinem KNULLI-Gerät zu verbinden, musst du zunächst sicherstellen, dass beide Geräte Bluetooth unterstützen. Wenn beide Geräte Bluetooth unterstützen, kannst du auf ++"Start"++ drücken, um das Hauptmenü zu öffnen und *Controller & Bluetooth Settings* auswählen. Hier kannst du bei *Enable Bluetooth* zunächst Bluetooth einschalten, falls es nicht schon eingeschaltet ist.
+
+Anschließend kannst du entweder versuchen, alle Eingabegeräte in deiner Nähe automatisch zu erkennen und zu verbinden, in dem du *Pair Bluetooth Pads Automatically* auswählst. Alternativ kannst du *Pair A Bluetooth Device Manually* auswählen, um dein Gerät aus einer Liste in der Nähe befindlicher Bluetooth-Geräte auszuwählen. Falls dein Gerät in der Liste nicht angezeigt wird, oder das Bluetooth-Pairing fehlschlägt, schau in das Handbuch deines Geräts und such dort nach der Anleitung für Bluetooth-Verbindungen.
 
 ### Controller zuordnen
 

docs/configure/bluetooth.md

@@ -4,22 +4,24 @@ KNULLI supports a lot of different types of Bluetooth devices, such as input dev
 
 ## Connect a Bluetooth device
 
+!!! info "Troubleshooting"
+
+    If your KNULLI device fails to pair with one of your Bluetooth devices, try **disabling Wi-Fi** while **pairing**. (You can enable Wi-Fi again after pairing.)
+
+    Also, please be aware that some Bluetooth controllers might be built to **only** support the system they are made for, e.g., Android or Nintendo Switch. If your Bluetooth controller does not work with your KNULLI device, make sure that it supports Bluetooth for **PC**.
+
 To connect a Bluetooth device with your KNULLI device, you first need to make sure that both devices support Bluetooth. If so, press ++"Start"++ to bring up the main menu and go to *Controller & Bluetooth Settings*. Here, you will be able to *Enable Bluetooth* if it is not enabled, yet.
 
 Once Bluetooth is enabled, either try to *Pair Bluetooth Pads Automatically* (to automatically pair input-devices in pairing mode) or select *Pair A Bluetooth Device Manually* and find your device in a list of available Bluetooth devices in your vicinity. If your Bluetooth device does not show up or pairing does not work as expected, check the manual of your Bluetooth device for pairing instructions.
 
-### Assing controllers
+### Assigning controllers
 
 After your devices have been paired successfully, you might need to take additional steps in order to use them. For example, after connecting a Bluetooth controller, you will have to **assign** the controller to a **player** as explained in the [Controls](../controls) section.
 
 ### Set up audio output
 
 After pairing an audio output device (like a headphone), you need to set it as your audio output. Press ++"Start"++ to bring up the main menu, head to *System Settings* and choose your Blueooth device as *Audio output*.
 
-!!! info "Troubleshooting"
-
-    If your KNULLI device fails to pair with one of your Bluetooth devices, try disabling Wi-Fi while pairing.
-
 ## Forget a Bluetooth device
 
 If you want to remove or "forget" a paired Bluetooth device, press the ++"Start"++ button to bring up the main menu, head to *Controller & Bluetooth Settings*, open *Forget A Bluetooth Device*, find the device and remove it.

docs/configure/reset-to-factory-settings.de.md

@@ -0,0 +1,31 @@
+#  :material-folder-refresh: Auf Werkseinstellungen zurücksetzen
+
+!!! danger "Den gesamten `system`-Ordner zurücksetzen"
+
+     **Normalerweise** erfordern KNULLI-Updates **NICHT**, dass du den gesamten `system`-Ordner zurückgesetzt. Das Zurücksetzen des `system`-Ordners kommt dem **Zurücksetzen auf Werkseinstellungen** gleich. Dementsprechend ist es danach zwingend nötig, **alle deine Einstellungen erneut vorzunehmen**. Du solltest **NICHT** versuchen, den `system`-Ordner zurückzusetzen, wenn du dir nicht absolut sicher bist, dass es notwendig ist.
+
+Wie du wahrscheinlich bereits weißt, sind **deine gesamten Einstellungen** in deinem `userdata/system`-Ordner gespeichert, wie im Abschnitt [Speicherort für Spiele](../../play/add-games/game-storage) erklärt.
+
+Wenn dein System sich nicht mehr Erwartungskonform verhält, nachdem du eine Einstellung geändert hast, und du die Änderung nicht rückgängig machen kannst, kannst du das Problem möglicherweise lösen, in dem du die entsprechende Konfigurationsdatei oder den gesamten `system`-Ordner zurücksetzt. In **SEHR seltenen Fällen** kann es auch nötig sein, nach einem Update einige Einstellungen auf neue KNULLI-Standardwerte zu setzen, indem die entsprechenden Dateien im `system`-Ordner **ersetzt** oder **angepasst** werden.
+
+Der einfachste Weg um dieses Ziel zu erreichen ist, die entsprechenden Dateien **oder** den gesamten Ordner zu **entfernen**. Während des nächsten Bootvorgangs wird KNULLI die fehlenden Dateien mit neuen Dateien ersetzen, die dann die aktuellen KNULLI-Standardeinstellungen enthalten.
+
+Wenn du eine einzelne Konfigurationsdatei (oder den gesamten `system`-Ordner) zurücksetzen musst oder möchtest, greif dazu zunächst auf deinen `userdata`-Ordner zu, wie du es sonst auch machst, oder benutz den mitgelieferten *OD-Commander* aus der Kategorie *Ports*. Wir **empfehlen dringend**, dass du die betroffenen Dateien **oder** den `system`-Ordner **umbenennst** statt zu löschen, indem du `.bak` ans Ende des Dateinamens schreibst (also z.B. den `system`-Ordner in `system.bak` umbenennst). Auf diese Weise kannst du deine alten Einstellungen jederzeit wiederherstellen, oder einzelne Dateien/Zeilen aus deiner alten Konfiguration übernehmen.
+
+### Dateien und Ordner mit OD-Commander umbenennen
+
+* Öffne die Kategorie *Ports*.
+* Starte *OD-Commander*.
+* Du solltest jetzt bereits den Inhalt deines `userdata`-Ordners auf der linken Seite sehen, du kannst dies u.A. an der Überschrift `/userdata` erkennen. Falls du noch nicht dort bist, navigiere zunächst nach `/userdata`, indem du mit oben/unten auf dem D-Pad hoch und runter navigierst und mit OK/Zurück in Ordner hineingehst oder sie wieder verlässt.
+* Lokalisiere den `system`-Ordner auf der linken Bildschirmseite.
+* Während der Fokus auf dem `system`-Ordner liegt
+     * öffne **entweder** den Ordner und suche darin die einzelnen Dateien oder Unterordner, die du zurücksetzen möchtest
+     * **oder** halte den Fokus einfach auf dem `system`-Ordner falls du den ganzen Ordner zurücksetzen möchtest.
+* Wenn du den Fokus auf einer Datei oder einem Ordner hast, die/den du zurücksetzen möchtest
+    * drück ++"X"++ um das Datei-Menü zu öffnen.
+    * wähle *Rename*.
+    * benutz die On-Screen-Tastatur um den Datei-/Ordnernamen zu ändern.
+
+### Konfigurationsdateien zurücksetzen
+
+Anschließend kannst du dein KNULLI-Gerät neu starten. Es wird alle fehlenden Dateien und Ordner während des Bootvorgangs neu erzeugen. Du kannst jetzt entweder alle deine Einstellungen wieder händisch über die KNULLI-GUI vornehmen, oder die Konfigurationsdateien mit deiner `.bak`-Sicherung vergleichen und Zeile für Zeile alle Einstellungen übernehmen, die du behalten möchtest.

docs/configure/reset-to-factory-settings.md

@@ -0,0 +1,33 @@
+#  :material-folder-refresh: Reset To Factory Settings
+
+!!! danger "Re-creating the entire `system` folder"
+
+     **Usually**, KNULLI updates will **NOT** require you to re-create your entire `system` folder. Re-creating the `system` folder corresponds to **resetting to factory defaults**. Consequently, it will force you to **re-configure a lot of settings manually** since they will be gone afterwards! Do **NOT** do this, unless you are absolutely sure it is required.
+
+As you might already know, **all your settings** are stored in your `userdata/system` folder as explained in the [Game Storage](../../play/add-games/game-storage) section.
+
+If your system does not work as expected after you changed a setting and you can't find a way to undo said setting, your issue might still be fixed by resetting the corresponding configuration file or the entire `system` folder to factory settings. In **VERY rare cases**, it might also be required to adapt your settings to new KNULLI defaults by **replacing/updating some files** in that `system` folder after you installed an update.
+
+The easiest way to achieve that is by just **removing** either the respective files **or** the entire folder. During the next boot, KNULLI will replace all the missing files with new files which contain the default settings.
+
+## Back up your current settings
+
+If you want or need to re-create a configuration file (or the entire `system` folder) with default settings, access your `userdata` folder the same way you always access it. Alternatively, you can use the built-in *OD-Commander* from the *Ports* category. Either way, we **strongly suggest** that you **rename** the `system` folder **or** the files you want to replace by adding a suffix like `.bak` (e.g., rename from `system` to `system.bak`). This way, you will be able to put your old settings back entirely or hand-pick single files/lines from your old settings.
+
+### Renaming files/folders with OD-Commander
+
+* Go to the *Ports* category.
+* Find and launch *OD-Commander*.
+* You should already see the contents of your `userdata` folder on the left side, indicated by the headline `/userdata`. If you are not there, yet, navigate to `/userdata` by using up/down on the D-pad to navigate and the OK/Back buttons to enter/leave a folder.
+* Locate the `system` folder on the left side of the screen.
+* While the focus is on the `system` folder
+     * **either** enter the folder and locate the single files or subfolders you want to re-create
+     * **or** just stay, if you want to re-create the entire system folder.
+* Once you have moved the focus on a file/folder you want to re-create
+    * press ++"X"++ to open the file menu.
+    * select *Rename*.
+    * use the on-screen keyboard to rename the file/folder.
+
+### Re-create your configuration files
+
+Afterwards, reboot your KNULLI device. It will re-create the missing files and folders from KNULLI defaults. Now, you can either re-configure all your settings via the EmulationStation GUI or you can hand-pick configuration details by comparing your old settings (`.bak`) with the new ones.

docs/play/update.de.md

@@ -1,26 +1,29 @@
 #  :material-update: KNULLI aktualisieren
 
-Auf Geräten, die mit dem Internet verbunden werden können, kann KNULLI direkt "Over the Air" (OTA) aktualisiert werden. Alternativ kann die KNULLI-Installation auf deinem Gerät auch aktualisiert werden, in dem du das Update herunterlädst und manuell installierst.
+!!! info "OTA-Updates"
 
-## Option 1: OTA-Updates
+    Batocera unterstützt OTA-Updates (over-the-air), die direkt aus der EmulationStation-GUI heraus gestartet werden können. Auch KNULLI zeigt dir bereits das OTA-Update-Menü an. Leider haben wir aber **noch keine OTA-Server** eingerichtet. Bis wir das getan haben, müssen wir dich leider bitten, dein KNULLI-Gerät **manuell** zu aktualisieren.
 
-Wenn dein Gerät eine aktive Internetverbindung hat, kannst du KNULLI direkt aus EmulationStation heraus aktualisieren:
+## Manuelles Update
 
-1. Öffne das Hauptmenü, in dem du den ++"Start"++-Button drückst.
-2. Wähle *Updates & downloads*.
-3. Gehe zu *Start updates*.
+Du kannst die KNULLI-Installation auf deinem Gerät aktualisieren, indem du das neueste **Boot-Package** für dein Gerät herunterlädst und manuell die `batocera`-Datei auf deinem Gerät ersetzt.
 
-!!! info "Du kannst mit dem Schalter *Check for updates* einstellen, ob du über neue Updates informiert werden möchtest. Unter *Update type* kannst du einstellen, ob du nur "stabile" Releases (*Stable*) oder auch prototypische Vorabversionen (*Butterfy*) installieren möchtest."
-
-## Option 2: Manuelles Update
-
-Wenn dein Gerät keinen Internetzugang hat, oder OTA-Updates aus anderen Gründen nicht möglich sind, kannst du deine KNULLI-Installation auch manuell aktualisieren.
-
-1. Lade das aktuelle Update (Der Dateiname endet mit `boot.gz` oder `boot.tar.gz`) für dein Gerät von der [Releases-Seite](https://github.com/knulli-cfw/distribution/releases/latest) herunter.
-    * Du findest Download-Links für alle Geräte und Plattformen, die von uns unterstützt werden, in der Tabelle `Installation Package Downloads`.
-    * Stelle sicher, dass du das richtige Update für dein Gerät herunterlädst. Wenn du KNULLI z.B. auf einem [RG35XX](../../devices/anbernic/rg35xx) installieren möchtest, musst du das `rg45xx`-Update herunterladen.
+1. Lade das aktuelle **Boot-Package** für dein Gerät von unserer [Releases-Seite](https://github.com/knulli-cfw/distribution/releases/latest) herunter, indem du den folgenden Schritten folgst:
+    * Scroll bis zum Ende des aktuellsten Releases, wo du die **Assets**-Liste findest.
+    * Identifiziere das **Boot-Package** für dein jeweiliges Gerät indem du sicherstellst, dass
+        * es den Namen deines Gerätes enthält (z.B. `rg35xx-h` für ein Gerät vom Typ Anbernic RG35XX-H).
+        * das **Ende** des Dateinamens `boot.gz`, `boot.xz`,`boot.tar.gz` oder `boot.tar.xz` lautet.
+        * die Datei eine Größe von etwa 1,5-2,0 GB hat.
     * Wenn unklar ist, welches Image für dein Gerät geeignet ist, kannst du im Abschnitt [Unterstützte Geräte](../../devices) überprüfen, welches Image du für dein Gerät herunterladen solltest.
-2. Entpacke das komprimierte Update  (z.B. mit [7-Zip](https://7-zip.org/)).
+2. Entpacke das komprimierte Archiv (z.B. mit [7-Zip](https://7-zip.org/)).
+    * Dateien, deren Namen mit `tar.gz` oder `tar.xz` enden, sind komprimierte Dateien, die zunächst eine weitere komprimierte Datei enthalten. In diesem Fall musst du zunächst die `tar`-Datei aus der `gz`/`xz`-Datei extrahieren, bevor du dann den Inhalt der `tar`-Datei entpacken kannst.
 3. Setz deine SD-Karte deiner KNULLI-Installation in deinen Kartenleser am Computer ein.
-4. Ersetze die Datei `boot/batocera` auf der *BATOCERA*-Partition deiner SD-Karte durch die Datei `boot/batocera.update` aus dem heruntergeladenen Archiv.
+4. Ersetze die Datei `boot/batocera` auf der *BATOCERA*-Partition deiner SD-Karte durch die Datei `boot/batocera.update` aus dem heruntergeladenen Archiv indem du den folgenden Schritten folgst:
+    * **Lösche** die existierende `batocera`-Datei **oder bennene sie um** (z.B. in `batocera.bak`) falls du sie behalten willst, z.B. um im Notfall zur vorherigen KNULLI-Version zurückkehren zu können. (Falls du bereits ein Backup einer vorherigen KNULLI-Version in diesem Ordner hast, solltest du es jetzt evtl. löschen um etwas Platz zu schaffen.)
+    * **Kopiere** die Datei `batocera.update`, die du aus dem **Boot-Package** extrahiert hast, in den `boot`-Ordner der `batocera`-Partition deiner SD-Karte.
+    * **Benenne** die datei `batocera.update` in `batocera` **um**.
 5. Starte das Gerät erneut, um mit dem Updatevorgang zu beginnen!
+
+!!! danger "Re-creating default settings"
+
+     **Normalerweise** erfordern KNULLI-Updates **NICHT** dass du einzelne Dateien oder gar den ganzen `system`-Ordner auf Werkseinstellungen zurücksetzt. In **SEHR seltenen Fällen** kann es allerdings nötig sein, deine Einstellungen an neue KNULLI-Standardeinstellungen anzupassen. In diesen Fällen ist es häufig am einfachsten, die entsprechenden Werkseinstellungen wiederherzustellen, entweder in dem man einzelne Dateien oder ganze Ordner zurücksetzt. Du kannst mehr über das Thema im Abschnitt [Werkseinstellungen](../../configure/reset-to-factory-settings) erfahren. Du solltest dies aber **NIEMALS** tun, wenn du dir nicht absolut sicher bist, dass es notwendig ist!