cinnamon-applet-first-child@beatlink

Cinnamon Applet First Child

Backend API endpoint for the Trilium API Cinnamon panel applet. Surfaces the first child (in Trilium sort order) of a configured parent note, so it can be shown in the Cinnamon panel and clicked to jump straight to it. Useful for a manually-ordered "up next" queue — reorder children in Trilium and the panel follows.

Setup

After installing, open the addon's root note (cinnamon-applet-first-child@beatlink) in Trilium — it renders a Settings screen with the following fields:

Field	Value	Description
apiKey	a random string you choose	Shared secret checked against the applet's configured API key
parentNoteId	pick a note	The first child of this note is surfaced (uses a note picker)

Settings are saved to a persisted note (see TAM's Persistence mechanism) — your edits survive addon updates. The screen and the underlying schema-driven storage are provided by libsettings@beatlink.

Then, in the Cinnamon panel applet's settings:

• Set the API endpoint to first_child_panel (must match the customRequestHandler label on cinnamon-applet-first-child.js)
• Set the API key to the same random string as the apiKey field
• Set the fetch action to get_task
• Set the click action to open_task

How it works

On each poll, the endpoint reads parentNoteId's children in Trilium's own sort order and returns the first one's title and note ID (or blank text if the parent has no children). Clicking the panel item calls back into the endpoint with open_task, which activates that note in Trilium.