Dateien nach "/" hochladen
This commit is contained in:
Holger Linz
@@ -1,2 +1,195 @@
|
||||
# GeoTurtle
|
||||
---
|
||||
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*
|
||||
|
||||
Reference in New Issue
Block a user