Installatie Linux

Installatie op Linux

Van iedere release wordt naast het Windows- en macOS-pakket ook een Linux-pakket uitgeleverd. Daar zitten dezelfde vier applicaties in: de scanner, de emulator, de Photino-versie en de webversie. Voor de Windows-installatie zie Installatie Windows, voor macOS zie Installatie macOS.

Wat je nodig hebt

Architectuur	x86-64 (amd64). Het uitgeleverde pakket is linux-x64.
Distributie	Elke distributie met glibc ≥ 2.17 (Ubuntu 18.04+, Debian 10+, Fedora 30+, etc.).
.NET	Niets installeren. De runtime zit in het pakket (self-contained).
Systeembibliotheken	GTK 3, WebKitGTK 4.1, libnotify, X11 en fontconfig — zie stap 2 hieronder.
Schijfruimte	Het zip-bestand is ongeveer 100 MB, uitgepakt ongeveer 250 MB.

Stap 1 — downloaden en uitpakken

Ga naar de releases-pagina en download het bestand CryptoScanBot-<versie>-linux-x64.zip, bijvoorbeeld CryptoScanBot-2.6.2-linux-x64.zip.

unzip CryptoScanBot-2.6.2-linux-x64.zip

Er ontstaat een map CryptoScanBot-2.6.2-linux-x64. Verplaats die naar de plek waar je hem wil hebben, bijvoorbeeld je thuismap of /opt.

In die map staan vier programma's naast elkaar:

