Skip to content

About

GitHub-style Letterboxd graph and stats widgets for Glance dashboards (custom-api).

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

glance-letterboxd-widgets

GitHub-style Letterboxd widgets for Glance, powered by one JSON URL.

Glance custom-api Data source letterboxd-graph Letterboxd data YAML MIT License

Overview • Quick Start • Recommended Look • Widget Options • References • Troubleshooting

Letterboxd graph hero preview


Overview

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

Data Flow

  1. Your letterboxd-graph workflow generates images/letterboxd-data.json.
  2. Glance reads that raw JSON via LETTERBOXD_JSON_URL.
  3. Both widgets render directly in Glance without an extra backend container.

Quick Start

  1. Copy widgets/letterboxd-graph.yml and widgets/letterboxd-stats.yml into your Glance widgets/ folder.
  2. Set LETTERBOXD_JSON_URL in your .env or Glance environment.
  3. Include both widgets in glance.yml.
LETTERBOXD_JSON_URL=https://raw.githubusercontent.com/<user>/letterboxd-graph/main/images/letterboxd-data.json
pages:
  - name: Home
    columns:
      - size: full
        widgets:
          - $include: widgets/letterboxd-graph.yml
          - $include: widgets/letterboxd-stats.yml

Reference config: examples/glance.yml


Recommended Look

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: true

Notes:

  • year must exist in your letterboxd-data.json (year / years values).
  • scale-by-max: true improves contrast for Letterboxd activity levels.
  • fit-width: true removes horizontal scrolling in narrow columns.

Widget Options

Graph (widgets/letterboxd-graph.yml)

Letterboxd graph widget preview

- 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

Stats (widgets/letterboxd-stats.yml)

Letterboxd stats widget preview

- 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

References

  • Design inspiration: haondt/glance-github-graph
    Contribution graph layout, visual direction, and option conventions.

  • Dashboard platform: glanceapp/glance
    Widget implementation targets Glance custom-api behavior and config style.


Troubleshooting

Colors do not match configured values

  1. Confirm /opt/glance/widgets/letterboxd-graph.yml contains your current color values.
  2. Restart Glance and do a hard refresh (Ctrl+F5).
  3. Keep hex values exact (for preset matching): #161b22 and #39d353.

Graph still shows horizontal scrolling

Set fit-width: true in graph options.

Include parsing fails

Use:

- $include: widgets/letterboxd-graph.yml

The included file must remain a list item (- type: ...).

Selected year shows no data

  1. Confirm options.year exists in letterboxd-data.json.
  2. Confirm LETTERBOXD_JSON_URL points to the latest raw file.
  3. Confirm Glance can reach that URL from its runtime network.

License

MIT. See LICENSE.

About

GitHub-style Letterboxd graph and stats widgets for Glance dashboards (custom-api).

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors