# LocoLink voor Linux

Voor Ubuntu 22.04 of nieuwer, Intel/AMD 64-bit (amd64/x86_64).
Een grafische desktop en werkende OpenGL/EGL-driver zijn nodig.

## Installeren en bijwerken

Download het `.deb`-bestand van LocoLink en open het met de software-installer.
Via de terminal, vanuit je downloadmap:

```sh
sudo apt install ./LocoLink-2.0.3+51-linux-amd64.deb
```

Start daarna **LocoLink** via het applicatiemenu. Installeer een volgende versie
op dezelfde manier: het pakket vervangt de app en behoudt je projecten,
instellingen en licentie. Maak voor een update een projectback-up in de app.
Je hoeft Flutter of ontwikkelgereedschap niet te installeren. Een ontbrekende
bestandskiezer wordt via de pakketafhankelijkheden mee geïnstalleerd. Een
bestaande KDE-bestandskiezer kan eveneens worden gebruikt.

Een Windows-licentie geldt niet voor Linux. Linux heeft eigen LocoLink+- en
LocoLink Pro-licenties. Activeren en kopen kan in de app.

## USB/serieel en gamepads

Netwerkcentrales zijn bereikbaar wanneer de computer op hetzelfde netwerk zit.
Voor een seriële USB-centrale heeft je gebruiker toegang tot het apparaat nodig.
Op Ubuntu kun je daarvoor eenmalig dit uitvoeren en daarna opnieuw aanmelden:

```sh
sudo usermod -aG dialout "$USER"
```

De installer verandert je gebruikersgroepen niet. Gamepads worden zichtbaar
wanneer Linux ze als leesbaar joystickapparaat (`/dev/input/js*`) aanbiedt.
Een ontbrekende gamepad verhindert het opstarten niet.
RTSP- en USB-camera's gebruiken het mee geïnstalleerde FFmpeg. Kies bij
Camera toevoegen de beeldbron **USB-camera (Linux)** en zoek je camera op naam.
Het beeld start pas na **Verbinden**. Ook de boordcamerawizard biedt deze bron.
Zoeken leest alleen de apparaatlijst; er wordt geen beeld opgenomen.

LocoLink bewaart de vaste USB-identificatie van Linux (`/dev/v4l/by-id`),
zodat een veranderd apparaatnummer na herstart de selectie niet verwisselt.
Camera's zonder zo'n identificatie, dubbelzinnige identificaties en aansluitingen
die alleen metadata leveren, worden niet aangeboden. Controleer het beeld opnieuw
na vervangen van een camera; identieke apparaten zonder eigen serienummer kunnen
door Linux dezelfde identificatie krijgen. Bij ontbrekende toegang controleer je
de camerarechten van je Linux-account. Een camera die elders in gebruik is, moet
eerst in die andere toepassing worden afgesloten.

## Verwijderen

```sh
sudo apt remove locolink
```

Persoonlijke projecten en instellingen blijven staan.

## Download controleren

Sla `SHA256SUMS` naast de installer op en voer daar uit:

```sh
sha256sum -c SHA256SUMS
```

## 3D en grafische drivers

Gebruik bij voorkeur een Wayland-desktopsessie met bijgewerkte grafische drivers.
Voor X11 vereist de 3D-engine toegang tot `/dev/dri/renderD128`. Zonder deze
ondersteuning blijft de app bruikbaar, maar kan de 3D-weergave niet starten.
De Linux-ondersteuning van de gebruikte 3D-engine is nog experimenteel.

Bij problemen met GPU-versnelling onder WSLg kun je vanuit een Wayland-sessie
softwareweergave proberen (langzamer):

```sh
LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=llvmpipe GDK_BACKEND=wayland /opt/locolink/locolink
```

## Een baan openen vanuit je bestandsbeheerder

LocoLink wordt aangeboden bij **Openen met** voor `.locolink` en
`.locolinkpack`. Je bestaande standaard-appkeuze blijft behouden. Kies naar
wens zelf LocoLink als standaard-app in je bestandsbeheerder.

Een dubbelklik of **Openen met LocoLink** brengt het hoofdvenster naar voren.
Is LocoLink al geopend, dan worden de bestanden aan datzelfde venster
doorgegeven. Klik op **Bestanden bekijken** en kies het gewenste bestand.
Maximaal 32 bestanden kunnen tegelijk klaarstaan; er wordt niets vanzelf geladen.

**Herstelkopie bewaren en openen** bewaart eerst je huidige baan bij **Back-ups**,
controleert het aangevraagde bestand en stopt lopende ritten bij de wisseling.
Een ontbrekend, ongeldig of onleesbaar bestand laat je huidige baan intact.
Je kunt een afzonderlijk verzoek verwijderen zonder het bestand te verwijderen.
Bij starten via een bestandsverzoek wordt automatisch verbinden overgeslagen;
verbind zelf wanneer de juiste baan klaarstaat.

De installer registreert alleen de bestandstypen en ververst de bijbehorende
Linux-menu- en bestandstypecaches. Hij wijzigt geen gebruikersvoorkeuren.