## Was in diesem Archiv liegt

Datei | Zweck
--- | ---
`GS-Route-…-x86_64.AppImage` | Das Programm. Eine einzige Datei, alles ist enthalten.
`install.sh` | Richtet GS-Route ein: Menüeintrag, Symbol, GPX-Zuordnung.
`gs-route.png` | Das Programmsymbol.
`Setup.html` | Diese Seite.

## Einrichten

Ein Terminal in diesem Ordner öffnen — im Dateimanager mit der rechten Maustaste, „In Terminal öffnen" — und eingeben:

    ./install.sh

Es wird kein Passwort verlangt. Alles landet in Ihrem Heimatverzeichnis, am System wird nichts verändert.

Falls das Terminal `Permission denied` meldet, hat das Entpacken das Ausführbar-Recht verloren. Dann einmal:

    chmod +x install.sh && ./install.sh

## Ohne Einrichtung ausprobieren

Sie können das Programm auch direkt starten, ohne etwas einzurichten:

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

Dann gibt es allerdings keinen Menüeintrag und keine Zuordnung für GPX-Dateien.

## Garmin-Geräte am USB-Anschluss

Damit ein angeschlossenes Gerät erkannt wird, werden zwei Systempakete gebraucht. Nur dafür ist einmalig ein Passwort nötig:

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Ohne sie läuft GS-Route ganz normal, es findet nur kein Gerät. Taucht ein angestecktes Gerät trotzdem nicht auf: einmal im Dateimanager öffnen — der Desktop bindet MTP-Geräte erst beim ersten Zugriff ein.

## Wo Ihre Daten liegen

`~/.local/share/gs-route` | Das Programm
`~/.config/GS-Route` | Einstellungen, Routing-Profile, bekannte Geräte
`~/Dokumente/GS-Route` | Archiv und exportierte Dateien

## Entfernen

    ./install.sh --uninstall

Ihre Einstellungen und Routen bleiben dabei erhalten — eine spätere Neuinstallation findet den alten Stand wieder.

## What is in this archive

File | Purpose
--- | ---
`GS-Route-…-x86_64.AppImage` | The program. A single file, everything included.
`install.sh` | Sets GS-Route up: menu entry, icon, GPX association.
`gs-route.png` | The application icon.
`Setup.html` | This page.

## Setting up

Open a terminal in this folder — right-click in the file manager, “Open in Terminal” — and type:

    ./install.sh

No password is required. Everything goes into your home directory; nothing on the system is changed.

If the terminal reports `Permission denied`, extraction lost the executable bit. In that case run:

    chmod +x install.sh && ./install.sh

## Try it without installing

You can also start the program directly, without setting anything up:

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

There will be no menu entry and no association for GPX files, though.

## Garmin devices over USB

Two system packages are needed for a connected device to be detected. This is the only step that asks for a password, and only once:

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Without them GS-Route runs normally, it just will not find a device. If a connected device still does not appear, open it once in the file manager — the desktop mounts MTP devices only on first access.

## Where your data lives

`~/.local/share/gs-route` | The program
`~/.config/GS-Route` | Settings, routing profiles, known devices
`~/Documents/GS-Route` | Archive and exported files

## Removing

    ./install.sh --uninstall

Your settings and routes are kept — a later reinstall finds them again.

## Contenu de cette archive

Fichier | Rôle
--- | ---
`GS-Route-…-x86_64.AppImage` | Le programme. Un seul fichier, tout est inclus.
`install.sh` | Installe GS-Route : entrée de menu, icône, association GPX.
`gs-route.png` | L’icône de l’application.
`Setup.html` | Cette page.

## Installation

Ouvrez un terminal dans ce dossier — clic droit dans le gestionnaire de fichiers, « Ouvrir dans un terminal » — puis saisissez :

    ./install.sh

Aucun mot de passe n’est demandé. Tout est installé dans votre dossier personnel ; rien n’est modifié sur le système.

Si le terminal indique `Permission denied`, l’extraction a perdu le droit d’exécution. Dans ce cas :

    chmod +x install.sh && ./install.sh

## Essayer sans installer

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

Il n’y aura alors ni entrée de menu ni association pour les fichiers GPX.

## Appareils Garmin en USB

Deux paquets système sont nécessaires pour qu’un appareil connecté soit détecté :

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Sans eux, GS-Route fonctionne normalement mais ne trouve aucun appareil. Si l’appareil n’apparaît toujours pas, ouvrez-le une fois dans le gestionnaire de fichiers.

## Où sont vos données

`~/.local/share/gs-route` | Le programme
`~/.config/GS-Route` | Réglages, profils d’itinéraire, appareils connus
`~/Documents/GS-Route` | Archive et fichiers exportés

## Désinstaller

    ./install.sh --uninstall

Vos réglages et vos itinéraires sont conservés.

## Contenido de este archivo

Archivo | Función
--- | ---
`GS-Route-…-x86_64.AppImage` | El programa. Un solo archivo, todo incluido.
`install.sh` | Instala GS-Route: entrada de menú, icono, asociación GPX.
`gs-route.png` | El icono de la aplicación.
`Setup.html` | Esta página.

## Instalación

