Druk op het logo om het zip‑bestand “Addresserij_files_V320260315” te downloaden, pak het vervolgens uit op een locatie naar keuze en laad daarna uw CSV‑bestand in.

Gebruik de toepassing online via de volgende url https://schueremans.net/shareit/Addresserij_web.html

Gebruikershandleiding voor Windows  •  macOS  •  Web (Android / iOS)

Wat doet dit programma?

Addresserij is een applicatie die personen uit een CSV-databestand weergeeft in een overzichtelijke, doorzoekbare tabel. Het programma is ontworpen voor het beheren van familie-, leden- of contactgegevens, maar kan gebruikt worden voor elke adres- of contactdatabase zolang de CSV-structuur wordt aangehouden.

De structuur is volledig herbruikbaar voor uiteenlopende datasets: een sportvereniging, een bedrijfscontactlijst, een vereniging, een familieoverzicht, enzovoort.

Drie versies, één gegevensbestand

Het programma is beschikbaar in drie versies. Alle drie gebruiken hetzelfde CSV-bestand.

Versie	Bestanden	Vereisten	Geschikt voor
Windows	Addresserij.bat + .ps1	Windows 10/11, PowerShell 5.1	Desktop, Dymo-labelprinter
macOS / Linux	Addresserij_mac.py	Python 3.8+	Desktop, Dymo via CUPS
Web	Addresserij_web.html	Elke browser	Android, iPhone, tablet, laptop

Tip: de webversie is het makkelijkst om te delen — stuur het HTML-bestand samen met het CSV door via e-mail, Signal of Onedrive etc.

Het CSV-bestand: de kern van de applicatie

Het CSV-bestand (DataBaseAdressenTemplate.csv) is het hart van het programma. Het bevat alle persoonsgegevens en wordt gelezen door alle drie de versies. Het bestand is een gewoon tekstbestand dat u kunt openen en bewerken met Microsoft Excel, LibreOffice Calc, Google Sheets of een eenvoudige teksteditor zoals Kladblok.

Wat is een CSV-bestand?

CSV staat voor Comma-Separated Values — waarden gescheiden door een scheidingsteken. In dit geval is het scheidingsteken een puntkomma (;), geen komma. Elke regel in het bestand is één persoon en elke kolom wordt gescheiden door een puntkomma.

1a;2;Jo;Block;Idiotstreet;25;;3020;Herent;;3200522330011;jo@block.do;18/01/2202

Kolomstructuur

Kolom	Beschrijving	Verplicht?	Voorbeeld
Familiecode	Unieke code per groep. Bepaalt sortering.	Ja	1a
Generatie	Groepsniveau: 1, 2, 3. Bepaalt kleurcode.	Nee	2
Voornaam	Voornaam van de persoon.	Ja*	Jo
Naam	Familienaam van de persoon.	Ja*	Block
Straat	Straatnaam (zonder huisnummer).	Nee	IdiootStraat
Nr	Huisnummer.	Nee	25
Bus	Busnummer (mag leeg blijven).	Nee
Postcode	Postcode van de gemeente.	Nee	3020
Gemeente	Naam van de gemeente of stad.	Nee	Herent
Land	Land. Mag leeg blijven bij België.	Nee	Belgie
Telefoon	Internationaal formaat, zonder spaties.	Nee	321522003311
Email	E-mailadres.	Nee	jo@idot.proof
Geboren	Geboortedatum DD/MM/JJJJ.	Nee	18/01/1520

* Minstens Voornaam of Naam moet ingevuld zijn. Rijen zonder naam worden genegeerd.

Belangrijke regels voor het CSV-bestand

• Scheidingsteken is een puntkomma (;), geen komma.
• Sla het bestand altijd op als CSV met UTF-8-codering (of ANSI). Nooit als .xlsx of .xls.
• Geboortedatum: gebruik het formaat DD/MM/JJJJ (bv. 15/03/1975). Laat leeg indien onbekend.
• Laat onbekende velden gewoon leeg (niets invullen tussen twee puntkomma’s).
• Telefoonnummers in internationaal formaat zonder spaties of koppeltekens (bv. 32475123456).
• De eerste regel van het CSV-bestand moet de kolomkoppen bevatten.
• Accenten en speciale tekens (é, ë, ç) zijn toegestaan.

