Statistics

The Statistics plugin analyzes EXIF data from your photos and generates statistics pages showing camera usage, lens preferences, aperture distribution, and more.

Overview

Installation

The Standalone edition has the plugin and the theme extension built in, so there's nothing to install.

In the Full edition, the Statistics feature has two parts:

# 1. The plugin (generates statistics data)
revela plugin install Statistics

# 2. The theme extension (renders charts), recommended; it is a theme package
revela theme install Lumina.Statistics

The plugin generates a statistics.json data file. The Lumina.Statistics extension renders that data as a responsive dashboard with pure-CSS bar charts that inherit the Lumina color scheme.

Without the theme extension, statistics data is still generated, but you'll need custom templates to display it.

Creating a Statistics Page

# Create a statistics page in your source
revela create page statistics

This creates a page with the statistics template:

+++
title = "Photo Statistics"
description = "EXIF statistics from your photo library"
template = "statistics/overview"
+++

The plugin treats any page whose template starts with statistics/ as a statistics page: it aggregates EXIF data from the manifest and writes a data file to .revela/statistics/<page-path>/statistics.json for the theme to render.

Advanced: instead of the statistics template, you can point an existing page at a data file explicitly with a data.statistics front-matter field, for example data.statistics = "camera-stats.json". The plugin then writes that file instead of statistics.json. The name must be a plain file name ending in .json, without folders; otherwise the statistics step stops with a hint.

Generating Statistics

# Generate statistics as part of the full pipeline
revela generate all

# Or run only the statistics step
revela generate statistics

The pipeline order is: scan → calendar → statistics → pages → images. Statistics runs after scan (which collects EXIF data) and before pages (which renders the HTML).

What Gets Analyzed?

Images without EXIF data are counted in the totals but excluded from category breakdowns.

Configuration

Settings are stored in project.json below plugins.statistics:

{
  "plugins": {
    "statistics": {
      "maxEntriesPerCategory": 15,
      "sortByCount": true
    }
  }
}

# Configure interactively
revela config statistics

# Or set specific options (needed in scripts and CI, where Revela doesn't prompt)
revela config statistics --max-entries 20 --sort-by-count false

config statistics writes project.json, so run it inside your project.

The same settings can be supplied as environment variables:

SPECTARA__REVELA__PLUGINS__STATISTICS__MAXENTRIESPERCATEGORY=20
SPECTARA__REVELA__PLUGINS__STATISTICS__SORTBYCOUNT=false

Theme Extension

Lumina.Statistics provides a single-page dashboard with:

• Overview cards: total images, galleries, cameras, and lenses at a glance
• Bar charts for all 9 categories using pure CSS (no JavaScript)
• Responsive layout: the grid adapts from mobile to desktop
• Dark/light mode: inherits Lumina's color scheme automatically
• Hover effects: bar highlight and count display on interaction

Install it alongside the plugin (Full edition only; Standalone has it built in):

revela theme install Lumina.Statistics

CLI Commands

Requirements

• Photos with EXIF data (JPG, TIFF – most cameras write EXIF by default)
• Run revela generate scan first (or use generate all)