Installatie macOS

Installatie op macOS

Van iedere release wordt naast het Windows-pakket ook een macOS-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.

Het macOS-pakket vraagt twee handelingen extra ten opzichte van Windows. Die staan hieronder in stap 2 en zonder die stap start er niets, dus sla hem niet over.

Wat je nodig hebt

Processor	Apple Silicon (M1, M2, M3, M4 ...). Het uitgeleverde pakket is osx-arm64.
macOS	Microsoft ondersteunt de .NET 8 runtime op macOS 14 (Sonoma) en nieuwer. Op macOS 12 en 13 draait het technisch nog, maar die versies worden door Microsoft niet meer bijgehouden.
.NET	Niets installeren. De runtime zit in het pakket (self-contained).
Schijfruimte	Het zip-bestand is ongeveer 91 MB, uitgepakt ongeveer 224 MB.

Voor een Intel-Mac wordt geen kant-en-klaar pakket gemaakt. De projecten kennen die runtime wel, dus je kunt zelf bouwen — zie het kopje "Zelf bouwen" onderaan deze pagina.

Stap 1 — downloaden en uitpakken

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

Dubbelklik het zip-bestand. Er ontstaat een map CryptoScanBot-<versie>-osx-arm64. Verplaats die map naar de plek waar je hem wil hebben, bijvoorbeeld je thuismap of ~/Applications.

In die map staan drie 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

De vier delen de runtime en alle bibliotheken, daarom zitten ze in één map. Verder vind je er de map Help (met de handleiding en het bestand met de wijzigingen per versie), de map Sounds met de signaalgeluiden en de map wwwroot die bij de Photino-versie en de webversie hoort.

Stap 2 — twee eenmalige commando's in Terminal

Er zijn twee redenen waarom dit nodig is:

1. Het zip-bestand wordt op Windows gemaakt. Windows kent het "uitvoerbaar"-kenmerk van macOS niet, dus dat gaat bij het inpakken verloren. Zonder dat kenmerk weigert macOS de programma's te starten.
2. Het pakket is niet ondertekend met een Apple Developer ID en niet genotariseerd — dat is een betaald programma bij Apple. macOS zet ieder gedownload bestand daarom in quarantaine en weigert het te openen zolang dat kenmerk erop staat.

Open Terminal (Programma's → Hulpprogramma's → Terminal), ga naar de map van de scanner en voer beide commando's uit:

cd ~/CryptoScanBot-2.6.2-osx-arm64
chmod +x CryptoScanBot CryptoScanBot.Emulator CryptoScanBot.Photino CryptoScanBot.Web
xattr -dr com.apple.quarantine .

Wat er staat:

• chmod +x ... markeert de drie programma's als uitvoerbaar.
• xattr -dr com.apple.quarantine . haalt het quarantaine-kenmerk weg. De -d staat voor verwijderen, de -r voor inclusief alles wat eronder zit, en de punt aan het eind is de map waar je op dat moment in staat.

Tip: je hoeft het pad bij cd niet in te typen. Typ cd met een spatie erachter en sleep de map vanuit Finder in het Terminal-venster, dan vult het pad zichzelf in.

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

Stap 3 — opstarten

Vanuit Terminal, in de map van de scanner:

./CryptoScanBot

Je kunt in Finder ook dubbelklikken op CryptoScanBot. macOS opent dan een Terminal-venster en start het programma daarin. Dat venster hoort erbij, laat het openstaan zolang de scanner draait.

Het pakket bevat geen .app-bundel, dus er is geen eigen icoon in de Dock en de scanner staat niet in Launchpad.

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: -e voor de exchange en -f voor de datamap.

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

Aanhalingstekens zijn nodig zodra er een spatie in de naam staat.

Een startbestand per exchange

Op Windows maak je per exchange een snelkoppeling met parameters. Op macOS doe je dat met een klein tekstbestand met de extensie .command. Dat kun je in Finder dubbelklikken, net als een snelkoppeling.

Maak in de map van de scanner een bestand Bybit Perpetual.command met deze inhoud:

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

De regel met cd zorgt dat het script in zijn eigen map gaat staan. Zonder die regel zoekt Finder de scanner in je thuismap en gebeurt er niets.

Maak het bestand daarna uitvoerbaar:

chmod +x "Bybit Perpetual.command"

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

