Lovebox Dagbericht

Stuurt elke ochtend een afbeelding (320×240) naar je Lovebox met:

de weersverwachting + kledingadvies voor de kinderen, en
de eerstvolgende verjaardagen en activiteiten.

De container draait continu en verstuurt zelf dagelijks — geen losse cron nodig.

Deze repo is bewust publiek-veilig: alle persoonsgegevens (login, box-id, namen en datums, locatie) komen uit omgevingsvariabelen. Er staat niets gevoeligs in git.

Voorbeeld

Dagelijkse weergave	Feestmodus op de verjaardag

_{Schermafbeeldingen met fictieve namen/datums (320×240).}

Hoe werkt het?

Onderdeel	Bron
Weer	Open-Meteo — gratis, geen API-key; retry bij een tijdelijke storing, en het bericht gaat door zónder weer als het definitief niet lukt
Kledingadvies	Afgeleid van max-temp, neerslag en wind (zie tabel onderaan)
Verjaardagen/activiteiten	JSON in env-vars
Versturen	Lovebox GraphQL-API (`sendPixNote`)

Weer is best-effort. Open-Meteo geeft af en toe kortstondig een fout (bijv. een 503). Daarom wordt de verwachting met een paar retries (met oplopende wachttijd) opgehaald. Lukt het daarna nog niet, dan blokkeert dat het dagbericht niet: het gaat door zónder weer (met een "Weer even niet beschikbaar"-melding), zodat de verjaardagen/activiteiten alsnog verschijnen.

Wat wordt er getoond aan datums?

Verjaardagen verschijnen pas als ze binnen 30 dagen vallen (LOVEBOX_BIRTHDAY_WINDOW_DAYS).
Activiteiten verschijnen binnen een instelbaar venster (LOVEBOX_EVENT_WINDOW_DAYS, standaard 30 dagen).
Er worden maximaal 2 datums tegelijk getoond (LOVEBOX_MAX_SLOTS), waarbij verjaardagen voorrang krijgen op activiteiten.
Op de verjaardag zelf verschijnt een feestelijke weergave: een grote "Gefeliciteerd {naam}!" met ballonnen, confetti en sterren (in plaats van het kledingadvies). Vallen er twee verjaardagen op dezelfde dag, dan worden beide namen getoond.

Configuratie

Kopieer .env.example naar .env en vul in. .env staat in .gitignore — commit hem nooit.

cp .env.example .env

Verplicht

Variabele	Omschrijving
`LOVEBOX_EMAIL`	Je Lovebox-account e-mail
`LOVEBOX_PASSWORD`	Je Lovebox-wachtwoord
`LOVEBOX_BOX_ID`	Het id van de doelbox (zie hieronder)

Optioneel

Variabele	Default	Omschrijving
`LOVEBOX_LAT` / `LOVEBOX_LON`	`52.3415` / `5.6147`	Coördinaten voor het weer
`LOVEBOX_LOCATION_NAME`	`Harderwijk`	Naam in de header
`LOVEBOX_BIRTHDAYS`	–	JSON-lijst met verjaardagen
`LOVEBOX_EVENTS`	–	JSON-lijst met activiteiten
`LOVEBOX_BIRTHDAY_WINDOW_DAYS`	`30`	Venster voor verjaardagen
`LOVEBOX_EVENT_WINDOW_DAYS`	`30`	Venster voor activiteiten
`LOVEBOX_MAX_SLOTS`	`2`	Max. aantal datums op de afbeelding
`LOVEBOX_RUN_AT`	`07:00`	Tijdstip van dagelijks versturen
`LOVEBOX_TZ`	`Europe/Amsterdam`	Tijdzone van de scheduler
`LOVEBOX_RUN_ON_START`	`false`	Meteen versturen bij (her)start
`LOVEBOX_RUN_ONCE`	`false`	Eén keer versturen en stoppen

Formaat van verjaardagen/activiteiten

Beide zijn een JSON-lijst van {"name": ..., "date": ...}:

