Git improvements

2025-03-09 01:12:12 +00:00 · 2024-09-16 06:43:19 +00:00 · 2024-09-16 06:43:19 +00:00 · 092c270c5d
commit 092c270c5d
parent 737d5ce68c
26 changed files with 859 additions and 14 deletions
--- a/app/src/main/java/io/xpipe/app/prefs/SyncCategory.java
+++ b/app/src/main/java/io/xpipe/app/prefs/SyncCategory.java
@ -2,17 +2,24 @@ package io.xpipe.app.prefs;

 import atlantafx.base.theme.Styles;
 import io.xpipe.app.comp.base.ButtonComp;
+import io.xpipe.app.comp.base.MarkdownComp;
 import io.xpipe.app.core.AppI18n;
+import io.xpipe.app.core.mode.OperationMode;
+import io.xpipe.app.core.window.AppWindowHelper;
 import io.xpipe.app.fxcomps.Comp;
-import io.xpipe.app.fxcomps.impl.StackComp;
+import io.xpipe.app.fxcomps.impl.HorizontalComp;
+import io.xpipe.app.fxcomps.impl.TextFieldComp;
 import io.xpipe.app.storage.DataStorage;
 import io.xpipe.app.storage.DataStorageSyncHandler;
 import io.xpipe.app.util.DesktopHelper;
 import io.xpipe.app.util.OptionsBuilder;
 import io.xpipe.app.util.ThreadHelper;
 import javafx.application.Platform;
+import javafx.beans.property.SimpleBooleanProperty;
 import javafx.geometry.Insets;
 import javafx.geometry.Pos;
+import javafx.scene.control.Alert;
+import javafx.scene.control.ButtonType;
 import javafx.scene.layout.Region;
 import org.kordamp.ikonli.javafx.FontIcon;

@ -26,22 +33,62 @@ public class SyncCategory extends AppPrefsCategory {
        return "sync";
    }

