Files
GeoTurtle/README.md
T

6.1 KiB
Raw Blame History

title, version, date, author, contact, license, tags, draft
title version date author contact license tags draft
GeoTurtl README 0.9.7-beta 2026-06-07 H. Linz linz.on.tour@gmail.com MIT
geoturtl
ip
geolocation
standort
macOS
menubar
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?

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