117 lines
4.3 KiB
Markdown
117 lines
4.3 KiB
Markdown
# CookieKop
|
|
|
|
CookieKop ist ein datenschutzfreundliches Open-Source-Plugin, um Webseiten mit rechtswidrigen Cookie-Bannern schnell und unkompliziert zu melden.
|
|
|
|
## 🔹 Funktionen
|
|
|
|
- 📸 Screenshot erstellen: Speichere Screenshots von Webseiten mit problematischen Cookie-Bannern.
|
|
- 📧 E-Mail-Vorbereitung: Erzeuge eine fertige E-Mail an die zuständige Datenschutzbehörde deines Bundeslandes.
|
|
- 🛡️ Projektbanner (optional): Automatischer Hinweis auf CookieKop am Ende der E-Mail.
|
|
- 🔒 Datenschutzfreundlich: Alle Daten werden ausschließlich lokal gespeichert. Keine externe Serverkommunikation, kein Tracking.
|
|
- 🏛️ Bundeslandauswahl: CookieKop findet automatisch die richtige Behörde für dein Bundesland.
|
|
|
|
## 🚧 Geplante Funktionen
|
|
|
|
- 📝 Erstellung einer PDF-Datei mit allen Meldungsdaten (aktuell deaktiviert).
|
|
- 📈 Teilen von anonymisierten Statistiken (nur mit aktiver Zustimmung, aktuell deaktiviert).
|
|
|
|
## ❌ Bekannte Fehler
|
|
|
|
- 🦊 Plugin läuft noch nicht in Firefox (Unterstützung ist hier herzlich willkommen!)
|
|
|
|
## 📦 Installation lokal
|
|
|
|
### Für Chromium-basierte Browser (Chrome, Edge, Brave, Vivaldi)
|
|
|
|
1. ZIP herunterladen
|
|
- Entweder eine Release-ZIP von GitLab herunterladen (zum Beispiel `cookiekop_v0.0.1_chromium.zip`),
|
|
- oder eine aktuelle ZIP selbst erstellen (siehe Abschnitt "ZIP selbst erstellen").
|
|
|
|
2. ZIP entpacken
|
|
- Entpacke die ZIP-Datei in einen beliebigen Ordner auf deinem Computer.
|
|
|
|
3. Erweiterungen-Seite öffnen
|
|
- Gehe zu: `chrome://extensions/`
|
|
- Entwicklermodus oben rechts aktivieren.
|
|
|
|
4. Entpackte Erweiterung laden
|
|
- Klicke auf "Entpackte Erweiterung laden".
|
|
- Wähle den entpackten CookieKop-Ordner aus.
|
|
|
|
### Für Mozilla Firefox
|
|
|
|
1. ZIP herunterladen
|
|
- Entweder eine Release-ZIP von GitLab herunterladen (zum Beispiel `cookiekop_v0.0.1_firefox.zip`),
|
|
- oder eine aktuelle ZIP selbst erstellen (siehe Abschnitt "ZIP selbst erstellen").
|
|
|
|
2. ZIP entpacken
|
|
- Entpacke die ZIP-Datei in einen beliebigen Ordner auf deinem Computer.
|
|
|
|
3. Erweiterung temporär laden
|
|
- Öffne Firefox und gehe zu: `about:debugging#/runtime/this-firefox`
|
|
- Klicke auf "Temporäres Add-on laden".
|
|
- Wähle die `manifest.json` Datei im entpackten CookieKop-Ordner aus.
|
|
|
|
Hinweis: In Firefox bleibt die Erweiterung nur bis zum nächsten Browserneustart aktiv.
|
|
|
|
## 📦 ZIP selbst erstellen (optional)
|
|
|
|
Wenn du keine fertige ZIP-Datei verwenden möchtest, kannst du die ZIP-Dateien auch selbst erstellen.
|
|
|
|
1. Terminal oder Konsole öffnen (Git Bash, macOS Terminal, Linux Terminal).
|
|
|
|
2. In den Projektordner wechseln:
|
|
```bash
|
|
cd /pfad/zum/cookiekop/
|
|
```
|
|
|
|
3. Master-Skript ausführen:
|
|
```bash
|
|
./build_all_zips.sh
|
|
```
|
|
|
|
Das Skript erstellt automatisch:
|
|
- `cookiekop_vX.Y.Z_chromium.zip`
|
|
- `cookiekop_vX.Y.Z_firefox.zip`
|
|
|
|
Die ZIP-Dateien befinden sich anschließend im Projektordner und können wie oben beschrieben installiert werden.
|
|
|
|
## 📜 Lizenz
|
|
|
|
Dieses Projekt steht unter der Creative Commons BY-NC-SA 4.0 Lizenz.
|
|
|
|
- Namensnennung erforderlich ("CookieKop by 1337gut und Mitwirkende").
|
|
- Keine kommerzielle Nutzung erlaubt.
|
|
- Veränderungen und Weiterentwicklungen müssen unter gleicher Lizenz veröffentlicht werden.
|
|
|
|
Der vollständige Lizenztext liegt unter `/LICENSE`.
|
|
|
|
## 📣 Haftungsausschluss
|
|
|
|
Es wurde größtmögliche Sorgfalt auf die Entwicklung und rechtliche Konformität gelegt.
|
|
Dennoch erfolgt die Nutzung auf eigene Verantwortung.
|
|
Es wird keine Haftung für eventuelle Schäden, Fehlfunktionen oder rechtliche Folgen übernommen.
|
|
|
|
## 🙌 Mitmachen
|
|
|
|
CookieKop ist ein Community-Projekt.
|
|
Fehler gefunden? Ideen für neue Features?
|
|
Erstelle gerne Issues oder Merge Requests auf GitLab!
|
|
|
|
### 💬 Feedback und Fehler melden
|
|
|
|
Dein Feedback hilft uns, CookieKop noch besser zu machen!
|
|
|
|
Wenn du einen Fehler gefunden hast oder eine Idee zur Verbesserung hast,
|
|
erstelle bitte ein [neues Issue mit unserem Feedback-Formular](https://gitlab.com/1337gut/cookiekop/-/issues/new?issue[template]=Feedback).
|
|
|
|
Vielen Dank für deine Unterstützung! 🚀
|
|
|
|
|
|
## 📢 Hinweis
|
|
|
|
CookieKop befindet sich derzeit in der Beta-Phase (Version 0.0.1).
|
|
Funktionen wie die PDF-Erstellung und das Teilen von Statistiken sind geplant, aber aktuell deaktiviert.
|
|
|
|
## Disclaimer: KI-Nutzung
|
|
Dieses Plugin wurde unter Mitwirkung von ChatGPT erstellt, da meine Programmierkenntnisse nicht ausreichen, um das alleine zu schaffen. |