+
+    private static void showHelpAlert() {
+        AppWindowHelper.showAlert(
+                alert -> {
+                    alert.setTitle(AppI18n.get("gitVault"));
+                    alert.setAlertType(Alert.AlertType.NONE);
+
+                    var activated = AppI18n.get().getMarkdownDocumentation("app:vault");
+                    var markdown = new MarkdownComp(activated, s -> s)
+                            .prefWidth(550)
+                            .prefHeight(550)
+                            .createRegion();
+                    alert.getDialogPane().setContent(markdown);
+                    alert.getButtonTypes().add(ButtonType.OK);
+                },
+                buttonType -> {});
+    }
+
    public Comp<?> create() {
        var prefs = AppPrefs.get();
        AtomicReference<Region> button = new AtomicReference<>();
-        var terminalTest = new StackComp(
-                List.of(new ButtonComp(AppI18n.observable("test"), new FontIcon("mdi2p-play"), () -> {
-                    ThreadHelper.runAsync(() -> {
-                        var r = DataStorageSyncHandler.getInstance().validateConnection();
-                        if (r) {
-                            Platform.runLater(() -> {
-                                button.get().getStyleClass().add(Styles.SUCCESS);
-                            });
-                        }
+
+        var canRestart = new SimpleBooleanProperty(false);
+        var testButton = new ButtonComp(AppI18n.observable("test"), new FontIcon("mdi2p-play"), () -> {
+            ThreadHelper.runAsync(() -> {
+                var r = DataStorageSyncHandler.getInstance().validateConnection();
+                if (r) {
+                    Platform.runLater(() -> {
+                        button.get().getStyleClass().add(Styles.SUCCESS);
+                        canRestart.set(true);
                    });
-                }).apply(struc -> button.set(struc.get())).padding(new Insets(6, 10, 6, 6))))
+                }
+            });
+        });
+        testButton.apply(struc -> button.set(struc.get()));
+        testButton.padding(new Insets(6, 10, 6, 6));
+
+        var restartButton = new ButtonComp(AppI18n.observable("restart"), new FontIcon("mdi2r-restart"), () -> {
+            OperationMode.restart();
+        });
+        restartButton.visible(canRestart);
+        restartButton.padding(new Insets(6, 10, 6, 6));
+
+        var testRow = new HorizontalComp(
+                List.of(testButton, restartButton))
+                .spacing(10)
                .padding(new Insets(10, 0, 0, 0))
                .apply(struc -> struc.get().setAlignment(Pos.CENTER_LEFT));
+
+        var remoteRepo = new TextFieldComp(prefs.storageGitRemote).hgrow();
+        var helpButton = new ButtonComp(AppI18n.observable("help"), new FontIcon("mdi2h-help-circle-outline"), () -> {
+            showHelpAlert();
+        });
+        var remoteRow = new HorizontalComp(List.of(remoteRepo, helpButton)).spacing(10);
+        remoteRow.apply(struc -> struc.get().setAlignment(Pos.CENTER_LEFT));
+
        var builder = new OptionsBuilder();
        builder.addTitle("sync")
                .sub(new OptionsBuilder()
@ -49,9 +96,9 @@ public class SyncCategory extends AppPrefsCategory {
                        .description("enableGitStorageDescription")
                        .addToggle(prefs.enableGitStorage)
                        .nameAndDescription("storageGitRemote")
-                        .addString(prefs.storageGitRemote)
+                        .addComp(remoteRow, prefs.storageGitRemote)
                        .disable(prefs.enableGitStorage.not())
-                        .addComp(terminalTest)
+                        .addComp(testRow)
                        .disable(prefs.storageGitRemote.isNull().or(prefs.enableGitStorage.not()))
                        .addComp(prefs.getCustomComp("gitVaultIdentityStrategy"))
                        .nameAndDescription("openDataDir")
--- a/core/src/main/java/io/xpipe/core/process/ProcessOutputException.java
+++ b/core/src/main/java/io/xpipe/core/process/ProcessOutputException.java
@ -29,6 +29,12 @@ public class ProcessOutputException extends Exception {
        return new ProcessOutputException(message, ex.getExitCode(), ex.getOutput());
    }

+    public static ProcessOutputException withSuffix(String customSuffix, ProcessOutputException ex) {
+        var messagePrefix = ex.getOutput() != null && !ex.getOutput().isBlank() ? ex.getOutput() + "\n" : "";
+        var message = messagePrefix + customSuffix;
+        return new ProcessOutputException(message, ex.getExitCode(), ex.getOutput());
+    }
+
    public static ProcessOutputException of(long exitCode, String... messages) {
        var combinedError = Arrays.stream(messages)
                .filter(s -> s != null && !s.isBlank())
--- a/lang/app/strings/translations_da.properties
+++ b/lang/app/strings/translations_da.properties
@ -513,3 +513,4 @@ enableHttpApi=Aktiver HTTP API
 enableHttpApiDescription=Aktiverer API'en, så eksterne programmer kan kalde XPipe-dæmonen for at udføre handlinger med dine administrerede forbindelser.
 chooseCustomIcon=Vælg et brugerdefineret ikon
 clear=Rydde
+gitVault=Git-hvælving
--- a/lang/app/strings/translations_de.properties
+++ b/lang/app/strings/translations_de.properties
@ -507,3 +507,4 @@ enableHttpApi=HTTP-API aktivieren
 enableHttpApiDescription=Aktiviert die API, damit externe Programme den XPipe-Daemon aufrufen können, um Aktionen mit deinen verwalteten Verbindungen durchzuführen.
 chooseCustomIcon=Benutzerdefiniertes Symbol auswählen
 clear=Löschen
+gitVault=Git-Tresor
--- a/lang/app/strings/translations_en.properties
+++ b/lang/app/strings/translations_en.properties
@ -511,4 +511,5 @@ enableHttpApi=Enable HTTP API
 enableHttpApiDescription=Enables the API, allowing external programs to call the XPipe daemon to perform actions with your managed connections.
 chooseCustomIcon=Choose custom icon
 #context: verb, to delete
-clear=Clear
+clear=Clear
+gitVault=Git vault
--- a/lang/app/strings/translations_es.properties
+++ b/lang/app/strings/translations_es.properties
@ -494,3 +494,4 @@ enableHttpApi=Activar la API HTTP
 enableHttpApiDescription=Habilita la API, permitiendo que programas externos llamen al demonio XPipe para realizar acciones con tus conexiones gestionadas.
 chooseCustomIcon=Elegir icono personalizado
 clear=Borrar
+gitVault=Bóveda Git
--- a/lang/app/strings/translations_fr.properties
+++ b/lang/app/strings/translations_fr.properties
@ -494,3 +494,4 @@ enableHttpApi=Activer l'API HTTP
 enableHttpApiDescription=Active l'API, ce qui permet aux programmes externes d'appeler le démon XPipe pour effectuer des actions avec tes connexions gérées.
 chooseCustomIcon=Choisis une icône personnalisée
 clear=Effacer
+gitVault=Coffre-fort Git
--- a/lang/app/strings/translations_it.properties
+++ b/lang/app/strings/translations_it.properties
@ -494,3 +494,4 @@ enableHttpApi=Abilita l'API HTTP
 enableHttpApiDescription=Abilita l'API, consentendo ai programmi esterni di chiamare il demone XPipe per eseguire azioni con le connessioni gestite.
 chooseCustomIcon=Scegli un'icona personalizzata
 clear=Cancellare
+gitVault=Git vault
--- a/lang/app/strings/translations_ja.properties
+++ b/lang/app/strings/translations_ja.properties
@ -494,3 +494,4 @@ enableHttpApi=HTTP APIを有効にする
 enableHttpApiDescription=APIを有効にし、外部プログラムからXPipeデーモンを呼び出して、管理されている接続に対してアクションを実行できるようにする。
 chooseCustomIcon=カスタムアイコンを選ぶ
 clear=消去する
+gitVault=Git保管庫
--- a/lang/app/strings/translations_nl.properties
+++ b/lang/app/strings/translations_nl.properties
@ -494,3 +494,4 @@ enableHttpApi=HTTP API inschakelen
 enableHttpApiDescription=Schakelt de API in, waardoor externe programma's de XPipe daemon kunnen aanroepen om acties uit te voeren met je beheerde verbindingen.
 chooseCustomIcon=Aangepast pictogram kiezen
 clear=Wis
+gitVault=Git kluis
--- a/lang/app/strings/translations_pt.properties
+++ b/lang/app/strings/translations_pt.properties
@ -494,3 +494,4 @@ enableHttpApi=Ativar a API HTTP
 enableHttpApiDescription=Habilita a API, permitindo que programas externos chamem o daemon XPipe para executar ações com suas conexões gerenciadas.
 chooseCustomIcon=Escolhe um ícone personalizado
 clear=Limpar
+gitVault=Cofre do Git
--- a/lang/app/strings/translations_ru.properties
+++ b/lang/app/strings/translations_ru.properties
@ -494,3 +494,4 @@ enableHttpApi=Включить HTTP API
 enableHttpApiDescription=Включает API, позволяя внешним программам вызывать демона XPipe для выполнения действий с твоими управляемыми соединениями.
 chooseCustomIcon=Выберите пользовательскую иконку
 clear=Очистить
+gitVault=Git vault
--- a/lang/app/strings/translations_tr.properties
+++ b/lang/app/strings/translations_tr.properties
@ -495,3 +495,4 @@ enableHttpApi=HTTP API'yi Etkinleştir
 enableHttpApiDescription=API'yi etkinleştirerek harici programların yönetilen bağlantılarınızla eylemler gerçekleştirmek için XPipe arka plan programını çağırmasına izin verir.
 chooseCustomIcon=Özel simge seçin
 clear=Temiz
+gitVault=Git kasası
--- a/lang/app/strings/translations_zh.properties
+++ b/lang/app/strings/translations_zh.properties
@ -494,3 +494,4 @@ enableHttpApi=启用 HTTP API
 enableHttpApiDescription=启用 API，允许外部程序调用 XPipe 守护进程，对管理连接执行操作。
 chooseCustomIcon=选择自定义图标
 clear=清除
+gitVault=Git 数据库
--- a/lang/app/texts/vault_da.md
+++ b/lang/app/texts/vault_da.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe kan synkronisere alle dine forbindelsesdata med dit eget git remote repository. Du kan synkronisere med dette depot i alle XPipe-applikationsforekomster på samme måde, og alle ændringer, du foretager i en forekomst, afspejles i depotet.
+
+Først og fremmest skal du oprette et remote repository med din foretrukne git-udbyder. Dette repository skal være privat.
+Derefter kan du bare kopiere og indsætte URL'en i XPipes indstilling for remote repository.
+
+Du skal også have en lokalt installeret `git`-klient klar på din lokale maskine. Du kan prøve at køre `git` i en lokal terminal for at tjekke.
+Hvis du ikke har en, kan du besøge [https://git-scm.com](https://git-scm.com/) for at installere git.
+
+## Autentificering til fjerndepotet
+
+Der er flere måder at godkende på. De fleste repositorier bruger HTTPS, hvor du skal angive et brugernavn og en adgangskode.
+Nogle udbydere understøtter også SSH-protokollen, som også understøttes af XPipe.
+Hvis du bruger SSH til git, ved du sikkert, hvordan du skal konfigurere det, så dette afsnit handler kun om HTTPS.
+
+Du skal sætte din git CLI op til at kunne autentificere med dit eksterne git-repository via HTTPS. Der er flere måder at gøre det på.
+Du kan tjekke, om det allerede er gjort, ved at genstarte XPipe, når et fjernlager er konfigureret.
+Hvis den beder dig om dine login-oplysninger, skal du sætte dem op.
+
+Mange specialværktøjer som dette [GitHub CLI] (https://cli.github.com/) gør alt automatisk for dig, når det er installeret.
+Nogle nyere versioner af git-klienter kan også autentificere via særlige webtjenester, hvor du bare skal logge ind på din konto i din browser.
+
+Der er også manuelle måder at autentificere sig på via et brugernavn og et token.
+I dag kræver de fleste udbydere et personligt adgangstoken (PAT) for at godkende fra kommandolinjen i stedet for traditionelle adgangskoder.
+Du kan finde almindelige (PAT)-sider her:
+- **GitHub**: [Personal access tokens (classic)](https://github.com/settings/tokens)
+- **GitLab**: [Personligt adgangstoken](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Personligt adgangstoken](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Indstillinger -> Applikationer -> Administrer adgangstoken`
+Indstil tokentilladelsen for repository til Read og Write. Resten af tokentilladelserne kan indstilles som Read.
+Selv om din git-klient beder dig om en adgangskode, bør du indtaste dit token, medmindre din udbyder stadig bruger adgangskoder.
+- De fleste udbydere understøtter ikke længere adgangskoder.
+
+Hvis du ikke ønsker at indtaste dine legitimationsoplysninger hver gang, kan du bruge en hvilken som helst git-legitimationshåndtering til det.
+For mere information, se f.eks:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Nogle moderne git-klienter sørger også for at gemme legitimationsoplysninger automatisk.
+
+Hvis alt fungerer, bør XPipe sende en commit til dit fjernrepository.
+
+## Tilføjelse af kategorier til depotet
+
+Som standard er ingen forbindelseskategorier sat til at synkronisere, så du har eksplicit kontrol over, hvilke forbindelser der skal commit'es.
+Så i starten vil dit remote repository være tomt.
+
+For at få dine forbindelser i en kategori lagt ind i dit git-repository,
+skal du klikke på tandhjulsikonet (når du holder musen over kategorien)
+i fanen `Forbindelser` under kategorioversigten i venstre side.
+Klik derefter på `Add to git repository` for at synkronisere kategorien og forbindelserne til dit git-repository.
+Dette vil tilføje alle synkroniserbare forbindelser til git-repository'et.
+
+## Lokale forbindelser synkroniseres ikke
+
+Enhver forbindelse, der ligger under den lokale maskine, kan ikke deles, da den henviser til forbindelser og data, der kun er tilgængelige på det lokale system.
+
+Visse forbindelser, der er baseret på en lokal fil, f.eks. SSH-konfigurationer, kan deles via git, hvis de underliggende data, i dette tilfælde filen, også er blevet føjet til git-repository'et.
+
+## Tilføjelse af filer til git
+
+Når alt er sat op, har du mulighed for at tilføje yderligere filer som f.eks. SSH-nøgler til git.
+Ved siden af hvert filvalg er der en git-knap, som tilføjer filen til git-repository'et.
+Disse filer er også krypterede, når de skubbes.
--- a/lang/app/texts/vault_de.md
+++ b/lang/app/texts/vault_de.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe kann alle deine Verbindungsdaten mit deinem eigenen Git Remote Repository synchronisieren. Du kannst mit diesem Repository in allen XPipe-Anwendungsinstanzen auf die gleiche Weise synchronisieren, d.h. jede Änderung, die du in einer Instanz vornimmst, wird in das Repository übernommen.
+
+Als Erstes musst du ein Remote-Repository mit einem Git-Anbieter deiner Wahl erstellen. Dieses Repository muss privat sein.
+Dann kannst du die URL einfach kopieren und in die XPipe-Einstellungen für das Remote-Repository einfügen.
+
+Außerdem brauchst du einen lokal installierten `git`-Client auf deinem lokalen Rechner. Du kannst versuchen, `git` in einem lokalen Terminal auszuführen, um das zu überprüfen.
+Wenn du keinen hast, kannst du [https://git-scm.com](https://git-scm.com/) besuchen, um Git zu installieren.
+
+## Authentifizierung gegenüber dem entfernten Repository
+
+Es gibt mehrere Möglichkeiten, sich zu authentifizieren. Die meisten Repositories verwenden HTTPS, bei dem du einen Benutzernamen und ein Passwort angeben musst.
+Einige Anbieter unterstützen auch das SSH-Protokoll, das auch von XPipe unterstützt wird.
+Wenn du SSH für Git verwendest, weißt du wahrscheinlich, wie man es konfiguriert, daher wird in diesem Abschnitt nur auf HTTPS eingegangen.
+
+Du musst dein Git CLI so einrichten, dass es sich bei deinem entfernten Git-Repository über HTTPS authentifizieren kann. Es gibt mehrere Möglichkeiten, das zu tun.
+Du kannst überprüfen, ob dies bereits geschehen ist, indem du XPipe neu startest, sobald ein entferntes Repository konfiguriert ist.
+Wenn XPipe dich nach deinen Anmeldedaten fragt, musst du sie einrichten.
+
+Viele spezielle Tools wie dieses [GitHub CLI] (https://cli.github.com/) erledigen alles automatisch für dich, wenn es installiert ist.
+Einige neuere Git-Client-Versionen können sich auch über spezielle Webdienste authentifizieren, bei denen du dich einfach in deinem Browser bei deinem Konto anmelden musst.
+
+Es gibt auch manuelle Möglichkeiten, sich mit einem Benutzernamen und einem Token zu authentifizieren.
+Heutzutage verlangen die meisten Anbieter für die Authentifizierung über die Kommandozeile ein Personal Access Token (PAT) anstelle eines herkömmlichen Passworts.
+Gängige (PAT) Seiten findest du hier:
+- **GitHub**: [Persönliche Zugangstoken (klassisch)](https://github.com/settings/tokens)
+- **GitLab**: [Persönliche Zugangstoken](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Persönliches Zugriffstoken](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Einstellungen -> Anwendungen -> Abschnitt Zugriffstoken verwalten`
+Setze die Token-Berechtigung für das Repository auf Lesen und Schreiben. Die übrigen Token-Berechtigungen können auf Lesen gesetzt werden.
+Auch wenn dein Git-Client dich zur Eingabe eines Passworts auffordert, solltest du dein Token eingeben, es sei denn, dein Anbieter verwendet noch Passwörter.
+- Die meisten Anbieter unterstützen keine Passwörter mehr.
+
+Wenn du deine Anmeldedaten nicht jedes Mal eingeben willst, kannst du dafür einen beliebigen Git-Anmeldemanager verwenden.
+Weitere Informationen findest du zum Beispiel unter:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Einige moderne Git-Clients kümmern sich auch automatisch um die Speicherung der Anmeldeinformationen.
+
+Wenn alles klappt, sollte XPipe einen Commit an dein entferntes Repository senden.
+
+## Kategorien zum Repository hinzufügen
+
+Standardmäßig sind keine Verbindungskategorien für die Synchronisierung eingestellt, damit du explizit festlegen kannst, welche Verbindungen übertragen werden sollen.
+Zu Beginn ist dein entferntes Projektarchiv also leer.
+
+Um die Verbindungen einer Kategorie in dein Git-Repository zu übertragen
+musst du auf das Zahnradsymbol klicken (wenn du den Mauszeiger über die Kategorie bewegst)
+in deinem `Reiter Verbindungen` unter der Kategorieübersicht auf der linken Seite.
+Klicke dann auf `Zum Git-Repository hinzufügen`, um die Kategorie und die Verbindungen mit deinem Git-Repository zu synchronisieren.
+Dadurch werden alle synchronisierbaren Verbindungen zum Git-Repository hinzugefügt.
+
+## Lokale Verbindungen werden nicht synchronisiert
+
+Alle Verbindungen, die sich unter dem lokalen Rechner befinden, können nicht synchronisiert werden, da sie sich auf Verbindungen und Daten beziehen, die nur auf dem lokalen System verfügbar sind.
+
+Bestimmte Verbindungen, die auf einer lokalen Datei basieren, z. B. SSH-Konfigurationen, können über Git geteilt werden, wenn die zugrundeliegenden Daten, in diesem Fall die Datei, ebenfalls zum Git-Repository hinzugefügt wurden.
+
+## Dateien zu git hinzufügen
+
+Wenn alles eingerichtet ist, hast du die Möglichkeit, zusätzliche Dateien wie SSH-Schlüssel zu git hinzuzufügen.
+Neben jeder Datei befindet sich ein Git-Button, mit dem die Datei zum Git-Repository hinzugefügt wird.
+Auch diese Dateien werden verschlüsselt, wenn sie veröffentlicht werden.
--- a/lang/app/texts/vault_en.md
+++ b/lang/app/texts/vault_en.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe can synchronize all your connection data with your own git remote repository. You can sync with this repository in all XPipe application instances the same way, every change you make in one instance will be reflected in the repository.
+
+First of all, you need to create a remote repository with your favourite git provider of choice. This repository has to be private.
+You can then just copy and paste the URL into the XPipe remote repository setting.
+
+You also need to have a locally installed `git` client ready on your local machine. You can try running `git` in a local terminal to check.
+If you don't have one, you can visit [https://git-scm.com](https://git-scm.com/) to install git.
+
+## Authenticating to the remote repository
+
+There are multiple ways to authenticate. Most repositories use HTTPS where you have to specify a username and password.
+Some providers also support the SSH protocol, which is also supported by XPipe.
+If you use SSH for git, you probably know how to configure it, so this section will cover HTTPS only.
+
+You need to set up your git CLI to be able to authenticate with your remote git repository via HTTPS. There are multiple ways to do that.
+You can check if that is already done by restarting XPipe once a remote repository is configured.
+If it asks you for your login credentials, you need to set it up.
+
+Many special tools like this [GitHub CLI](https://cli.github.com/) do everything automatically for you when installed.
+Some newer git client versions can also authenticate via special web services where you just have to log in into your account in your browser.
+
+There are also manual ways to authenticate via a username and token.
+Nowadays, most providers require a personal access token (PAT) to authenticate from the command-line instead of traditional passwords.
+You can find common (PAT) pages here:
+- **GitHub**: [Personal access tokens (classic)](https://github.com/settings/tokens)
+- **GitLab**: [Personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Personal access token](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Settings -> Applications -> Manage Access Tokens section`
+Set the token permission for repository to Read and Write. The rest of the token permissions can be set as Read.
+Even if your git client prompts you for a password, you should enter your token unless your provider still uses passwords.
+- Most providers do not support passwords anymore.
+
+If you don't want to enter your credentials every time, you can use any git credentials manager for that.
+For more information, see for example:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Some modern git clients also take care of storing credentials automatically.
+
+If everything works out, XPipe should push a commit to your remote repository.
+
+## Adding categories to the repository
+
+By default, no connection categories are set to sync so that you have explicit control on what connections to commit.
+So at the start, your remote repository will be empty.
+
+To have your connections of a category put inside your git repository,
+you need to click on the gear icon (when hovering over the category)
+in your `Connections` tab under the category overview on the left side.
+Then click on `Add to git repository` to sync the category and connections to your git repository.
+This will add all syncable connections to the git repository.
+
+## Local connections are not synced
+
+Any connection located under the local machine can not be shared as it refers to connections and data that are only available on the local system.
+
+Certain connections that are based on a local file, for example SSH configs, can be shared via git if the underlying data, in this case the file, have been added to the git repository as well.
+
+## Adding files to git
+
+When everything is set up, you have the option to add any additional files such as SSH keys to git as well.
+Next to every file choice is a git button that will add the file to the git repository.
+These files are also encrypted when pushed.
--- a/lang/app/texts/vault_es.md
+++ b/lang/app/texts/vault_es.md
@ -0,0 +1,65 @@
+# Bóveda Git XPipe
+
+XPipe puede sincronizar todos tus datos de conexión con tu propio repositorio remoto git. Puedes sincronizar con este repositorio en todas las instancias de la aplicación XPipe de la misma manera, cada cambio que hagas en una instancia se reflejará en el repositorio.
+
+En primer lugar, necesitas crear un repositorio remoto con el proveedor git que prefieras. Este repositorio tiene que ser privado.
+A continuación, sólo tienes que copiar y pegar la URL en la configuración del repositorio remoto de XPipe.
+
+También necesitas tener un cliente `git` instalado localmente en tu máquina local. Puedes probar a ejecutar `git` en un terminal local para comprobarlo.
+Si no tienes uno, puedes visitar [https://git-scm.com](https://git-scm.com/) para instalar git.
+
+## Autenticarse en el repositorio remoto
+
+Hay varias formas de autenticarse. La mayoría de los repositorios utilizan HTTPS, donde tienes que especificar un nombre de usuario y una contraseña.
+Algunos proveedores también admiten el protocolo SSH, que también es compatible con XPipe.
+Si utilizas SSH para git, probablemente sepas cómo configurarlo, así que esta sección cubrirá sólo HTTPS.
+
+Necesitas configurar tu CLI de git para poder autenticarte con tu repositorio git remoto a través de HTTPS. Hay varias formas de hacerlo.
+Puedes comprobar si ya está hecho reiniciando XPipe una vez configurado un repositorio remoto.
+Si te pide tus credenciales de acceso, necesitas configurarlas.
+
+Muchas herramientas especiales como esta [GitHub CLI](https://cli.github.com/) lo hacen todo automáticamente por ti cuando se instalan.
+Algunas versiones más recientes del cliente git también pueden autenticarse a través de servicios web especiales en los que sólo tienes que acceder a tu cuenta en el navegador.
+
+También hay formas manuales de autenticarse mediante un nombre de usuario y un token.
+Hoy en día, la mayoría de los proveedores requieren un token de acceso personal (PAT) para autenticarse desde la línea de comandos en lugar de las contraseñas tradicionales.
+Puedes encontrar páginas comunes (PAT) aquí:
+- **GitHub**: [Tokens de acceso personal (clásico)](https://github.com/settings/tokens)
+- **GitLab**: [Ficha de acceso personal](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Clave de acceso personal](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Configuración -> Aplicaciones -> Sección Gestionar tokens de acceso`
+Establece el permiso del token para el repositorio en Lectura y Escritura. El resto de permisos del token pueden establecerse como Lectura.
+Aunque tu cliente git te pida una contraseña, debes introducir tu token a menos que tu proveedor aún utilice contraseñas.
+- La mayoría de los proveedores ya no admiten contraseñas.
+
+Si no quieres introducir tus credenciales cada vez, puedes utilizar cualquier gestor de credenciales git para ello.
+Para más información, consulta por ejemplo
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Algunos clientes git modernos también se encargan de almacenar las credenciales automáticamente.
+
+Si todo va bien, XPipe debería enviar un commit a tu repositorio remoto.
+
+## Añadir categorías al repositorio
+
+Por defecto, no se establecen categorías de conexión para sincronizar, de modo que tengas un control explícito sobre qué conexiones confirmar.
+Así que al principio, tu repositorio remoto estará vacío.
+
+Para que tus conexiones de una categoría se pongan dentro de tu repositorio git,
+tienes que hacer clic en el icono del engranaje (al pasar el ratón por encima de la categoría)
+en la pestaña `Conexiones` de la vista general de la categoría, a la izquierda.
+Luego haz clic en `Añadir al repositorio git` para sincronizar la categoría y las conexiones con tu repositorio git.
+Esto añadirá todas las conexiones sincronizables al repositorio git.
+
+## Las conexiones locales no se sincronizan
+
+Cualquier conexión localizada en la máquina local no se puede compartir, ya que se refiere a conexiones y datos que sólo están disponibles en el sistema local.
+
+Algunas conexiones que se basan en un archivo local, por ejemplo las configuraciones SSH, pueden compartirse a través de git si los datos subyacentes, en este caso el archivo, se han añadido también al repositorio git.
+
+## Añadir archivos a git
+
+Cuando todo esté configurado, tienes la opción de añadir también a git cualquier archivo adicional, como claves SSH.
+Junto a cada archivo elegido hay un botón git que añadirá el archivo al repositorio git.
+Estos archivos también se encriptan cuando se envían.
--- a/lang/app/texts/vault_fr.md
+++ b/lang/app/texts/vault_fr.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe peut synchroniser toutes tes données de connexion avec ton propre dépôt distant git. Tu peux te synchroniser avec ce dépôt dans toutes les instances de l'application XPipe de la même manière, chaque changement que tu fais dans une instance sera reflété dans le dépôt.
+
+Tout d'abord, tu dois créer un dépôt distant avec le fournisseur git de ton choix. Ce dépôt doit être privé.
+Il te suffit ensuite de copier et de coller l'URL dans les paramètres du dépôt à distance de XPipe.
+
+Tu dois également avoir un client `git` installé localement et prêt sur ta machine locale. Tu peux essayer d'exécuter `git` dans un terminal local pour vérifier.
+Si tu n'en as pas, tu peux visiter [https://git-scm.com](https://git-scm.com/) pour installer git.
+
+## S'authentifier auprès du dépôt distant
+
+Il y a plusieurs façons de s'authentifier. La plupart des dépôts utilisent le protocole HTTPS pour lequel tu dois spécifier un nom d'utilisateur et un mot de passe.
+Certains fournisseurs prennent également en charge le protocole SSH, qui est également pris en charge par XPipe.
+Si tu utilises SSH pour git, tu sais probablement comment le configurer, c'est pourquoi cette section ne traitera que du HTTPS.
+
+Tu dois configurer ton CLI git pour pouvoir t'authentifier auprès de ton dépôt git distant via HTTPS. Il y a plusieurs façons de le faire.
+Tu peux vérifier si c'est déjà fait en redémarrant XPipe une fois qu'un dépôt distant est configuré.
+S'il te demande tes identifiants de connexion, tu dois les configurer.
+
+De nombreux outils spéciaux comme ce [GitHub CLI] (https://cli.github.com/) font tout automatiquement pour toi lorsqu'ils sont installés.
+Certaines versions plus récentes du client git peuvent également s'authentifier via des services web spéciaux où il te suffit de te connecter à ton compte dans ton navigateur.
+
+Il existe également des moyens manuels de s'authentifier via un nom d'utilisateur et un jeton.
+De nos jours, la plupart des fournisseurs exigent un jeton d'accès personnel (PAT) pour s'authentifier à partir de la ligne de commande au lieu des mots de passe traditionnels.
+Tu peux trouver des pages communes (PAT) ici :
+- **GitHub** : [Jetons d'accès personnels (classiques)](https://github.com/settings/tokens)
+- **GitLab** : [Jeton d'accès personnel](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket** : [Jeton d'accès personnel](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea** : `Paramètres -> Applications -> Section Gérer les jetons d'accès`
+Définis la permission du jeton pour le référentiel sur Lecture et Écriture. Le reste des permissions du jeton peut être défini comme Lecture.
+Même si ton client git te demande un mot de passe, tu dois saisir ton jeton, sauf si ton fournisseur utilise encore des mots de passe.
+- La plupart des fournisseurs ne prennent plus en charge les mots de passe.
+
+Si tu ne veux pas entrer tes informations d'identification à chaque fois, tu peux utiliser n'importe quel gestionnaire d'informations d'identification git pour cela.
+Pour plus d'informations, voir par exemple :
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Certains clients git modernes se chargent également de stocker les informations d'identification automatiquement.
+
+Si tout se passe bien, XPipe devrait pousser un commit vers ton dépôt distant.
+
+## Ajouter des catégories au dépôt
+
+Par défaut, aucune catégorie de connexion n'est définie pour la synchronisation afin que tu aies un contrôle explicite sur les connexions à valider.
+Ainsi, au début, ton dépôt distant sera vide.
+
+Pour que les connexions d'une catégorie soient placées à l'intérieur de ton dépôt git, tu dois cliquer sur l'icône de l'engrenage,
+tu dois cliquer sur l'icône de l'engrenage (lorsque tu survoles la catégorie)
+dans ton onglet `Connexions` sous l'aperçu de la catégorie sur le côté gauche.
+Cliquez ensuite sur `Ajouter au dépôt git` pour synchroniser la catégorie et les connexions avec votre dépôt git.
+Cela ajoutera toutes les connexions synchronisables au dépôt git.
+
+## Les connexions locales ne sont pas synchronisées
+
+Toute connexion située sous la machine locale ne peut pas être partagée car elle fait référence à des connexions et des données qui ne sont disponibles que sur le système local.
+
+Certaines connexions basées sur un fichier local, par exemple les configurations SSH, peuvent être partagées via git si les données sous-jacentes, dans ce cas le fichier, ont également été ajoutées au dépôt git.
+
+## Ajouter des fichiers à git
+
+Lorsque tout est configuré, tu as la possibilité d'ajouter à git des fichiers supplémentaires tels que des clés SSH.
+À côté de chaque choix de fichier se trouve un bouton git qui ajoutera le fichier au dépôt git.
+Ces fichiers sont également cryptés lorsqu'ils sont poussés.
--- a/lang/app/texts/vault_it.md
+++ b/lang/app/texts/vault_it.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe può sincronizzare tutti i dati delle tue connessioni con il tuo repository git remoto. Puoi sincronizzarti con questo repository in tutte le istanze dell'applicazione XPipe allo stesso modo: ogni modifica apportata in un'istanza si rifletterà nel repository.
+
+Prima di tutto, devi creare un repository remoto con il tuo provider git preferito. Questo repository deve essere privato.
+A questo punto puoi semplicemente copiare e incollare l'URL nell'impostazione del repository remoto di XPipe.
+
+Devi anche avere un client `git` installato localmente sul tuo computer locale. Puoi provare a eseguire `git` in un terminale locale per verificare.
+Se non ne hai uno, puoi visitare [https://git-scm.com](https://git-scm.com/) per installare git.
+
+## Autenticazione al repository remoto
+
+Esistono diversi modi per autenticarsi. La maggior parte dei repository utilizza il protocollo HTTPS in cui è necessario specificare un nome utente e una password.
+Alcuni provider supportano anche il protocollo SSH, che è supportato anche da XPipe.
+Se utilizzi SSH per git, probabilmente sai come configurarlo, quindi questa sezione tratterà solo l'HTTPS.
+
+Devi impostare la tua git CLI in modo che sia in grado di autenticarsi con il repository git remoto tramite HTTPS. Ci sono diversi modi per farlo.
+Puoi verificare se è già stato fatto riavviando XPipe una volta configurato un repository remoto.
+Se ti chiede le credenziali di accesso, devi impostarle.
+
+Molti strumenti speciali come questo [GitHub CLI](https://cli.github.com/) fanno tutto automaticamente quando vengono installati.
+Alcune versioni più recenti del client git possono anche autenticarsi tramite servizi web speciali in cui è sufficiente accedere al proprio account nel browser.
+
+Esistono anche modi manuali per autenticarsi tramite un nome utente e un token.
+Al giorno d'oggi, la maggior parte dei provider richiede un token di accesso personale (PAT) per l'autenticazione da riga di comando al posto della tradizionale password.
+Puoi trovare le pagine comuni (PAT) qui:
+- **GitHub**: [Token di accesso personale (classico)](https://github.com/settings/tokens)
+- **GitLab**: [Token di accesso personale](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Token di accesso personale](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Impostazioni -> Applicazioni -> Sezione Gestione dei token di accesso`
+Imposta i permessi del token per il repository su Lettura e Scrittura. Gli altri permessi del token possono essere impostati come Lettura.
+Anche se il tuo client git ti chiede una password, devi inserire il tuo token a meno che il tuo provider non usi ancora le password.
+- La maggior parte dei provider non supporta più le password.
+
+Se non vuoi inserire le tue credenziali ogni volta, puoi utilizzare un qualsiasi gestore di credenziali git.
+Per maggiori informazioni, vedi ad esempio:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Alcuni client git moderni si occupano anche di memorizzare automaticamente le credenziali.
+
+Se tutto funziona, XPipe dovrebbe inviare un commit al tuo repository remoto.
+
+## Aggiunta di categorie al repository
+
+Per impostazione predefinita, non vengono impostate categorie di connessioni da sincronizzare, in modo da avere un controllo esplicito su quali connessioni effettuare il commit.
+All'inizio, quindi, il tuo repository remoto sarà vuoto.
+
+Per inserire le connessioni di una categoria nel tuo repository git,
+devi cliccare sull'icona dell'ingranaggio (quando passi il mouse sulla categoria)
+nella scheda `Collegamenti` sotto la panoramica delle categorie sul lato sinistro.
+Poi clicca su `Aggiungi al repository git` per sincronizzare la categoria e le connessioni al tuo repository git.
+In questo modo tutte le connessioni sincronizzabili verranno aggiunte al repository git.
+
+## Le connessioni locali non vengono sincronizzate
+
+Tutte le connessioni che si trovano sul computer locale non possono essere condivise perché si riferiscono a connessioni e dati che sono disponibili solo sul sistema locale.
+
+Alcune connessioni basate su un file locale, ad esempio le configurazioni SSH, possono essere condivise tramite git se i dati sottostanti, in questo caso il file, sono stati aggiunti al repository git.
+
+## Aggiungere file a git
+
+Quando tutto è pronto, hai la possibilità di aggiungere a git anche altri file, come le chiavi SSH.
+Accanto a ogni file scelto c'è un pulsante git che aggiunge il file al repository git.
+Anche questi file vengono crittografati quando vengono inviati.
--- a/lang/app/texts/vault_ja.md
+++ b/lang/app/texts/vault_ja.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipeは、すべての接続データを独自のgitリモートリポジトリと同期することができる。このリポジトリは、すべてのXPipeアプリケーションインスタンスで同じように同期でき、あるインスタンスで行ったすべての変更がリポジトリに反映される。
+
+まず最初に、お気に入りのgitプロバイダでリモートリポジトリを作成する必要がある。このリポジトリはプライベートでなければならない。
+そして、そのURLをXPipeのリモートリポジトリ設定にコピー＆ペーストすればよい。
+
+また、ローカルマシンに`git`クライアントをインストールしておく必要がある。ローカルターミナルで`git`を実行して確認できる。
+持っていない場合は、[https://git-scm.com](https://git-scm.com/) にアクセスして git をインストールすることができる。
+
+## リモートリポジトリを認証する
+
+認証には複数の方法がある。ほとんどのリポジトリは HTTPS を使っており、ユーザー名とパスワードを指定する必要がある。
+プロバイダによっては SSH プロトコルをサポートしているところもあり、XPipe でもサポートしている。
+git で SSH を使っている人なら、おそらく設定方法は知っていると思うので、ここでは HTTPS についてのみ説明する。
+
+リモートの git リポジトリと HTTPS 経由で認証できるように git CLI を設定する必要がある。それには複数の方法がある。
+リモートリポジトリの設定が完了したら、XPipe を再起動することで設定が完了しているかどうかを確認できる。
+ログイン認証情報の入力を求められたら、それを設定する必要がある。
+
+この[GitHub CLI](https://cli.github.com/)のような特別なツールの多くは、インストールすると自動的にすべてをやってくれる。
+新しいバージョンの git クライアントの中には、特別なウェブサービスを使って認証できるものもあり、その場合はブラウザで自分のアカウントにログインするだけでよい。
+
+ユーザー名とトークンを使って手動で認証する方法もある。
+現在では、ほとんどのプロバイダが、コマンドラインからの認証に、従来のパスワードの代わりにパーソナル・アクセストークン（PAT）を要求している。
+一般的な(PAT)ページはこちら：
+- **GitHub**：[個人アクセストークン（クラシック）](https://github.com/settings/tokens)
+- **GitLab**：[個人アクセストークン](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [個人アクセストークン]()[個人アクセストークン](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Settings -> Applications -> Manage Access Tokens セクション`。
+リポジトリのトークン権限をReadとWriteに設定する。残りのトークンのパーミッションはReadに設定できる。
+gitクライアントがパスワードの入力を促しても、プロバイダーがまだパスワードを使っていない限り、トークンを入力する必要がある。
+- ほとんどのプロバイダーはもうパスワードをサポートしていない。
+
+毎回認証情報を入力したくない場合は、git認証情報マネージャを使えばいい。
+詳しくは
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+最近の git クライアントの中には、認証情報を自動的に保存してくれるものもある。
+
+うまくいけば、XPipe がリモートリポジトリにコミットをプッシュしてくれるはずだ。
+
+## カテゴリをリポジトリに追加する
+
+デフォルトでは、コミットする接続を明示的に制御できるように、同期する接続カテゴリは設定されていない。
+そのため、最初はリモートリポジトリは空になる。
+
+あるカテゴリの接続を git リポジトリに追加するには、歯車のアイコンをクリックする必要がある、
+歯車のアイコンをクリックする必要がある。
+をクリックする。
+それから`Add to git repository`をクリックして、カテゴリと接続をgitリポジトリに同期する。
+これで、同期可能なすべての接続がgitリポジトリに追加される。
+
+## ローカル接続は同期されない
+
+ローカルマシンの下にある接続は、ローカルシステムでのみ利用可能な接続やデータを参照するため、共有することができない。
+
+ローカルファイルに基づいた接続、たとえば SSH 設定などは、その基礎となるデータ（この場合はファイル）が git リポジトリに追加されていれば、git 経由で共有することができる。
+
+## git にファイルを追加する
+
+すべての設定が終わったら、SSH キーなどの追加ファイルを git に追加することもできる。
+すべてのファイルを選択すると、その横に git ボタンが表示され、ファイルが git リポジトリに追加される。
+プッシュされたファイルは暗号化される。
--- a/lang/app/texts/vault_nl.md
+++ b/lang/app/texts/vault_nl.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe kan al je verbindingsgegevens synchroniseren met je eigen git remote repository. Je kunt met deze repository synchroniseren in alle XPipe applicatie instanties op dezelfde manier, elke verandering die je maakt in een instantie zal worden weerspiegeld in de repository.
+
+Allereerst moet je een remote repository aanmaken met je favoriete git provider naar keuze. Deze repository moet privé zijn.
+Je kunt dan gewoon de URL kopiëren en plakken in de XPipe remote repository instelling.
+
+Je moet ook een lokaal geïnstalleerde `git` client klaar hebben staan op je lokale machine. Je kunt proberen `git` in een lokale terminal te draaien om dit te controleren.
+Als je er geen hebt, kun je naar [https://git-scm.com](https://git-scm.com/) gaan om git te installeren.
+
+## Authenticeren naar de remote repository
+
+Er zijn meerdere manieren om te authenticeren. De meeste repositories gebruiken HTTPS waarbij je een gebruikersnaam en wachtwoord moet opgeven.
+Sommige providers ondersteunen ook het SSH protocol, dat ook door XPipe wordt ondersteund.
+Als je SSH voor git gebruikt, weet je waarschijnlijk hoe je het moet configureren, dus deze sectie zal alleen HTTPS behandelen.
+
+Je moet je git CLI instellen om te kunnen authenticeren met je remote git repository via HTTPS. Er zijn meerdere manieren om dat te doen.
+Je kunt controleren of dat al is gedaan door XPipe opnieuw te starten zodra een remote repository is geconfigureerd.
+Als het je vraagt om je inloggegevens, dan moet je dat instellen.
+
+Veel speciale tools zoals deze [GitHub CLI](https://cli.github.com/) doen alles automatisch voor je als ze geïnstalleerd zijn.
+Sommige nieuwere git client versies kunnen ook authenticeren via speciale webservices waarbij je alleen maar hoeft in te loggen op je account in je browser.
+
+Er zijn ook handmatige manieren om je te authenticeren via een gebruikersnaam en token.
+Tegenwoordig vereisen de meeste providers een persoonlijk toegangstoken (PAT) voor authenticatie vanaf de commandoregel in plaats van traditionele wachtwoorden.
+Je kunt veelgebruikte (PAT) pagina's hier vinden:
+- **GitHub**: [Persoonlijke toegangstokens (klassiek)](https://github.com/settings/tokens)
+- **GitLab**: [Persoonlijk toegangstoken](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Persoonlijk toegangstoken](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Instellingen -> Toepassingen -> Sectie Toegangsmunten beheren`
+Stel de tokenrechten voor repository in op Lezen en Schrijven. De rest van de tokenrechten kun je instellen als Lezen.
+Zelfs als je git client je om een wachtwoord vraagt, moet je je token invoeren, tenzij je provider nog steeds wachtwoorden gebruikt.
+- De meeste providers ondersteunen geen wachtwoorden meer.
+
+Als je niet elke keer je referenties wilt invoeren, dan kun je daarvoor elke git credentials manager gebruiken.
+Zie voor meer informatie bijvoorbeeld:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Sommige moderne git clients zorgen er ook voor dat de referenties automatisch worden opgeslagen.
+
+Als alles werkt, zou XPipe een commit naar je remote repository moeten pushen.
+
+## Categorieën aan het archief toevoegen
+
+Standaard zijn er geen verbindingscategorieën ingesteld om te synchroniseren, zodat je expliciete controle hebt over welke verbindingen je wilt vastleggen.
+Dus in het begin zal je remote repository leeg zijn.
+
+Om je connecties van een categorie in je git repository te plaatsen,
+moet je op het tandwiel icoon klikken (als je met je muis over de categorie gaat)
+in je `Connecties` tab onder het categorieoverzicht aan de linkerkant.
+Klik dan op `Toevoegen aan git repository` om de categorie en verbindingen te synchroniseren met je git repository.
+Dit voegt alle synchroniseerbare verbindingen toe aan de git repository.
+
+## Lokale verbindingen worden niet gesynchroniseerd
+
+Elke verbinding die zich onder de lokale machine bevindt kan niet worden gedeeld, omdat het verwijst naar verbindingen en gegevens die alleen beschikbaar zijn op het lokale systeem.
+
+Bepaalde verbindingen die gebaseerd zijn op een lokaal bestand, bijvoorbeeld SSH configs, kunnen gedeeld worden via git als de onderliggende gegevens, in dit geval het bestand, ook aan de git repository zijn toegevoegd.
+
+## Bestanden toevoegen aan git
+
+Als alles is ingesteld, heb je de optie om extra bestanden zoals SSH sleutels ook aan git toe te voegen.
+Naast elke bestandskeuze staat een git knop die het bestand zal toevoegen aan de git repository.
+Deze bestanden worden ook versleuteld als ze worden gepushed.
--- a/lang/app/texts/vault_pt.md
+++ b/lang/app/texts/vault_pt.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe pode sincronizar todos os teus dados de conexão com o teu próprio repositório remoto git. Podes sincronizar com este repositório em todas as instâncias da aplicação XPipe da mesma forma, cada alteração que fizeres numa instância será reflectida no repositório.
+
+Antes de mais, tens de criar um repositório remoto com o teu fornecedor git preferido. Este repositório tem de ser privado.
+Depois, basta copiar e colar o URL na definição do repositório remoto do XPipe.
+
+Também precisas de ter um cliente `git` instalado localmente na tua máquina local. Podes tentar executar o `git` num terminal local para verificar.
+Se não tiveres um, podes visitar [https://git-scm.com](https://git-scm.com/) para instalar o git.
+
+## Autenticando para o repositório remoto
+
+Existem várias formas de te autenticares. A maioria dos repositórios usa HTTPS onde tens de especificar um nome de utilizador e uma palavra-passe.
+Alguns provedores também suportam o protocolo SSH, que também é suportado pelo XPipe.
+Se usas o SSH para o git, provavelmente sabes como o configurar, por isso esta secção irá cobrir apenas o HTTPS.
+
+Precisas de configurar o teu git CLI para ser capaz de autenticar com o teu repositório git remoto via HTTPS. Há várias maneiras de fazer isso.
+Podes verificar se isso já foi feito reiniciando o XPipe quando um repositório remoto estiver configurado.
+Se ele te pedir as tuas credenciais de login, tens de as configurar.
+
+Muitas ferramentas especiais como esta [GitHub CLI](https://cli.github.com/) fazem tudo automaticamente para ti quando instaladas.
+Algumas versões mais recentes do cliente git também podem autenticar através de serviços web especiais onde apenas tens de iniciar sessão na tua conta no teu browser.
+
+Existem também formas manuais de te autenticares através de um nome de utilizador e de um token.
+Atualmente, a maioria dos fornecedores exige um token de acesso pessoal (PAT) para autenticar a partir da linha de comandos em vez das palavras-passe tradicionais.
+Podes encontrar páginas comuns (PAT) aqui:
+- **GitHub**: [Tokens de acesso pessoal (clássico)](https://github.com/settings/tokens)
+- **GitLab**: [Token de acesso pessoal](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Token de acesso pessoal](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Configurações -> Aplicações -> secção Gerir Tokens de Acesso`
+Define a permissão do token para o repositório como Leitura e Escrita. O resto das permissões do token podem ser definidas como Read.
+Mesmo que o teu cliente git te peça uma palavra-passe, deves introduzir o teu token, a menos que o teu fornecedor ainda utilize palavras-passe.
+- A maioria dos provedores não suporta mais senhas.
+
+Se não quiseres introduzir as tuas credenciais todas as vezes, podes usar qualquer gestor de credenciais git para isso.
+Para mais informações, vê por exemplo:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Alguns clientes git modernos também se encarregam de armazenar as credenciais automaticamente.
+
+Se tudo funcionar bem, o XPipe deve enviar um commit para o teu repositório remoto.
+
+## Adicionando categorias ao repositório
+
+Por padrão, nenhuma categoria de conexão é definida para sincronizar, para que tenhas controle explícito sobre quais conexões devem ser confirmadas.
+Assim, no início, o teu repositório remoto estará vazio.
+
+Para que as tuas ligações de uma categoria sejam colocadas no teu repositório git,
+precisas clicar no ícone de engrenagem (ao passar o mouse sobre a categoria)
+no teu separador `Conexões` sob a visão geral da categoria no lado esquerdo.
+Em seguida, clica em `Adicionar ao repositório git` para sincronizar a categoria e as conexões ao seu repositório git.
+Isso adicionará todas as conexões sincronizáveis ao repositório git.
+
+## As conexões locais não são sincronizadas
+
+Qualquer conexão localizada na máquina local não pode ser compartilhada, pois se refere a conexões e dados que estão disponíveis apenas no sistema local.
+
+Certas conexões que são baseadas em um arquivo local, por exemplo, configurações SSH, podem ser compartilhadas via git se os dados subjacentes, neste caso o arquivo, tiverem sido adicionados ao repositório git também.
+
+## Adicionando arquivos ao git
+
+Quando tudo estiver configurado, tens a opção de adicionar quaisquer ficheiros adicionais, tais como chaves SSH, ao git também.
+Junto a cada escolha de ficheiro está um botão git que irá adicionar o ficheiro ao repositório git.
+Estes ficheiros são também encriptados quando enviados.
--- a/lang/app/texts/vault_ru.md
+++ b/lang/app/texts/vault_ru.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe может синхронизировать все твои данные о соединениях с собственным удаленным git-репозиторием. Ты можешь синхронизироваться с этим репозиторием во всех экземплярах приложения XPipe одинаково, каждое изменение, которое ты сделаешь в одном экземпляре, будет отражено в репозитории.
+
+Прежде всего, тебе нужно создать удаленный репозиторий с помощью твоего любимого git-провайдера на выбор. Этот репозиторий должен быть приватным.
+Затем ты можешь просто скопировать и вставить URL в настройку удаленного репозитория XPipe.
+
+Также тебе нужно иметь готовый локально установленный клиент `git` на твоей локальной машине. Ты можешь попробовать запустить `git` в локальном терминале, чтобы проверить.
+Если у тебя его нет, ты можешь зайти на сайт [https://git-scm.com](https://git-scm.com/), чтобы установить git.
+
+## Аутентификация в удаленном репозитории
+
+Существует несколько способов аутентификации. Большинство репозиториев используют HTTPS, где тебе нужно указать имя пользователя и пароль.
+Некоторые провайдеры также поддерживают протокол SSH, который также поддерживается XPipe.
+Если ты используешь SSH для git, то наверняка знаешь, как его настроить, поэтому в этом разделе мы рассмотрим только HTTPS.
+
+Тебе нужно настроить свой git CLI так, чтобы он мог аутентифицироваться с удаленным git-репозиторием по HTTPS. Сделать это можно несколькими способами.
+Ты можешь проверить, сделано ли это уже, перезапустив XPipe после настройки удаленного репозитория.
+Если он попросит тебя ввести учетные данные для входа, значит, тебе нужно их настроить.
+
+Многие специальные инструменты вроде этого [GitHub CLI](https://cli.github.com/) при установке делают все автоматически за тебя.
+Некоторые новые версии git-клиентов также могут аутентифицироваться через специальные веб-сервисы, где тебе нужно просто войти в свой аккаунт в браузере.
+
+Существуют и ручные способы аутентификации с помощью имени пользователя и токена.
+Сейчас большинство провайдеров требуют ввести персональный токен доступа (PAT) для аутентификации из командной строки вместо традиционных паролей.
+Общие страницы (PAT) ты можешь найти здесь:
+- **GitHub**: [Personal access tokens (classic)](https://github.com/settings/tokens)
+- **GitLab**: [Personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Персональный токен доступа](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Настройки -> Приложения -> раздел Manage Access Tokens`.
+Установи разрешение токена для репозитория на чтение и запись. Остальные разрешения токена могут быть установлены как Read.
+Даже если твой git-клиент запрашивает у тебя пароль, ты должен ввести свой токен, если только твой провайдер все еще не использует пароли.
+- Большинство провайдеров больше не поддерживают пароли.
+
+Если ты не хочешь каждый раз вводить свои учетные данные, то можешь использовать для этого любой менеджер учетных данных git.
+Более подробную информацию можно найти, например:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Некоторые современные git-клиенты также заботятся о хранении учетных данных автоматически.
+
+Если все работает, XPipe должен протолкнуть коммит в твой удаленный репозиторий.
+
+## Добавление категорий в репозиторий
+
+По умолчанию для синхронизации не заданы категории соединений, чтобы у тебя был явный контроль над тем, какие соединения коммитить.
+Поэтому в самом начале твой удаленный репозиторий будет пустым.
+
+Чтобы соединения той или иной категории были помещены в твой git-репозиторий,
+тебе нужно нажать на значок шестеренки (при наведении курсора на категорию)
+на вкладке `Связи` под обзором категории слева.
+Затем нажми на `Add to git repository`, чтобы синхронизировать категорию и соединения с твоим git-репозиторием.
+Это добавит все синхронизируемые соединения в git-репозиторий.
+
+## Локальные соединения не синхронизируются
+
+Любое соединение, расположенное на локальной машине, не может быть общим, так как оно относится к соединениям и данным, которые доступны только в локальной системе.
+
+Некоторыми соединениями, основанными на локальном файле, например SSH-конфигами, можно поделиться через git, если базовые данные, в данном случае файл, также были добавлены в git-репозиторий.
+
+## Добавление файлов в git
+
+Когда все готово, у тебя есть возможность добавить в git любые дополнительные файлы, например SSH-ключи.
+Рядом с каждым выбранным файлом есть кнопка git, которая добавит файл в git-репозиторий.
+Эти файлы также будут зашифрованы при добавлении.
--- a/lang/app/texts/vault_tr.md
+++ b/lang/app/texts/vault_tr.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe, tüm bağlantı verilerinizi kendi git uzak deponuzla senkronize edebilir. Bu depo ile tüm XPipe uygulama örneklerinde aynı şekilde senkronize edebilirsiniz, bir örnekte yaptığınız her değişiklik depoya yansıtılacaktır.
+
+Her şeyden önce, tercih ettiğiniz git sağlayıcısı ile uzak bir depo oluşturmanız gerekir. Bu depo özel olmalıdır.
+Daha sonra URL'yi kopyalayıp XPipe uzak depo ayarına yapıştırabilirsiniz.
+
+Ayrıca yerel makinenizde yerel olarak yüklenmiş bir `git` istemcisinin hazır olması gerekir. Kontrol etmek için yerel bir terminalde `git` çalıştırmayı deneyebilirsiniz.
+Eğer yoksa, git'i yüklemek için [https://git-scm.com](https://git-scm.com/) adresini ziyaret edebilirsiniz.
+
+## Uzak depoda kimlik doğrulama
+
+Kimlik doğrulamanın birden fazla yolu vardır. Çoğu depo, bir kullanıcı adı ve parola belirtmeniz gereken HTTPS kullanır.
+Bazı sağlayıcılar XPipe tarafından da desteklenen SSH protokolünü de destekler.
+Eğer git için SSH kullanıyorsanız, muhtemelen nasıl yapılandıracağınızı biliyorsunuzdur, bu yüzden bu bölüm sadece HTTPS'yi kapsayacaktır.
+
+HTTPS aracılığıyla uzak git deponuzla kimlik doğrulaması yapabilmek için git CLI'nızı ayarlamanız gerekir. Bunu yapmanın birden fazla yolu vardır.
+Uzak bir depo yapılandırıldıktan sonra XPipe'ı yeniden başlatarak bunun zaten yapılıp yapılmadığını kontrol edebilirsiniz.
+Eğer sizden oturum açma kimlik bilgilerinizi isterse, bunu ayarlamanız gerekir.
+
+Bunun gibi birçok özel araç [GitHub CLI] (https://cli.github.com/) yüklendiğinde her şeyi sizin için otomatik olarak yapar.
+Bazı yeni git istemci sürümleri, tarayıcınızda hesabınıza giriş yapmanız gereken özel web hizmetleri aracılığıyla da kimlik doğrulaması yapabilir.
+
+Bir kullanıcı adı ve belirteç aracılığıyla kimlik doğrulaması yapmanın manuel yolları da vardır.
+Günümüzde çoğu sağlayıcı, geleneksel parolalar yerine komut satırından kimlik doğrulaması için kişisel erişim belirteci (PAT) gerektirmektedir.
+Yaygın (PAT) sayfalarını burada bulabilirsiniz:
+- **GitHub**: [Kişisel erişim belirteçleri (klasik)](https://github.com/settings/tokens)
+- **GitLab**: [Kişisel erişim belirteci](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**: [Kişisel erişim belirteci](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**: `Ayarlar -> Uygulamalar -> Erişim Belirteçlerini Yönet bölümü`
+Depo için belirteç iznini Okuma ve Yazma olarak ayarlayın. Token izinlerinin geri kalanı Okuma olarak ayarlanabilir.
+Git istemciniz sizden bir parola istese bile, sağlayıcınız hala parola kullanmıyorsa token'ınızı girmelisiniz.
+- Çoğu sağlayıcı artık şifreleri desteklemiyor.
+
+Her seferinde kimlik bilgilerinizi girmek istemiyorsanız, bunun için herhangi bir git kimlik bilgileri yöneticisini kullanabilirsiniz.
+Daha fazla bilgi için örneğin bkz:
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+Bazı modern git istemcileri kimlik bilgilerinin otomatik olarak saklanmasını da sağlar.
+
+Her şey yolunda giderse, XPipe uzak deponuza bir commit göndermelidir.
+
+## Depoya kategori ekleme
+
+Varsayılan olarak, hiçbir bağlantı kategorisi senkronize edilecek şekilde ayarlanmamıştır, böylece hangi bağlantıların işleneceği üzerinde açık bir kontrole sahip olursunuz.
+Yani başlangıçta uzak deponuz boş olacaktır.
+
+Bir kategorideki bağlantılarınızın git deponuzun içine yerleştirilmesini sağlamak için,
+dişli simgesine tıklamanız gerekir (kategorinin üzerine geldiğinizde)
+sol taraftaki kategoriye genel bakış altındaki `Bağlantılar` sekmenizde.
+Ardından kategoriyi ve bağlantıları git deponuzla senkronize etmek için `Git deposuna ekle` seçeneğine tıklayın.
+Bu, senkronize edilebilir tüm bağlantıları git deposuna ekleyecektir.
+
+## Yerel bağlantılar senkronize edilmiyor
+
+Yerel makine altında bulunan herhangi bir bağlantı, yalnızca yerel sistemde bulunan bağlantıları ve verileri ifade ettiğinden paylaşılamaz.
+
+Yerel bir dosyaya dayanan belirli bağlantılar, örneğin SSH yapılandırmaları, altta yatan veriler, bu durumda dosya da git deposuna eklenmişse git aracılığıyla paylaşılabilir.
+
+## git'e dosya ekleme
+
+Her şey ayarlandığında, SSH anahtarları gibi ek dosyaları da git'e ekleme seçeneğiniz vardır.
+Her dosya seçiminin yanında, dosyayı git deposuna ekleyecek bir git düğmesi bulunur.
+Bu dosyalar itildiğinde de şifrelenir.
--- a/lang/app/texts/vault_zh.md
+++ b/lang/app/texts/vault_zh.md
@ -0,0 +1,65 @@
+# XPipe Git Vault
+
+XPipe可以将所有连接数据与您自己的git远程仓库同步。您可以在所有 XPipe 应用程序实例中以相同的方式与该版本库同步，您在一个实例中所做的每一项更改都将反映在版本库中。
+
+首先，您需要使用自己喜欢的 git 提供商创建一个远程仓库。该仓库必须是私有的。
+然后，您只需将 URL 复制并粘贴到 XPipe 远程仓库设置中即可。
+
+您还需要在本地计算机上安装 `git` 客户端。您可以尝试在本地终端运行 `git` 进行检查。
+如果没有，可以访问 [https://git-scm.com](https://git-scm.com/)安装 git。
+
+## 验证远程仓库
+
+有多种认证方式。大多数版本库使用 HTTPS，需要指定用户名和密码。
+有些提供商还支持 SSH 协议，XPipe 也支持该协议。
+如果您在 git 中使用 SSH，可能已经知道如何配置，因此本节将只介绍 HTTPS。
+
+您需要设置 git CLI，以便能通过 HTTPS 与远程 git 仓库进行身份验证。有多种方法可以做到这一点。
+您可以在配置好远程仓库后重启 XPipe 来检查是否已经完成。
+如果系统要求您提供登录凭证，您就需要进行设置。
+
+许多特殊工具，如 [GitHub CLI](https://cli.github.com/)，在安装后会自动完成所有操作。
+一些较新的 Git 客户端版本还能通过特殊的网络服务进行身份验证，只需在浏览器中登录账户即可。
+
+也有通过用户名和令牌手动认证的方法。
+如今，大多数服务提供商都要求使用个人访问令牌（PAT），而不是传统的密码来进行命令行身份验证。
+您可以在这里找到常用的 (PAT) 页面：
+- **GitHub**：[个人访问令牌（经典）](https://github.com/settings/tokens)
+- **GitLab**：[个人访问令牌](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
+- **BitBucket**：[个人访问令牌](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
+- **Gitea**：`设置 -> 应用程序 -> 管理访问令牌部分`。
+将存储库的令牌权限设置为 "读取 "和 "写入"。其他令牌权限可设置为 "读取"。
+即使 git 客户端提示您输入密码，您也应该输入令牌，除非您的提供商仍然使用密码。
+- 大多数提供商已经不支持密码了。
+
+如果不想每次都输入凭据，可以使用任何 git 凭据管理器。
+更多信息，请参阅
+- [https://git-scm.com/doc/credential-helpers](https://git-scm.com/doc/credential-helpers)
+- [https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git](https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git)
+
+一些现代的 git 客户端也会自动存储凭据。
+
+如果一切正常，XPipe 就会向您的远程仓库推送提交。
+
+## 为版本库添加类别
+
+默认情况下，不会将连接类别设置为同步，这样您就可以明确控制要提交的连接。
+因此，一开始，您的远程版本库将是空的。
+
+要将某个类别的连接放到您的 git 仓库中，您需要点击齿轮图标、
+需要点击齿轮图标（悬停在类别上时）
+点击左侧类别概览下的 `Connections` 标签中的齿轮图标。
+然后点击`添加到 git 仓库`，将类别和连接同步到 git 仓库。
+这将把所有可同步的连接添加到 git 仓库。
+
+##本地连接不会同步
+
+任何位于本地机器下的连接都不能共享，因为它涉及的连接和数据只在本地系统上可用。
+
+某些基于本地文件的连接（例如 SSH 配置）可以通过 git 共享，前提是底层数据（这里指文件）也已添加到 git 仓库中。
+
+## 添加文件到 git
+
+一切就绪后，您还可以向 git 添加 SSH 密钥等其他文件。
+在每个文件选项旁都有一个 git 按钮，可以将文件添加到 git 仓库。
+这些文件在推送时也会加密。