Opstarten

Windows

Plaats de drie bestanden (.bat, .ps1 en .csv) in dezelfde map. Dubbelklik op Addresserij.bat.

macOS / Linux

Plaats Addresserij_mac.py en het .csv-bestand in dezelfde map. Open Terminal en typ:

python3 Addresserij_mac.py

Bij een foutmelding over rechten: chmod +x Addresserij_mac.py

Web (Android / iPhone / tablet / laptop)

Open Addresserij_web.html in een browser. Klik op CSV laden en kies uw CSV-bestand. Het bestand wordt alleen lokaal verwerkt — er wordt niets verstuurd.

• Android: Stuur het HTML- en CSV-bestand naar uw telefoon (bv. via Google Drive). Open het HTML-bestand in Chrome.
• iPhone/iPad: Idem, open in Safari of Chrome.

Optioneel: logo als applicatie-icoon

Het bestand Addresserij.png (het logo) kan in dezelfde map geplaatst worden als de applicatiebestanden. De Windows- en macOS-versie laden dit bestand automatisch als venster-icoon. De webversie heeft het logo al ingebouwd in het HTML-bestand. U kunt zowel een PNG als een JPG gebruiken, maar PNG heeft de voorkeur vanwege transparantie-ondersteuning.

Zoeken

Het zoekvak doorzoekt alle velden: voornaam, familienaam, straat, huisnummer, postcode, gemeente, land, telefoon, e-mail en geboortedatum.

• Typ een naam om die persoon en de volledige groep (familietak) te tonen.
• Typ een adres, gemeente of postcode om alle personen op die locatie te vinden.
• Typ een familiecode (bv. 3b) om direct die groep te tonen.
• Zoeken is niet hoofdlettergevoelig.
• Klik op Volledige lijst (of Alles in de webversie) om het volledig overzicht te herstellen.

Exporteren en afdrukken

Word-export

Klik op Word om de huidige lijst op te slaan als Word-document (.doc). Het bestand bevat kleurcodes per generatie en alle kolommen.

PDF-export

Windows/macOS: Klik op PDF om een PDF-rapport op te slaan. Web: Klik op Print en kies «Opslaan als PDF» in het afdrukdialoog van uw browser.

Email Lijst

Klik op Email Lijst om alle e-mailadressen uit de huidige selectie te verzamelen. Er opent een dialoogvenster met drie opties:

• Kopieer adressen — kopieert alle e-mailadressen (gescheiden door puntkomma’s) naar het klembord.
• Kopieer met naam — kopieert in het formaat «Voornaam Naam <email>», klaar voor gebruik in e-mailprogramma’s.
• Open in mail — opent uw standaard e-mailprogramma met alle adressen reeds ingevuld.

De email-lijst toont alleen adressen van de huidige weergave. Zoek of filter eerst om een specifieke groep te selecteren.

Dymo-labelprinter

Beschikbaar in de Windows- en macOS-versie. Selecteer een persoon in de tabel en klik op Dymo Label. Er opent een dialoogvenster met printerkeuze, labelformaat, lettergrootte, marges, oriëntatie en veldselectie. Een live voorbeeld toont het resultaat bij elke wijziging. Alle instellingen worden automatisch bewaard.

Functies per versie

Functie	Windows	macOS	Web
Zoeken (alle velden)	✓	✓	✓
Sorteren op kolom	✓	✓	✓
Word-export (.doc)	✓	✓	✓
PDF-export	✓	✓	✓ (via Print)
Email Lijst	✓	✓	✓
Kleurcodes per generatie	✓	✓	✓
Schaalbaar venster	✓	✓	✓ (responsive)
Instellingen (font, grootte)	✓	✓	—
Dymo-labelprinter	✓	✓ (CUPS)	—
Label setup + live preview	✓	✓	—
Veldselectie per label	✓	✓	—
Detailkaart (tik op rij)	—	—	✓
Directe bel-/mailknop	—	—	✓
Werkt op Android/iOS	—	—	✓