Abra un terminal en esta carpeta — clic derecho en el gestor de archivos, «Abrir en terminal» — y escriba:

    ./install.sh

No se pide ninguna contraseña. Todo se instala en su carpeta personal; no se modifica nada del sistema.

Si el terminal indica `Permission denied`, la extracción perdió el permiso de ejecución. En ese caso:

    chmod +x install.sh && ./install.sh

## Probar sin instalar

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

No habrá entrada de menú ni asociación para archivos GPX.

## Dispositivos Garmin por USB

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Sin ellos GS-Route funciona con normalidad, solo que no encontrará ningún dispositivo.

## Dónde están sus datos

`~/.local/share/gs-route` | El programa
`~/.config/GS-Route` | Ajustes, perfiles de ruta, dispositivos conocidos
`~/Documentos/GS-Route` | Archivo y ficheros exportados

## Desinstalar

    ./install.sh --uninstall

Sus ajustes y rutas se conservan.

## Contenuto dell’archivio

File | Funzione
--- | ---
`GS-Route-…-x86_64.AppImage` | Il programma. Un unico file, tutto incluso.
`install.sh` | Installa GS-Route: voce di menu, icona, associazione GPX.
`gs-route.png` | L’icona dell’applicazione.
`Setup.html` | Questa pagina.

## Installazione

Aprire un terminale in questa cartella — tasto destro nel gestore file, «Apri nel terminale» — e digitare:

    ./install.sh

Non viene chiesta alcuna password. Tutto viene installato nella cartella personale; nel sistema non viene modificato nulla.

Se il terminale segnala `Permission denied`, l’estrazione ha perso il permesso di esecuzione. In tal caso:

    chmod +x install.sh && ./install.sh

## Provare senza installare

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

In questo caso non ci sarà né voce di menu né associazione per i file GPX.

## Dispositivi Garmin via USB

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Senza di essi GS-Route funziona normalmente, ma non troverà alcun dispositivo.

## Dove sono i dati

`~/.local/share/gs-route` | Il programma
`~/.config/GS-Route` | Impostazioni, profili di percorso, dispositivi noti
`~/Documenti/GS-Route` | Archivio e file esportati

## Disinstallare

    ./install.sh --uninstall

Le impostazioni e i percorsi vengono conservati.

## Wat er in dit archief zit

Bestand | Doel
--- | ---
`GS-Route-…-x86_64.AppImage` | Het programma. Eén bestand, alles inbegrepen.
`install.sh` | Stelt GS-Route in: menu-item, pictogram, GPX-koppeling.
`gs-route.png` | Het programmapictogram.
`Setup.html` | Deze pagina.

## Installeren

Open een terminal in deze map — rechtsklik in de bestandsbeheerder, „In terminal openen” — en typ:

    ./install.sh

Er wordt geen wachtwoord gevraagd. Alles komt in uw persoonlijke map; aan het systeem verandert niets.

Meldt de terminal `Permission denied`, dan is bij het uitpakken het uitvoerrecht verloren gegaan. Voer dan uit:

    chmod +x install.sh && ./install.sh

## Uitproberen zonder installeren

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

Er is dan geen menu-item en geen koppeling voor GPX-bestanden.

## Garmin-apparaten via USB

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Zonder deze pakketten werkt GS-Route gewoon, het vindt alleen geen apparaat.

## Waar uw gegevens staan

`~/.local/share/gs-route` | Het programma
`~/.config/GS-Route` | Instellingen, routeprofielen, bekende apparaten
`~/Documenten/GS-Route` | Archief en geëxporteerde bestanden

## Verwijderen

    ./install.sh --uninstall

Uw instellingen en routes blijven behouden.

## Conteúdo deste arquivo

Ficheiro | Função
--- | ---
`GS-Route-…-x86_64.AppImage` | O programa. Um único ficheiro, tudo incluído.
`install.sh` | Instala o GS-Route: entrada de menu, ícone, associação GPX.
`gs-route.png` | O ícone da aplicação.
`Setup.html` | Esta página.

## Instalação

Abra um terminal nesta pasta — clique com o botão direito no gestor de ficheiros, «Abrir no terminal» — e escreva:

    ./install.sh

Não é pedida qualquer palavra-passe. Tudo é instalado na sua pasta pessoal; nada é alterado no sistema.

Se o terminal indicar `Permission denied`, a extração perdeu a permissão de execução. Nesse caso:

    chmod +x install.sh && ./install.sh

## Experimentar sem instalar

    chmod +x GS-Route-*.AppImage
    ./GS-Route-*.AppImage

Não haverá entrada de menu nem associação para ficheiros GPX.

## Dispositivos Garmin por USB

    sudo apt install gvfs-backends libglib2.0-bin      # Debian, Ubuntu, Mint
    sudo dnf install gvfs-mtp glib2                    # Fedora

Sem eles o GS-Route funciona normalmente, apenas não encontra nenhum dispositivo.

## Onde ficam os seus dados

`~/.local/share/gs-route` | O programa
`~/.config/GS-Route` | Definições, perfis de rota, dispositivos conhecidos
`~/Documentos/GS-Route` | Arquivo e ficheiros exportados

## Desinstalar

    ./install.sh --uninstall

As suas definições e rotas são mantidas.