GitHub-style Letterboxd widgets for Glance, powered by one JSON URL.
Overview • Quick Start • Recommended Look • Widget Options • References • Troubleshooting
This repository ships two drop-in Glance custom-api widgets inspired by glance-github-graph, but rendered from your Letterboxd diary JSON.
| Widget | Purpose | File |
|---|---|---|
| Graph | Yearly heatmap with fixed full-year grid (empty days stay visible) | widgets/letterboxd-graph.yml |
| Stats | Compact summary row (films, active days, streak) and optional recent list |
widgets/letterboxd-stats.yml |
- Your
letterboxd-graphworkflow generatesimages/letterboxd-data.json. - Glance reads that raw JSON via
LETTERBOXD_JSON_URL. - Both widgets render directly in Glance without an extra backend container.
- Copy
widgets/letterboxd-graph.ymlandwidgets/letterboxd-stats.ymlinto your Glancewidgets/folder. - Set
LETTERBOXD_JSON_URLin your.envor Glance environment. - Include both widgets in
glance.yml.
LETTERBOXD_JSON_URL=https://raw.githubusercontent.com/<user>/letterboxd-graph/main/images/letterboxd-data.jsonpages:
- name: Home
columns:
- size: full
widgets:
- $include: widgets/letterboxd-graph.yml
- $include: widgets/letterboxd-stats.ymlReference config: examples/glance.yml
Use these defaults for the closest GitHub-like visual style:
options:
year: 2026
background-color: "#161b22"
primary-color: "#39d353"
transition-hue: false
scale-by-max: true
fit-width: trueNotes:
yearmust exist in yourletterboxd-data.json(year/yearsvalues).scale-by-max: trueimproves contrast for Letterboxd activity levels.fit-width: trueremoves horizontal scrolling in narrow columns.
- type: custom-api
title: Letterboxd Graph
cache: 5m
url: ${LETTERBOXD_JSON_URL}
options:
year: 2026
background-color: "#161b22"
primary-color: "#39d353"
svg-height: 150
fit-width: true
show-months: true
show-weekdays: true
font-size: 9
transition-hue: false
scale-by-max: true| Option | Type | Default | Description |
|---|---|---|---|
year |
int | 2026 |
Year to render (must exist in your JSON data) |
background-color |
string | #161b22 |
Empty-day cell color |
primary-color |
string | #39d353 |
Active-day cell color |
svg-height |
int | 150 |
Target graph height used for sizing and fit-width scaling |
fit-width |
bool | true |
Fit graph to widget width and prevent horizontal scrolling |
show-months |
bool | true |
Month labels |
show-weekdays |
bool | true |
Weekday labels |
font-size |
int | 9 |
Label font size |
transition-hue |
bool | false |
Interpolate shades from background to primary |
scale-by-max |
bool | true |
Scale intensity to the selected year's max daily count |
- type: custom-api
title: Letterboxd Stats
cache: 5m
url: ${LETTERBOXD_JSON_URL}
options:
show-recent: false
recent-limit: 5
show-updated: false| Option | Type | Default | Description |
|---|---|---|---|
show-recent |
bool | false |
Show recent watched list |
recent-limit |
int | 5 |
Number of recent entries |
show-updated |
bool | false |
Relative generatedAt timestamp |
-
Design inspiration:
haondt/glance-github-graph
Contribution graph layout, visual direction, and option conventions. -
Dashboard platform:
glanceapp/glance
Widget implementation targets Glancecustom-apibehavior and config style.
- Confirm
/opt/glance/widgets/letterboxd-graph.ymlcontains your current color values. - Restart Glance and do a hard refresh (
Ctrl+F5). - Keep hex values exact (for preset matching):
#161b22and#39d353.
Set fit-width: true in graph options.
Use:
- $include: widgets/letterboxd-graph.ymlThe included file must remain a list item (- type: ...).
- Confirm
options.yearexists inletterboxd-data.json. - Confirm
LETTERBOXD_JSON_URLpoints to the latest raw file. - Confirm Glance can reach that URL from its runtime network.
MIT. See LICENSE.

