====== GuideOS Adblocker Tool ======

===== Übersicht =====
{{ :adblocker.png?300|}}
Das **GuideOS Adblocker Tool** ist ein Zenity-basiertes Bash-Skript zur systemweiten Blockierung von Werbe-, Malware- und Phishing-Domains über die ''/etc/hosts''-Datei.


===== Zweck =====

Das Tool blockiert unerwünschte Domains auf Systemebene, indem es Einträge in der ''/etc/hosts''-Datei verwaltet. Die Blockierung funktioniert systemweit für alle Browser und Anwendungen. Es kombiniert vordefinierte Blocklisten mit individuellen Einträgen und bietet eine grafische Oberfläche zur Verwaltung.

===== Vordefinierte Blocklisten =====

^ Blockliste ^ Blockierte Inhalte ^
| **StevenBlack Komplett** | Pornografie, Social Media, Fake News, Glücksspiel |
| **StevenBlack-Porn** | Pornografische Inhalte |
| **BlocklistProject-Porn** | Zusätzliche Porno-Blockliste |
| **BlocklistProject-Phishing** | Phishing-Seiten |

===== Bedienung =====

==== Programm starten ====


''guideos-adblocker-tool''


Beim Start wird das sudo-Passwort abgefragt, da Systemdateien geändert werden müssen.

==== Hauptmenü ====

Das Hauptmenü bietet vier Optionen:

  * **Blocklisten aktivieren & deaktivieren**: Auswahl der gewünschten Blocklisten per Checkbox
  * **Eigene Einträge hinzufügen**: Individuelle Domains manuell blockieren
  * **Eigene Einträge verwalten**: Eigene Blockierungen anzeigen und löschen
  * **Beenden**: Programm schließen

==== Blocklisten aktivieren ====

  - "Blocklisten aktivieren & deaktivieren" wählen
  - Gewünschte Listen per Checkbox auswählen (Mehrfachauswahl möglich)
  - Mit "OK" bestätigen
  - Listen werden heruntergeladen und in ''/etc/hosts'' integriert
  - DNS-Cache wird automatisch geleert
  - Browser neu starten für sofortige Wirkung

==== Eigene Domain blockieren ====

  - "Eigene Einträge hinzufügen" wählen
  - Domain eingeben (z.B. ''ads.example.com'' oder ''https://tracking.site.com'')
  - Domain wird sofort blockiert und in ''~/.adblocker_custom'' gespeichert
  - Sowohl die Domain als auch die ''www.''-Variante werden blockiert
  - Browser neu starten

==== Eigene Domains verwalten ====

  - "Eigene Einträge verwalten" wählen
  - Zu löschende Domains per Checkbox auswählen
  - Löschung bestätigen
  - Domains werden aus ''/etc/hosts'' und ''~/.adblocker_custom'' entfernt
  - Browser neu starten

===== Wichtige Hinweise =====

<WRAP round important 80%>
  * Das Tool benötigt **sudo-Rechte** für Systemänderungen
  * Ein **automatisches Backup** wird erstellt unter ''/etc/hosts.adblocker.bak''
  * Änderungen wirken **systemweit** für alle Benutzer
  * **Browser muss komplett geschlossen und neu gestartet werden** (nicht nur Tab schließen!)
  * **Browser-Cache leeren** (Strg+Shift+Entf) für sofortige Wirkung
  * Manche Websites funktionieren möglicherweise nicht ohne Werbenetzwerke
  * Übermäßiges Blockieren kann legitime Websites beeinträchtigen
</WRAP>

===== Funktionsweise =====

Das Tool leitet blockierte Domains zu ''0.0.0.0'' (nirgendwohin) um:

<block round box 60%>
<code>
0.0.0.0 ads.example.com
::1 ads.example.com
</code>
</block>


Anfragen an diese Domains laufen ins Leere, wodurch Werbung und Tracking verhindert werden.

===== Verwendete Dateien =====

^ Datei ^ Zweck ^
| ''/etc/hosts'' | Systemweite Hosts-Datei (wird modifiziert) |
| ''/etc/hosts.adblocker.bak'' | Automatisches Backup der Original-Datei |
| ''~/.adblocker_custom'' | Benutzerdefinierte blockierte Domains |
| ''/etc/hosts.active_lists'' | Speichert aktive Blocklisten |
| ''/etc/hosts.lastupdate'' | Zeitstempel der letzten Aktualisierung |


===== Wiederherstellung =====

Falls Probleme auftreten oder die Blockierung rückgängig gemacht werden soll:

<block round box 60%>
<code bash>
# Original-Hosts wiederherstellen
sudo cp /etc/hosts.adblocker.bak /etc/hosts

# DNS-Cache leeren
sudo systemd-resolve --flush-caches
</code>
</block>

===== Lizenz =====

| **Entwickler** | evilware666 |
| **Lizenz** | MIT |