Bestand	Wat het is
CryptoScanBot	de scanner
CryptoScanBot.Emulator	de emulator, waarmee je op opgeslagen candles terugtest
CryptoScanBot.Photino	de Blazor-versie van de scanner, zie Photino
CryptoScanBot.Web	dezelfde schermen in je browser, ook vanaf een ander apparaat op je netwerk, zie [[Webversie

Stap 2 — systeembibliotheken installeren

De scanner en de emulator gebruiken Avalonia (Skia + X11), de Photino-versie gebruikt GTK en WebKitGTK. Die drie hebben fontconfig nodig. Installeer de vereiste pakketten:

De webversie heeft hier niets van nodig: die tekent geen venster maar serveert zijn schermen aan een browser. Op een machine zonder grafische omgeving — een thuisserver bijvoorbeeld — is dat de enige versie die draait.

Ubuntu / Debian:

sudo apt-get install libgtk-3-0 libwebkit2gtk-4.1-0 libnotify4 libx11-6 libfontconfig1

Fedora:

sudo dnf install gtk3 webkit2gtk4.1 libnotify libX11 fontconfig

Arch Linux:

sudo pacman -S gtk3 webkit2gtk-4.1 libnotify libx11 fontconfig

Dit hoef je maar één keer te doen. Bij een update van de scanner veranderen deze pakketten niet.

Stap 3 — uitvoerbaar maken

Het zip-bestand wordt op Windows gemaakt. Windows kent het "uitvoerbaar"-kenmerk van Linux niet, dus dat gaat bij het inpakken verloren. Markeer de vier programma's als uitvoerbaar:

cd ~/CryptoScanBot-2.6.2-linux-x64
chmod +x CryptoScanBot CryptoScanBot.Emulator CryptoScanBot.Photino CryptoScanBot.Web

Bij iedere nieuwe versie die je downloadt moet je deze stap opnieuw doen.

Stap 4 — opstarten

Vanuit een terminal, in de map van de scanner:

./CryptoScanBot

De eerste keer dat je opstart moet de applicatie geconfigureerd worden, met name de exchange en de basismunten. Standaard staat geen enkele basismunt aan, zodat de exchange niet meteen zwaar belast wordt. Zie Veelgestelde vragen.

Opstartparameters

De parameters zijn gelijk aan die op Windows en macOS: -e voor de exchange en -f voor de datamap.

./CryptoScanBot -e "Bybit Perpetual" -f "Bybit Perpetual"

Een startscript per exchange

Maak in de map van de scanner een bestand bybit-perpetual.sh met deze inhoud:

#!/bin/bash
cd "$(dirname "$0")"
./CryptoScanBot -e "Bybit Perpetual" -f "Bybit Perpetual"

Maak het bestand daarna uitvoerbaar:

chmod +x bybit-perpetual.sh

Herhaal dit per exchange die je wil draaien. Iedere scanner krijgt zo zijn eigen datamap en dus zijn eigen instellingen, candles en posities. Draai je meerdere scanners met Telegram-meldingen, dan heeft iedere scanner een eigen Telegram-groep nodig.

Waar staat de data

Zonder -f is de opslag:

~/.local/share/CryptoScanBot/

Geef je -f een naam zonder pad, dan komt de data in ~/.local/share/<naam>. Geef je een volledig pad (beginnend met een /), dan wordt dat gebruikt zoals het er staat.

API keys

De API keys worden op Linux versleuteld opgeslagen via de .NET Data Protection API. Een instellingenbestand dat je van een Windows- of macOS-computer meeneemt komt op Linux dus binnen met onleesbare sleutels. Voer ze opnieuw in, zie API Keys.

Als het misgaat

"Permission denied"

Het commando chmod +x uit stap 3 is niet uitgevoerd, of niet voor dit bestand. Let op dat alle drie de programma's genoemd moeten worden, ook als je er maar één gebruikt.

"error while loading shared libraries: libgtk-3.so.0"

De systeembibliotheken uit stap 2 zijn niet geïnstalleerd. De foutmelding noemt welk pakket ontbreekt.

"error while loading shared libraries: libwebkit2gtk-4.1.so.0"

Op oudere distributies heet het pakket libwebkit2gtk-4.0-37 in plaats van libwebkit2gtk-4.1-0. De Photino-versie heeft specifiek versie 4.1 nodig. Gebruik een recentere distributie, of draai de scanner, de emulator of de webversie (die hebben WebKitGTK niet nodig).

Het venster verschijnt niet (headless server)

De scanner en de emulator hebben een X11-display nodig. Op een server zonder grafische omgeving kun je Xvfb gebruiken:

sudo apt-get install xvfb
xvfb-run ./CryptoScanBot -e "Bybit Perpetual" -f "Bybit Perpetual"

Dit is vooral nuttig als je de scanner als achtergrondproces wil draaien. De Photino-versie werkt niet onder Xvfb omdat WebKitGTK een echt display verwacht.

Op zo'n machine is de webversie het eenvoudigere antwoord: die heeft helemaal geen display nodig en je bekijkt hem vanaf een ander apparaat in je browser.

./CryptoScanBot.Web -e "Bybit Perpetual" -f "Bybit Perpetual" -p 5001

Virusscanners

De opmerkingen op de pagina Virusscanners gelden ook hier. De broncode is openbaar, je kunt alles zelf nakijken of zelf bouwen.

Verschillen met de Windows-versie

• Geluiden worden afgespeeld met aplay (ALSA), de standaard audiospeler op de meeste Linux-distributies. Dezelfde wav-bestanden, hetzelfde resultaat. Is aplay niet beschikbaar, dan worden geluiden overgeslagen.
• De Photino-versie gebruikt WebKitGTK in plaats van WebView2.
• De API keys worden anders versleuteld (zie hierboven).

Zelf bouwen

Het script publish-release.cmd in de repository maakt alle drie de pakketten. Voor een andere architectuur (bijvoorbeeld linux-arm64 voor een Raspberry Pi) vervang je linux-x64 door de gewenste runtime identifier:

dotnet publish CryptoScanner/CryptoScanner.csproj -c Release -r linux-arm64 --self-contained true -o <doelmap>
dotnet publish CryptoScanner.Photino/CryptoScanner.Photino.csproj -c Release -r linux-arm64 --self-contained true -o <tijdelijke map>

Kopieer daarna de tijdelijke Photino-map over de doelmap heen. Bouw je op Linux zelf, dan is chmod +x niet nodig — de bestanden hebben het uitvoerbare kenmerk al.