Webversie — extra functies

• Detailkaart: Tik op een rij om een schuifpaneel te openen met alle gegevens, inclusief klikbare telefoon- en emailknoppen.
• Bellen / E-mailen: Op een telefoon kunt u direct bellen of een e-mail sturen vanuit de detailkaart.
• Responsive: De interface past zich aan van telefoonscherm tot ultrabreed scherm.
• Offline: Het bestand werkt volledig offline — geen internetverbinding nodig.
• Geen installatie: Gewoon openen in de browser.

Instellingen (Windows en macOS)

Klik op Instellingen om het volgende aan te passen: lettertype, lettergrootte, vensterbreedte en -hoogte, en de voorkeursprinter voor labels. Instellingen worden bewaard in Addresserij_Settings.json (Windows) of Addresserij_Settings_mac.json (macOS).

Structuur van de familiecodes

Elke persoon krijgt een unieke familiecode die de positie in de groepsstructuur aangeeft. U kunt dit coderingssysteem aanpassen aan uw eigen behoeften.

• 1, 2, 3 … — hoofdgroepen (generatie 1)
• 1a, 1b, 1c … — subgroepen (generatie 2)
• 1a1, 1a2, 1a3 … — sub-subgroepen (generatie 3)

Partners of leden van dezelfde groep krijgen dezelfde familiecode.

Veelgemaakte fouten

Probleem	Oplossing
Tabel is leeg na opstarten	Controleer of het CSV-bestand in dezelfde map staat als de scriptbestanden.
Alle gegevens in één kolom (Excel)	Importeer via de tekstwizard en kies puntkomma als scheidingsteken.
Zoeken geeft geen resultaat	Controleer de schrijfwijze. Probeer een deel van de naam of het adres.
Bestand opgeslagen als .xlsx	Sla opnieuw op als .csv.
Geboortedatum toont verkeerd	Gebruik DD/MM/JJJJ. Laat leeg indien onbekend.
Dymo print niets	Controleer of de printer is aangesloten en gekozen in het labelvenster.
macOS: Permission denied	Typ in Terminal: chmod +x Addresserij_mac.py
Web: CSV wordt niet geladen	Gebruik Chrome of Firefox. Controleer de puntkomma’s.
Web: kolommen missen op telefoon	Normaal — tik op een rij voor alle details.

Bestandsoverzicht

Bestand	Beschrijving
Addresserij.bat	Windows-starter (dubbelklik)
Addresserij.ps1	Windows-programma (PowerShell)
Addresserij_mac.py	macOS/Linux-programma (Python)
Addresserij_web.html	Webversie (alle apparaten)
DataBaseAdressenTemplate.csv	Gegevensbestand (gebruikt door alle versies)
Addresserij.png	Applicatie-logo/icoon (optioneel, in dezelfde map plaatsen)
Addresserij_Settings.json	Instellingen Windows (automatisch aangemaakt)
Addresserij_Settings_mac.json	Instellingen macOS (automatisch aangemaakt)
README_Addresserij.docx	Deze handleiding

CSV openen en opslaan met Excel

Excel opent .csv-bestanden soms verkeerd (alles in één kolom). Volg deze stappen:

• Open Excel en kies Bestand > Openen > Bladeren.
• Selecteer het CSV-bestand. De wizard «Tekst importeren» verschijnt.
• Kies Gescheiden en klik op Volgende.
• Vink alleen Puntkomma aan als scheidingsteken en klik op Voltooien.

Bij het opslaan: kies Opslaan als > CSV (gescheiden door lijstscheidingstekens). Bevestig dat u het CSV-formaat wilt behouden.

Addresserij — Gebruikershandleiding — versie maart 2026

Verantwoordelijke uitgever: Mark Schueremans — mark@schueremans.net

Ontwikkeling en ondersteuning: https://i2f.be