Lokale Gmail-opschoontool Zonder Correspondentie Naar Servers Van Derden Te Sturen

Op een gegeven moment opent elk van ons zijn e-mail en ziet tienduizenden ongelezen berichten. Kortingen van winkels waar we vijf jaar geleden iets kochten, servicedigests, meldingen van taaktrackers. Handmatig opschonen in Gmails eigen interface wordt een nachtmerrie omdat Googles webclient terughoudend is bij het verwerken van selecties van meer dan 50-100 berichten tegelijk.

De meeste commerciële e-mailopschoonhulpmiddelen werken op abonnementsbasis. Ze vragen volledige accounttoegang en sturen uw e-mails naar hun eigen servers voor analyse. De auteur van het gmail-cleaner-project koos een andere aanpak: ze schreven een lichtgewicht lokale tool met een webinterface die uitsluitend op uw machine werkt via de officiële Gmail API.

Waarom Lokaal Opschonen

Het hoofdidee achter het project is volledige privacy. Geen backends van derden, geen externe databases en geen betaalde plannen. De hele stack draait lokaal en uw gegevens gaan nergens naartoe.

De applicatie lost vier veelvoorkomende problemen op:

• Vindt nieuwsbrieven en helpt u met één klik af te melden.
• Groepeert e-mails per afzender, zodat u kunt zien wie uw inbox het meest volstopt.
• Verwijdert of archiveert massaal threads van geselecteerde ontvangers.
• Markeert duizenden e-mails als gelezen in een paar seconden.

Alle verwijderde e-mails gaan naar Gmails standaard prullenbak. Als u per ongeluk iets verwijdert dat u nodig had, heeft u 30 dagen om de gegevens te herstellen via Googles standaard webinterface.

Om dingen te versnellen gebruikt het hulpmiddel Gmail API batchverzoeken, waarbij tot 100 bewerkingen in één aanroep worden verpakt. Daarom kost het opschonen van enkele duizenden e-mails minimale tijd.

Wat Er Binnen Zit en Hoe Het Werkt

Onder de motorkap zit Python 3.9+ en een webserver die een strakke interface serveert in de stijl van Gmail zelf.

Vanuit een beveiligingsoogpunt maakt u uw eigen applicatie aan in Google Cloud Console. Dit betekent dat de OAuth-tokens alleen van u zijn en dat machtigingen alleen worden aangevraagd voor wat minimaal noodzakelijk is: lees- en wijzigtoegang om berichten naar de prullenbak te verplaatsen en de gelezen status te wijzigen.

Bestanden credentials.json en token.json worden lokaal opgeslagen. In de Docker-build wordt een apart volume ./data hiervoor geleverd, zodat u na het herstarten van de container geen nieuwe autorisatie nodig heeft.

Hoe Het Project Te Deployen

De eenvoudigste manier om het project te draaien is via Docker. Voor liefhebbers van virtuele omgevingen is er ook een optie met de uv-pakketbeheerder.

Eerst moet u naar Google Cloud Console gaan, een project aanmaken, Gmail API inschakelen en een OAuth Client ID genereren (Webapplicatietype voor Docker of Desktop-app voor directe Python-uitvoering). Zorg ervoor dat u uw e-mail toevoegt aan de lijst met testgebruikers op het OAuth-toestemmingsscherm.

Sla het gedownloade bestand op als credentials.json in de projectroot.

Uitvoeren via Docker

Kloon de repository:

git clone https://github.com/Gururagavendra/gmail-cleaner.git
cd gmail-cleaner

Plaats het credentials.json bestand ernaast en start de container:

docker compose pull && docker compose up

Open vervolgens http://localhost:8766 in uw browser, klik op de Aanmelden-knop, haal de Google-autorisatielink uit de containerlogs en bevestig de toegang.

Uitvoeren via Python en uv

Als u Docker niet wilt instellen, kunt u het script rechtstreeks uitvoeren via uv:

uv sync
uv run python main.py

De interface is beschikbaar op hetzelfde adres http://localhost:8766.

Filters en Data-Export

Naast eenvoudig opschonen bevat het project geavanceerde filters. U kunt e-mails sorteren op bijlagegrootte, datumbereik of standaard Gmail-categorieën (Promoties, Social, Updates, Forums, Primair).

Als u informatie over afzenders en datums wilt bewaren voordat u oude werkcorrespondentie verwijdert, kan de interface metagegevens exporteren naar CSV.

Voor Wie Dit Nuttig Is

Het project is ideaal voor iedereen van wie de inbox de 50.000 berichten heeft gepasseerd en de gratis opslaglimiet van Google Drive nadert.

Ja, de eerste installatie vereist 5-10 minuten werk met Google Cloud Console en het aanmaken van OAuth-sleutels. Maar daarvoor in de plaats krijgt u een tool die uw e-mails niet leest op servers van derden en geen maandelijks abonnement vereist voor basisfunctionaliteit voor opschonen.