196 lines
6.1 KiB
Markdown
196 lines
6.1 KiB
Markdown
---
|
||
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*
|