# Integration: OpenFamily (open source family organization)

**URL:** <https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566>\
**Category:** Développement\
**Tags:** integration-externe\
**Created:** [November 13, 2026, 9:57am UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566 "2026-11-13T09:57:30Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![QuentinCazier](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/quentincazier/32/24132_2.png) [@QuentinCazier](https://community.gladysassistant.com/u/QuentinCazier)\
**Post date:** [November 13, 2026, 9:57am UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/1 "2026-11-13T09:57:30Z")

</div>

Hello,

I’m Quentin, I develop OpenFamily, an open-source, self-hosted family organizer (grocery list, tasks, calendar, weekly schedule, meals, budget), in French and seven other languages: [GitHub - NexaFlowFrance/OpenFamily: The open-source, self-hosted family organizer. Keep full control of your family's data : run it on your own server. · GitHub](https://github.com/NexaFlowFrance/OpenFamily)

We already have integrations with Home Assistant, Nextcloud, Mealie, Grocy, and Immich, and I think Gladys and OpenFamily complement each other well: you manage the home, we manage the family life that takes place there. I read the spec for external integrations and the thread on task and shopping lists (10601): this is exactly what OpenFamily does.

What I imagine, on the Gladys side, in the form of an external integration published in your store (so no work for you):

- the family calendar as a Gladys calendar (type « calendar »), with appointments that trigger scenes;

- dashboard widgets: the day’s schedule, the shopping list, the tasks;

- scene actions « add to shopping list » and « add a task », and a trigger on appointment reminders.

Before coding, two questions:

1. Does this form seem right to you, or do you prefer another approach?

2. Are there any store or SDK constraints I should be aware of for a first draft?

I’m open to feedback, and open to broader collaboration between the two projects.

---

<div class="post-metadata">

**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\
**Post date:** [November 13, 2026, 12:16pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/2 "2026-11-13T12:16:27Z")

</div>

Hi Quentin, and welcome to the forum! 👋

Thanks for taking the initiative and for reading the spec before coding 🙂 I agree about the complementarity: Gladys manages the home, OpenFamily manages family life. The thread about shopping and task lists (10601) shows that there is a real demand.

**1. The form: yes, that’s the right one**

Make a single external integration of `type: "calendar"`. It can also declare `widgets`, `scene_actions`, and `scene_triggers`, as all types can add these capabilities to their main role.

The closest model in the store is **ICS Calendars** ([GitHub - guim31/gladys-ics-calendar: Remote iCalendar (.ics) calendars for Gladys Assistant: Google Calendar secret address, school, waste collection · GitHub](https://github.com/guim31/gladys-ics-calendar)). It does exactly that: a calendar, a “Next Events” widget, triggers, and an action. For lists, check out **Bring!** ([https://github.com/LM1LC3N7/gladys-bring](https://github.com/LM1LC3N7/gladys-bring)) and **Todoist** ([GitHub - LM1LC3N7/gladys-todoist: Gladys Assistant external integration for Todoist: today’s tasks on the dashboard, add and complete tasks from scenes, a “task due” scene trigger. Unofficial, not affiliated with Doist. · GitHub](https://github.com/LM1LC3N7/gladys-todoist)). They already cover shopping and tasks, it’s a good source of inspiration for the user experience.

A few clarifications on each point:

- **The calendar works in “push” mode** : your integration synchronizes, Gladys stores.
  - The calendars sent feed the calendar view and the scenes, like those of the native CalDAV.
  - It’s one-way: Gladys never writes to OpenFamily.
  - Each user activates the integration for themselves, in the “My Calendars” block. Calendars are private by default.
  - **A calendar must be shared** for the whole household to see it and for it to be able to trigger scenes.
  - Be careful with duplicates: if you send the family calendar to each member and each one shares it, it will appear multiple times. It’s better to send it to a single account.

- **Appointment reminders** : you don’t need your own trigger.
  - The native trigger “An event in the calendar is coming up” works directly on the sent calendars. It can be set a little before the start or end of an appointment, with a filter on the name.
  - I would only create a home trigger if the OpenFamily reminders contain information that Gladys doesn’t have, for example a reminder set manually in OpenFamily. This avoids two ways of doing the same thing.

- **Widgets** : they are declarative. Your integration returns content with a fixed vocabulary (list, list of states, tiles, buttons…) and Gladys takes care of the display (theme, dark mode, mobile). A widget is used to display data and to interact with it:
  - **Adding** an item or a task from the widget is possible: a button can open a small form (4 fields maximum) that your integration declares.
  - **Checking** an item: there is not yet a checkbox per line. You can work around this with a “Check” button that opens a selection list (select field) containing the current items, generated at the time of display. If it’s too limiting in use, open a topic: the forms behind the buttons were born from feedback like this.
  - Gladys retrieves the content and keeps it in cache for the duration you set (`ttl_seconds`). When a list changes on the OpenFamily side, send a `widget.refresh` to update the widgets.

- **Scene actions** : “add to shopping list” and “add a task” are perfect for this, and the text fields accept scene variables.
  - Also think of an action “read the list” that returns a result (`outputs`). A scene could, for example, send the shopping list by message when you leave work.
  - Like triggers, “item added”, “task completed” or “task due” come naturally.

**2. Store and SDK constraints for a first draft**

- **Publication** :

- **Docker Image** : it must be on a public registry and built **for amd64 and arm64** , as many Gladys instances run on Raspberry Pi. Start from the template [GitHub - GladysAssistant/integration-template-js: Gladys Assistant Integration template for a JS external integration · GitHub](https://github.com/GladysAssistant/integration-template-js) : it already contains the build workflow for both architectures to GHCR.

- **Container** :

- **SDK** : the official SDK is in Node.js (`@gladysassistant/integration-sdk`). If you prefer another language, the REST/WebSocket API is documented. You can also develop outside Docker with a dev token.

- **Secrets** : put the OpenFamily URL and token in the `config_schema`, with the `secret` type that is never sent to the browser. If each member has their own credentials, use the `account_schema` instead. Never put them in a widget’s settings or a scene’s fields: the manifest validation will reject it.

- **Calendar, technical side** :

- **Widgets** : a maximum of 5 per integration and 8 elements per widget. Images must be served by your integration (PNG, JPEG or WebP, maximum 300 Ko), never via an external URL loaded by the browser.

- **`gladys_version`** : indicate the minimum version of Gladys that supports what you use. An older version will reject a manifest whose fields it does not know.

All the documentation is here: [Créer une intégration externe | Gladys Assistant](https://gladysassistant.com/fr/docs/dev/external-integrations/) (sections « Calendars: the calendar type », « Dashboard widgets » and « Scene triggers and actions »).

---

<div class="post-metadata">

**Author:** ![QuentinCazier](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/quentincazier/32/24132_2.png) [@QuentinCazier](https://community.gladysassistant.com/u/QuentinCazier)\
**Post date:** [November 13, 2026, 12:57pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/3 "2026-11-13T12:57:58Z")

</div>

Thanks Pierre-Gilles, that’s very clear and it answers everything!  
So we’re going with a calendar-type integration with widgets, actions, and triggers, inspired by ICS Calendars, Bring! and Todoist.  
First step on our side: an API token in OpenFamily, so that the integration authenticates properly (config\_schema as type secret).  
Then the repository from the template, tested on a local Gladys via « Install from GitHub ».  
I’ll come back here with a first repository to try.

---

<div class="post-metadata">

**Author:** ![Prof\_Techno](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prof_techno/32/19038_2.png) [@Prof\_Techno](https://community.gladysassistant.com/u/Prof_Techno)\
**Post date:** [November 15, 2026, 9:54am UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/4 "2026-11-15T09:54:58Z")

</div>

> [@QuentinCazier](#):
>
> repository created from the template, tested on a local Gladys via « Install from GitHub ».  
> I’ll come back here with a first repository to

If it works well, I’m interested in replacing the family wall app which is not open source

---

<div class="post-metadata">

**Author:** ![QuentinCazier](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/quentincazier/32/24132_2.png) [@QuentinCazier](https://community.gladysassistant.com/u/QuentinCazier)\
**Post date:** [November 15, 2026, 5:57pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/5 "2026-11-15T17:57:24Z")

</div>

Hi Pierre-Gilles,

It’s done: the OpenFamily integration is live, [GitHub - NexaFlowFrance/gladys-openfamily: OpenFamily for Gladys Assistant: the family calendar, shopping list and tasks on the dashboard and in scenes. · GitHub](https://github.com/NexaFlowFrance/gladys-openfamily). It follows your brief: calendar type, three widgets (today, shopping, tasks) with forms to add and check, four scene actions and three triggers. On the OpenFamily side, we added API tokens for the occasion.

The template, the SDK and the store validator are very pleasant to use, thanks for this work. Tested on a Gladys 5.3.3 in Docker.

Two feedback points, if they can help:

1. When the timezone is not set in the settings, the integration containers receive TZ=UTC while the core falls back to Europe/Paris. Local times are then offset. I added a timezone setting on my side.
2. With Gladys in bridge mode under Docker Desktop (Windows), the integration couldn’t reach gladys:80, the gladys-integrations network being created without communication between containers. Not checked under Linux.

All feedback is welcome, from you and the community.

---

<div class="post-metadata">

**Author:** ![mutmut](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/mutmut/32/14064_2.png) [@mutmut](https://community.gladysassistant.com/u/mutmut)\
**Post date:** [November 15, 2026, 6:21pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/6 "2026-11-15T18:21:19Z")

</div>

Thanks @QuentinCazier for this new integration!

I took the opportunity to change the title 🙂  
And I’ll test it soon 😉

---

<div class="post-metadata">

**Author:** ![mutmut](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/mutmut/32/14064_2.png) [@mutmut](https://community.gladysassistant.com/u/mutmut)\
**Post date:** [November 15, 2026, 7:36pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/7 "2026-11-15T19:36:05Z")

</div>

We’re eagerly awaiting the new integration 😉

 ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/5/b/5bc87b19bdaa95c0feb206c55d1ba116793511ce.png)

Well, I hadn’t seen the GitHub 😅

 ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/9/f/9f34d78e6782c141f230a9876a17c8fba4a3ef62.png)

---

<div class="post-metadata">

**Author:** ![QuentinCazier](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/quentincazier/32/24132_2.png) [@QuentinCazier](https://community.gladysassistant.com/u/QuentinCazier)\
**Post date:** [November 15, 2026, 7:57pm UTC](https://community.gladysassistant.com/t/integration-openfamily-organisation-familiale-open-source/11566/8 "2026-11-15T19:57:43Z")

</div>

A little patience please 😃  
I’ve put Gladys at the top of the list, we will always prioritize applications and others that share the same philosophy as us 🙂

Edit:  
It’s all good 😉

 ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/6/e/6e290d24b2cca67fcebe58b0c90759561a4883d7.png)