LOVEBOX_BIRTHDAYS=[{"name":"Emma","date":"2018-03-15"},{"name":"Sem","date":"07-01"}]
LOVEBOX_EVENTS=[{"name":"Schoolreisje","date":"2026-07-10"},{"name":"Sinterklaas","date":"12-05"}]

"date": "YYYY-MM-DD" → met jaar. Bij een verjaardag wordt de leeftijd getoond ("Emma wordt 8"); bij een activiteit is het eenmalig (verdwijnt na de datum).
"date": "MM-DD" → jaarlijks terugkerend (verjaardag zonder leeftijd, of een terugkerende activiteit zoals Sinterklaas).

Privacy: dit zijn persoonsgegevens (namen/datums, deels van kinderen). Houd ze in .env / de container-omgeving; zet ze nooit in de publieke repo.

Box-ID ophalen (eenmalig)

curl -s -X POST https://app-api.loveboxlove.com/v1/auth/loginWithPassword \
  -H "content-type: application/json" \
  -d '{"email":"jouw@email.nl","password":"jouwWachtwoord"}'

Pak de token uit het antwoord, dan:

TOKEN="..."
curl -s -X POST https://app-api.loveboxlove.com/v1/graphql \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"operationName":"me","variables":{},"query":"query me { me { boxes { _id nickname } } }"}'

Kopieer de _id van de gewenste box naar LOVEBOX_BOX_ID.

Lokaal draaien / testen

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Eén keer versturen (schrijft ook een preview-PNG):
LOVEBOX_RUN_ONCE=true python -m lovebox.main

# Tests + lint:
pytest
ruff check .
ruff format --check .

Bij LOVEBOX_RUN_ONCE=true wordt de afbeelding vóór verzenden opgeslagen als lovebox_preview.png (in /data als dat bestaat, anders /tmp).

Deployen op TrueNAS (custom app)

De container is self-scheduling: hij blijft draaien en verstuurt dagelijks rond LOVEBOX_RUN_AT. Geen webserver → geen ports of reverse-proxy nodig. Zo staat hij netjes in je apps-lijst.

1. Zorg dat de ghcr-package public is (of geef TrueNAS een pull-credential), anders kan pull_policy: always het image niet ophalen.

2. Zet je .env op een vast pad, bijv. /mnt/apps/lovebox/.env, met de credentials + agenda-JSON (zie Configuratie). Zorg dat LOVEBOX_RUN_ONCE=false en dat het pad exact klopt.

3. Apps → Discover Apps → ⋮ → Install via YAML, naam lovebox, en plak:

services:
  lovebox:
    image: ghcr.io/arjankapteijn/lovebox:latest
    container_name: lovebox
    pull_policy: always
    restart: unless-stopped
    env_file: /mnt/apps/lovebox/.env   # absoluut pad! relatief .env wordt /tmp/.env
    read_only: true
    tmpfs:
      - /tmp:size=8m
    volumes:
      - lovebox-data:/data             # named volume: erft app:app uit het image
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    mem_limit: 256m
    pids_limit: 128

volumes:
  lovebox-data:

4. Start. Optioneel eerst LOVEBOX_RUN_ON_START=true in de .env om de deploy meteen te testen (daarna weer op false, anders stuurt elke herstart een bericht). Zet je oude cron-job uit zodra de container draait.

De container draait als non-root, met read-only rootfs, cap_drop: ALL, no-new-privileges en een healthcheck op een heartbeat-bestand in /data.

Twee valkuilen (uit ervaring):

Gebruik een absoluut env_file-pad. Een relatief .env wordt door TrueNAS naar /tmp/.env herleid en niet gevonden.

Gebruik een named volume voor /data, geen tmpfs. Een tmpfs is niet schrijfbaar voor de non-root app-user, waardoor het heartbeat-bestand niet geschreven wordt, de healthcheck faalt en de app op "deploying" blijft hangen.

Een eigen icoon in de Apps-lijst

