--- title: "GeoTurtl README" version: "0.9.7-beta" date: 2026-06-07 author: "H. Linz" contact: "linz.on.tour@gmail.com" license: "MIT" tags: [geoturtl, ip, geolocation, standort, macOS, menubar] draft: false --- # 🐱 GeoTurtl v0.9.7-beta **GeoTurtl** ist eine kleine, unauffĂ€llige App fĂŒr deinen Mac. Sie sitzt als Schildkröten-Symbol 🐱 in der MenĂŒleiste und zeigt dir jederzeit auf Knopfdruck, wo du gerade bist – und wie deine Verbindung ins Internet aussieht. > **Beta-Hinweis:** Dies ist eine Beta-Version (v0.9.6). Sie ist funktionsfĂ€hig, > kann aber noch kleinere Fehler enthalten. RĂŒckmeldungen sind willkommen! --- ## Inhaltsverzeichnis - [Was ist GeoTurtl und was macht es?](#was-ist-geoturtl-und-was-macht-es) - [Welche Installations- und Systemvoraussetzungen gibt es?](#welche-installations--und-systemvoraussetzungen-gibt-es) - [Ist die Software sicher?](#ist-die-software-sicher) - [Wie installiere ich GeoTurtl?](#wie-installiere-ich-geoturtl) - [Wie starte und stoppe ich GeoTurtl?](#wie-starte-und-stoppe-ich-geoturtl) - [Wo finde ich die Log-Dateien und wie rufe ich sie auf?](#wo-finde-ich-die-log-dateien-und-wie-rufe-ich-sie-auf) - [Wie deinstalliere ich GeoTurtl restlos?](#wie-deinstalliere-ich-geoturtl-restlos) - [Haftungsausschluss](#haftungsausschluss) - [Was mache ich, wenn ich Fragen, Anregungen oder konstruktive Kritik habe?](#was-mache-ich-wenn-ich-fragen-anregungen-oder-konstruktive-kritik-habe) --- ## Was ist GeoTurtl und was macht es? GeoTurtl zeigt dir zwei Dinge auf einen Blick: **Deinen Standort** GeoTurtl nutzt die eingebaute Ortungsfunktion deines Macs (dieselbe Technik, die auch Apple Maps verwendet) und zeigt dir deine aktuelle Adresse, die genauen Koordinaten (Breiten- und LĂ€ngengrad), deine Höhe ĂŒber dem Meeresspiegel sowie die Genauigkeit der Ortung an. Mit einem Klick öffnest du deinen Standort direkt in Google Maps, Apple Maps oder OpenStreetMap. **Deine IP-Adressen** GeoTurtl ermittelt deine öffentliche IPv4- und (falls vorhanden) IPv6-Adresse – also die Adresse, unter der du im Internet sichtbar bist. Dazu zeigt es dir den ungefĂ€hren Standort dieser Adresse und deinen Internetanbieter an. Per Klick kannst du beide Adressen direkt in die Zwischenablage kopieren. GeoTurtl aktualisiert diese Informationen automatisch – du kannst selbst einstellen, wie oft (alle 1, 5 oder 15 Minuten, oder gar nicht). --- ## Welche Installations- und Systemvoraussetzungen gibt es? - Einen **Mac mit macOS** (ab macOS Ventura, optimiert fĂŒr macOS Tahoe) - **Python 3** – auf modernen Macs in der Regel bereits vorinstalliert - Eine aktive **Internetverbindung** fĂŒr die Installation - **Aktivierte Ortungsdienste** auf deinem Mac Die Installation erledigt alles Weitere automatisch fĂŒr dich. --- ## Ist die Software sicher? Ja. GeoTurtl ist quelloffen (MIT-Lizenz) – du kannst den kompletten Programmcode jederzeit selbst einsehen. Das Programm: - sendet **keine** Daten an Dritte außer den öffentlichen Ortungs- und IP-Diensten (ipinfo.io, ipify.org) - speichert **keine** persönlichen Daten dauerhaft - lĂ€uft ausschließlich **lokal** auf deinem Mac - ist **werbefrei** und kostenlos Die Ortungsdienste werden nur auf ausdrĂŒckliche Anfrage genutzt – macOS fragt beim ersten Start nach deiner Erlaubnis. --- ## Wie installiere ich GeoTurtl? Öffne das Terminal (Programme → Dienstprogramme → Terminal) und fĂŒhre diese zwei Befehle aus: **Schritt 1** – Datei ausfĂŒhrbar machen: ``` chmod +x ~/Downloads/GeoTurtl_v0.9.7-beta/GeoTurtl_install_v0.9.7-beta.sh ``` **Schritt 2** – Installation starten: ``` ~/Downloads/GeoTurtl_v0.9.7-beta/GeoTurtl_install_v0.9.7-beta.sh ``` **Schritt 3** – Ortungsdienste erlauben: Beim ersten Start erscheint eine macOS-Meldung. Klicke auf **„Beim Verwenden erlauben"**. Falls die Meldung ausbleibt: > Systemeinstellungen → Datenschutz & Sicherheit → Ortungsdienste > → Terminal → „Beim Verwenden" --- ## Wie starte und stoppe ich GeoTurtl? **Starten** – im Terminal: ``` geoturtl_start ``` **Stoppen** – im Terminal: ``` geoturtl_stop ``` GeoTurtl startet nach der Installation **automatisch** bei jedem Mac-Login. --- ## Wo finde ich die Log-Dateien und wie rufe ich sie auf? GeoTurtl schreibt alle wichtigen Ereignisse in eine Log-Datei: ``` ~/Library/Logs/GeoTurtl.log ``` **Log live verfolgen:** ``` tail -f ~/Library/Logs/GeoTurtl.log ``` **Letzte 50 Zeilen anzeigen:** ``` tail -50 ~/Library/Logs/GeoTurtl.log ``` **Log im Texteditor öffnen:** ``` open ~/Library/Logs/GeoTurtl.log ``` --- ## Wie deinstalliere ich GeoTurtl restlos? Alles auf einmal entfernen – diesen Befehl ins Terminal kopieren: ``` geoturtl_stop 2>/dev/null; \ launchctl unload ~/Library/LaunchAgents/com.user.geoturtl.plist 2>/dev/null; \ rm -f ~/Library/LaunchAgents/com.user.geoturtl.plist; \ rm -rf /Applications/Scripte/python/GeoTurtl; \ rm -f ~/Library/Logs/GeoTurtl.log; \ rm -f ~/Library/Application\ Support/GeoTurtl.pid; \ sed -i '' '/geoturtl/d' ~/.zshrc; \ source ~/.zshrc; \ echo "✓ GeoTurtl vollstĂ€ndig entfernt." ``` --- ## Haftungsausschluss GeoTurtl wurde von **H. Linz** nach bestem Wissen und Gewissen entwickelt und kostenlos zur VerfĂŒgung gestellt. Dennoch gilt: - Die Software wird **„so wie sie ist" (as is)** bereitgestellt – ohne Garantie auf Fehlerfreiheit, ununterbrochenen Betrieb oder Eignung fĂŒr einen bestimmten Zweck. - **H. Linz ĂŒbernimmt keine Haftung** fĂŒr direkte oder indirekte SchĂ€den, Datenverluste oder sonstige BeeintrĂ€chtigungen durch Installation, Nutzung oder Deinstallation dieser Software. - Die Nutzung von Drittdiensten (ipinfo.io, ipify.org) unterliegt den jeweiligen Nutzungsbedingungen dieser Anbieter und liegt außerhalb der Verantwortung des Autors. - **Jede Person installiert und nutzt diese Software auf eigene Gefahr.** - Durch die Installation erkennst du diese Bedingungen an. Diese Software steht unter der **MIT-Lizenz**. --- ## Was mache ich, wenn ich Fragen, Anregungen oder konstruktive Kritik habe? Du schickst mir eine Nachricht an **linz.on.tour@gmail.com**. Ich beantworte sie dann, so schnell es mir möglich ist. **H. Linz** --- *GeoTurtl v0.9.7-beta · MIT License · © 2026 H. Linz*