Magnus/allwatch

Files

T

History

Magnus 89b6af9229 made sync notification global accross modules by integrating it in the shared sync method wrapper and more notification formatting

2026-09-09 21:42:24 +02:00

..

socialwatch sync notification now also shows errors, added startap notification from server and made info bar (module and time) in notification italian style

2026-09-09 20:16:11 +02:00

added back stat trend styling from older commit. I had accidentally removed it somehow

2026-09-08 18:20:07 +02:00

__init__.py

started porting socialwatch into an module. Copied code over and wrote main module file for now

2026-09-03 12:53:17 +02:00

.env.example

a bunch of frontend vibecoding. I hate that this is so much fun. No we have a graph view of all contacts.

2026-09-04 01:01:38 +02:00

module.py

made sync notification global accross modules by integrating it in the shared sync method wrapper and more notification formatting

2026-09-09 21:42:24 +02:00

README.md

added README's to each module and linking them in the main README.md

2026-09-06 13:57:56 +02:00

requirements.txt

started porting socialwatch into an module. Copied code over and wrote main module file for now

2026-09-03 12:53:17 +02:00

README.md

SocialWatch Module

This module fetches contacts and calendar events from a CalDAV+CardDAV server and presents a bunch of information about your social activity.

Setup

(This module lives at /modules/socialwatch)

Make sure to install all the dependencies in requirements.txt
Copy .env.example to .env and populate all fields

Usage

Calendar

All events from the specified calendar will be treated as social gatherings. In the summary section of the event, you can list the names of participants by prefixing them with CALDAV_PARTICIPANT_PREFIX (set in .env). One name per line is allowed. Names will be matched with CardDAV names, or nicknames if available (preferred).

Contacts

If there is a contact you want to exclude from tracking, even though they're included in events already, just add CARDDAV_IGNORE_STR to the notes field.

Endpoints

Endpoint	Contents
`GET /modules/socialwatch/api/events`	List of all calendar events
`GET /modules/socialwatch/api/people`	List of all contacts
`GET /modules/socialwatch/api/people/<person-uid>`	Info about a person, by their UID
`GET /modules/socialwatch/api/events/<person-uid>`	Info about an event, by its UID
`GET /modules/socialwatch/api/people/<person-uid>/photo`	A person's profile picture, if they have one
`GET /modules/socialwatch/api/scores`	Information about social scores (frequency, diversity, total)