De applicatie en de data staan los van elkaar. Zonder -f is de opslag:

~/Library/Application Support/CryptoScanBot/

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

De map Library is in Finder verborgen. Je komt er via Finder → menu Ga → Ga naar map (Cmd+Shift+G) en dan het pad plakken. In de scanner zelf zit ook menu Tools → Open data folder, die opent Finder meteen op de goede plek.

API keys moeten opnieuw ingevoerd worden

Het instellingenbestand is uitwisselbaar tussen Windows en macOS, de API keys daarin niet. Die worden versleuteld opgeslagen en dat gebeurt op ieder platform anders: Windows gebruikt DPAPI, gekoppeld aan je Windows-account, en macOS gebruikt een sleutel die in de Keychain wordt bewaard. Een instellingenbestand dat je van een Windows-computer meeneemt komt op de Mac dus binnen met onleesbare sleutels. Voer ze opnieuw in, zie API Keys.

De eerste keer dat de scanner die sleutel aanmaakt of opvraagt kan macOS toestemming vragen voor toegang tot de Keychain. Geef die toestemming, anders kan de scanner de API keys niet lezen.

Als het misgaat

"kan niet worden geopend omdat de ontwikkelaar niet kan worden geverifieerd"

Het quarantaine-commando uit stap 2 is niet uitgevoerd, of niet op de hele map. Voer het alsnog uit. Lukt dat niet, dan kan het ook met de muis: ga naar Systeeminstellingen → Privacy en beveiliging, daar staat na een geweigerde start een knop Toch openen.

"Permission denied"

Het commando chmod +x uit stap 2 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.

Het venster gaat meteen weer dicht

Start het programma vanuit Terminal in plaats van met een dubbelklik. De foutmelding blijft dan staan en zegt meestal direct wat er mis is, bijvoorbeeld een exchangenaam bij -e die de scanner niet kent.

Virusscanners

De opmerkingen op de pagina Virusscanners gelden ook hier. Het macOS-pakket is niet ondertekend, dus een virusscanner heeft er eerder reden toe om te waarschuwen. De broncode is openbaar, je kunt alles zelf nakijken of zelf bouwen.

Verschillen met de Windows-versie

• Geluiden worden afgespeeld met afplay, de speler van macOS zelf, in plaats van via de audiobibliotheek die op Windows gebruikt wordt. Dezelfde wav-bestanden, hetzelfde resultaat.
• Meldingen die de scanner geeft voordat er een venster is, bijvoorbeeld bij een onbekende exchangenaam, worden via AppleScript getoond.
• De menubalk van de scanner staat iets naar rechts, zodat hij niet botst met de systeemknoppen linksboven in het venster.
• De Photino-versie gebruikt WKWebView in plaats van WebView2, zie Photino.
• De API keys worden in de Keychain versleuteld in plaats van met DPAPI.

Zelf bouwen (Intel-Mac of een andere runtime)

Het script publish-release.cmd in de repository maakt beide pakketten. Voor een Intel-Mac vervang je in het macOS-blok osx-arm64 door osx-x64; de projecten kennen die runtime al. Kort samengevat komt het neer op drie publish-opdrachten:

dotnet publish CryptoScanner/CryptoScanner.csproj -c Release -r osx-x64 --self-contained true -o <doelmap>
dotnet publish CryptoScanner.Web/CryptoScanner.Web.csproj -c Release -r osx-x64 --self-contained true -o <tijdelijke map voor de webversie>
dotnet publish CryptoScanner.Photino/CryptoScanner.Photino.csproj -c Release -r osx-x64 --self-contained true -o <tijdelijke map>

Daarna kopieer je eerst de tijdelijke webmap en dan de tijdelijke Photino-map over de doelmap heen. Photino moet er als laatste overheen, omdat twee bestanden in meerdere pakketten voorkomen en de versies van Photino degene zijn die alle applicaties opvragen; de webversie mag dus niet na hem komen. De emulator hoeft niet apart gepubliceerd te worden: die wordt door de publish van de scanner automatisch in dezelfde map gezet.

Bouw je op de Mac zelf, dan zijn chmod +x en het quarantaine-commando uit stap 2 niet nodig. Die twee problemen ontstaan alleen door het inpakken op Windows en het downloaden van internet.