FehlerbehebungTroubleshooting

Das blaue Fenster „Der Computer wurde durch Windows geschützt“ ist bei diesem Tracker normal, weil der Installer nicht mit einem kostenpflichtigen Zertifikat signiert ist. Klicke auf Weitere Informationen › Trotzdem ausführen. Ausführlich mit Nachbau zum Ausprobieren: Installation › SmartScreen.

The blue window “Windows protected your PC” is normal for this tracker because the installer is not signed with a paid certificate. Click More info › Run anyway. In detail with a recreation to try: Installation › SmartScreen.

Die App benutzt zwei Ports, beide nur auf deinem eigenen PC (127.0.0.1): 7788 für die App selbst und das OBS-Overlay, 7777 für die mGBA-Bridge. Ein zweites Tracker-Fenster ist nie der Grund: Startest du die App noch einmal, holt sie nur das schon offene Fenster nach vorn.

Port 7788 belegt: Dialog beim Start

Nutzt ein anderes Programm Port 7788, fragt die App beim Start im Dialog „Port belegt“:

• Port … verwenden: Die App nimmt einen freien Port und merkt ihn sich.
• Erneut versuchen: wenn du das andere Programm gerade beendet hast.
• Beenden: die App startet nicht.

Später änderst du den Port unter Einstellungen › Desktop-App › Erweitert › Port des lokalen Servers mit „Speichern & neu starten“. Die App wechselt nie still auf einen anderen Port.

Port 7777 belegt: ohne mGBA-Bridge

Die App läuft normal weiter, nur ohne Bridge. Es erscheint ein Hinweis, und unter Einstellungen › Desktop-App steht bei der mGBA-Bridge PORT BELEGT. Meist läuft noch die alte bridge.js / start.bat aus der Browser-Zeit: dieses Fenster schließen und die App neu starten, die Bridge ist jetzt eingebaut. Port 7777 lässt sich nicht umstellen, weil das mGBA-Skript fest an 7777 sendet.

Wer belegt den Port?

Eingabeaufforderung öffnen und netstat -ano | findstr :7788 (bzw. :7777) eingeben. Die Zahl ganz rechts ist die Prozess-ID, im Task-Manager unter „Details“ findest du das passende Programm. Hilft nichts: PC neu starten.

The app uses two ports, both only on your own PC (127.0.0.1): 7788 for the app itself and the OBS overlay, 7777 for the mGBA bridge. A second tracker window is never the cause: if you start the app again, it just brings the already open window to the front.

Port 7788 in use: dialog on start

If another program uses port 7788, the app asks on start in the “Port in use” dialog:

• Use port …: the app takes a free port and remembers it.
• Try again: if you have just closed the other program.
• Quit: the app does not start.

Later you can change the port under Settings › Desktop app › Advanced › Port of the local server with “Save & restart”. The app never silently switches to another port.

Port 7777 in use: no mGBA bridge

The app keeps running normally, just without the bridge. A notice appears, and under Settings › Desktop app the mGBA bridge says PORT IN USE. Usually the old bridge.js / start.bat from the browser days is still running: close that window and restart the app, the bridge is built in now. Port 7777 cannot be changed because the mGBA script always sends to 7777.

Who uses the port?

Open Command Prompt and enter netstat -ano | findstr :7788 (or :7777). The number on the far right is the process ID, Task Manager › “Details” shows the matching program. Nothing helps: restart your PC.

Der lokale Server der App ist nur auf deinem eigenen PC erreichbar (127.0.0.1), deshalb fragt Windows normalerweise nicht nach. Erscheint trotzdem „Die Windows Defender Firewall hat einige Features dieser App blockiert“:

• Haken bei Private Netzwerke genügt, dann Zugriff zulassen.
• „Öffentliche Netzwerke“ brauchst du nicht.
• Hast du versehentlich abgebrochen: Overlay und Auto-Tracking auf demselben PC funktionieren trotzdem.

The app’s local server can only be reached from your own PC (127.0.0.1), so Windows usually doesn’t ask. If “Windows Defender Firewall has blocked some features of this app” appears anyway:

• Ticking Private networks is enough, then Allow access.
• You don’t need “Public networks”.
• Cancelled by accident? The overlay and auto-tracking on the same PC still work.

1. Gleicher Raum? Vergleicht den Code oben neben „Raum:“. Ein Tippfehler öffnet einen eigenen, leeren Raum.
2. Internet? Ohne Verbindung kann nichts synchronisiert werden. Steht oben „Speichern fehlgeschlagen“, wird es automatisch erneut versucht.
3. LED prüfen: Grau heißt, der Live-Kanal steht nicht. Änderungen kommen dann trotzdem an, aber erst nach einigen Sekunden.
4. Tippt gerade jemand? Solange ein Eingabefeld aktiv ist, wird der Bildschirm nicht neu gezeichnet – klick einmal daneben.
5. App neu starten. Haben beide gleichzeitig dasselbe geändert, führt der Tracker die Stände zusammen und zeigt einen Hinweis.

1. Same room? Compare the code at the top next to “Room:”. A typo opens a separate, empty room.
2. Internet? Without a connection nothing can sync. If “Save failed” is shown at the top, it retries automatically.
3. Check the LED: grey means the live channel is down. Changes still arrive, just after a few seconds.
4. Is someone typing? While an input field is active the screen isn’t redrawn – click next to it once.
5. Restart the app. If you both changed the same thing at once, the tracker merges the states and shows a notice.

• Version 2.0.0 sucht noch nicht selbst nach Updates. Neue Versionen lädst du von der Download-Seite und installierst sie über die alte.
• Vorher die App beenden: Fenster mit dem X schließen. Läuft sie im Infobereich weiter, dort Rechtsklick aufs Symbol › Beenden. Sonst kann der Installer die Dateien nicht ersetzen.
• Kommt die SmartScreen-Warnung wieder? Das ist nach jedem Update normal, weil Windows jede neue Datei erst kennenlernen muss: Weitere Informationen › Trotzdem ausführen.
• Blockiert ein Virenscanner die Datei, hilft es oft, den Download dort freizugeben. Lade den Installer nur von dieser Website.
• Deine Räume liegen online und gehen beim Neuinstallieren nicht verloren.

• Version 2.0.0 does not look for updates by itself yet. Download new versions from the download page and install them over the old one.
• Quit the app first: close the window with the X. If it keeps running in the notification area, right-click the icon there › Quit. Otherwise the installer cannot replace the files.
• The SmartScreen warning is back? That is normal after every update, because Windows has to get to know each new file: More info › Run anyway.
• If an antivirus blocks the file, allowing the download there often helps. Only download the installer from this website.
• Your rooms live online and are not lost when reinstalling.

• Ist in der App auf der Seite LIVE (Gruppe VERBINDEN) der Schalter Auto-Tracking an? Ohne ihn fragt die App die Bridge nicht ab.
• Ist das Skript geladen und das Scripting-Fenster noch offen? (Tools › Scripting…)
• Läuft die App? Den Status der Bridge zeigt Einstellungen › Desktop-App: LÄUFT, PORT BELEGT oder NICHT DABEI (diese App-Version bringt die Bridge nicht mit).
• Das Skript findest du dort über „mGBA-Skript im Explorer zeigen“ oder per Rechtsklick auf das Symbol im Infobereich (Ordner %APPDATA%\Jonix Soullink Tracker\mgba\).
• Nur die englische FeuerRot/BlattGrün (US/EU) wird erkannt, die deutsche Fassung noch nicht. Der Spielstand braucht mindestens ein Pokémon.
• Port 7777 belegt? Siehe oben.

• Is the Auto-tracking switch on on the app’s LIVE page (CONNECT group)? Without it the app does not ask the bridge.
• Is the script loaded and the scripting window still open? (Tools › Scripting…)
• Is the app running? The bridge status is shown under Settings › Desktop app: RUNNING, PORT IN USE or NOT INCLUDED (this app version does not include the bridge).
• You find the script there via “Show mGBA script in Explorer” or by right-clicking the notification area icon (folder %APPDATA%\Jonix Soullink Tracker\mgba\).
• Only the English FireRed/LeafGreen (US/EU) is detected, the German version not yet. The save needs at least one Pokémon.
• Port 7777 in use? See above.

• Die App muss laufen – das Overlay kommt von 127.0.0.1:7788 auf demselben PC. Standardmäßig beendet das X die App; damit sie weiterläuft, „Beim Schließen in den Tray minimieren“ einschalten.
• Port gewechselt? Dann hat sich auch die Overlay-Adresse geändert (siehe Port belegt).
• URL frisch aus dem Streaming-Tab kopieren; alte Adressen von jonix-soullinktracker.com funktionieren nicht mehr.
• In OBS: Rechtsklick auf die Quelle › Aktualisieren.
• Breite/Höhe der Quelle auf 1920×1080 prüfen.

• The app has to run – the overlay comes from 127.0.0.1:7788 on the same PC. By default the X quits the app; to keep it running, turn on “Minimize to tray on close”.
• Changed the port? Then the overlay address has changed too (see Port in use).
• Copy the URL fresh from the Streaming tab; old addresses from jonix-soullinktracker.com no longer work.
• In OBS: right-click the source › Refresh.
• Check that the source is 1920×1080.

Bei hartnäckigen Problemen hilft die Log-Datei. Am einfachsten: Einstellungen › Desktop-App › Erweitert › Logs im Explorer zeigen. Oder von Hand:

1. Win+R drücken.
2. %APPDATA%\Jonix Soullink Tracker\logs eingeben und mit Enter bestätigen.
3. Die Datei main.log (ältere Einträge in main.log.1) kannst du beim Bug-Melden anhängen oder den relevanten Teil hineinkopieren.

For stubborn problems the log file helps. The easiest way: Settings › Desktop app › Advanced › Show logs in Explorer. Or by hand:

1. Press Win+R.
2. Enter %APPDATA%\Jonix Soullink Tracker\logs and confirm with Enter.
3. You can attach main.log (older entries in main.log.1) to a bug report or paste the relevant part.

In der App unter SYSTEM › Bug melden: kurz beschreiben, was passiert ist und was du erwartet hättest. Ein Screenshot hilft enorm.

In the app under SYSTEM › Report Bug: briefly describe what happened and what you expected. A screenshot helps a lot.