TrueNAS custom apps hebben geen icoon-veld in de YAML; de zichtbaarheid komt uit de app-metadata. Zet het icoon in het per-app-bestand /mnt/.ix-apps/app_configs/lovebox/metadata.yaml — als sleutel onder het metadata:-blok. Niet in het globale /mnt/.ix-apps/metadata.yaml: dat wordt bij elke deploy opnieuw opgebouwd, waardoor je icon-regel wordt gewist. Het per-app-bestand blijft wél staan over updates heen.

Als root op TrueNAS:

# bekijk de structuur, voeg dan de icon-regel als eerste kind van "metadata": toe
sed -i '/^"metadata":/a\  "icon": "https://raw.githubusercontent.com/arjankapteijn/lovebox/main/docs/icon.png"' \
  /mnt/.ix-apps/app_configs/lovebox/metadata.yaml

Een edit op schijf pakt TrueNAS pas op na een redeploy: ga in de UI naar Apps → lovebox → Edit → Save (zonder wijzigingen). Daarna eventueel een harde browser-refresh (Ctrl/Cmd+Shift+R) tegen de icoon-cache.

Updaten

:latest + pull_policy: always: app opnieuw deployen → nieuwste image. Voor reproduceerbaarheid kun je een vaste tag pinnen (bijv. ghcr.io/arjankapteijn/lovebox:0.3.2) en die bumpen.

CI/CD & versiebeheer

Zelfde opzet als arjankapteijn.nl:

.github/workflows/ci.yml — bij elke push/PR: ruff + pytest.
.github/workflows/docker-publish.yml — bij push naar main wordt automatisch de volgende semver afgeleid uit de commit-messages (conventional commits: feat → minor, !/BREAKING CHANGE → major, anders patch), een git-tag + GitHub Release aangemaakt, en het image naar ghcr.io gepusht.
.github/dependabot.yml — wekelijkse update-PR's voor pip, het Docker-base-image en de GitHub Actions.

Na de eerste push: zet Dependabot alerts + security updates aan via GitHub → Settings → Code security and analysis, en zet de ghcr.io-package op public.

Kledingadvies-logica

Max temperatuur	Broek	Bovenkleding
≥ 24 °C	Korte broek	Korte mouwen
22–24 °C	Korte broek	T-shirt + vest
18–22 °C	Lange broek	T-shirt + vest
12–18 °C	Lange broek	Trui / sweater
< 12 °C	Warme broek	Warme jas

Extra: regenjas mee bij ≥ 3 mm, eventueel regenjas bij 0,5–3 mm, windproof jas bij ≥ 50 km/u.

Bronnen

Open-Meteo API (gratis, geen key): https://open-meteo.com
Lovebox GraphQL reverse-engineering: https://swizec.com/blog/reverse-engineer-a-graphql-api-to-automate-love-notes-codewithswiz-24/
patbaumgartner/lovebox-telegram-sender (config-naming, me-query)
npm lovebox-client (bevestiging senderDeviceId = me.device._id)

Name		Name	Last commit message	Last commit date
.github		.github
docs		docs
src/lovebox		src/lovebox
tests		tests
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
SECURITY.md		SECURITY.md
docker-compose.yml		docker-compose.yml
pyproject.toml		pyproject.toml

Navigation Menu

Repository navigation

About

Repository files navigation

Lovebox Dagbericht

Voorbeeld

Hoe werkt het?

Wat wordt er getoond aan datums?

Configuratie

Verplicht

Optioneel

Formaat van verjaardagen/activiteiten

Box-ID ophalen (eenmalig)

Lokaal draaien / testen

Deployen op TrueNAS (custom app)

Een eigen icoon in de Apps-lijst

Updaten

CI/CD & versiebeheer

Kledingadvies-logica

Bronnen

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Lovebox Dagbericht

Voorbeeld

Hoe werkt het?

Wat wordt er getoond aan datums?

Configuratie

Verplicht

Optioneel

Formaat van verjaardagen/activiteiten

Box-ID ophalen (eenmalig)

Lokaal draaien / testen

Deployen op TrueNAS (custom app)

Een eigen icoon in de Apps-lijst

Updaten

CI/CD & versiebeheer

Kledingadvies-logica

Bronnen

About

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages