Settings

settings is an optional top-level section holding work-wide defaults: typography and balloon styling, reader UI behavior, asset preloading, and per-output-format presets. Everything here is a default — many values cascade down and can be overridden at more specific levels (character, panel, layer).

Settings has four optional property groups: typography, ui, preload, and outputPresets.

settings.typography

Global text and page styling defaults for the work.

Reusable style presets

Both maps work like CSS classes for the manifest: define shared styling once, reference it by name, and restyle every referencing element by editing the preset in one place.

• textStyles maps a preset name to a TextStyle (font, sizePt, color, strokeColor, strokeWidth). A text layer opts in with styleRef; its inline style fields override the preset field-by-field.
• balloonPresets maps a preset name to a BalloonConfigOverride. A speech bubble opts in with styleRef; the preset slots into the balloon cascade as work → character → preset → bubble.

{
  "settings": {
    "typography": {
      "textStyles": {
        "caption": { "font": "CrimsonPro", "sizePt": 14, "color": "#fdf6e3", "strokeColor": "#0a1a24", "strokeWidth": 3 }
      },
      "balloonPresets": {
        "speech-down-right": { "tail": { "position": 150, "length": 50 } },
        "shout-down-right": { "balloonType": "shout", "strokeWidth": 4, "tail": { "position": 150, "length": 50 } }
      }
    }
  }
}

settings.ui

Reader-behavior defaults. The player exposes matching toggles (controlled via UI settings); these values seed them.

The three video*Default fields follow the same cascade pattern as balloon config: the work default applies whenever a video layer does not specify its own value.

settings.preload

Controls how aggressively the player prefetches upcoming panel assets.

Panels can additionally hint specific assets via preloadHints — see Panels.

settings.outputPresets and FormatPreset

outputPresets maps an OutputFormat name to a FormatPreset. The schema lists the eight classic formats as named properties (flex-landscape, mobile-portrait, bigscreen-landscape, a4-portrait, a4-landscape, us-portrait, us-landscape, video-16-9) and additionally accepts any other key with a FormatPreset value (covering square, desktop-landscape, tablet-portrait).

FormatPreset

Individual panels can further restrict views per format with formatViews (allowPageView / allowPanelView / minimalFocusRect) — see Panels.

Example

{
  "settings": {
    "typography": {
      "default_font": "Roboto",
      "default_font_size": 14,
      "default_page_bg_color": "#111111",
      "gutter_width": 10,
      "panel_border_style": { "color": "#000000", "thickness": 1, "style": "solid" },
      "textStyles": {
        "caption": { "font": "Roboto", "sizePt": 14, "color": "#ffffff", "strokeColor": "#000000", "strokeWidth": 3 }
      },
      "balloonPresets": {
        "whisper-soft": { "balloonType": "whisper", "strokeWidth": 1 }
      }
    },
    "ui": {
      "mangaMode": false,
      "autoplayDefault": false,
      "secondsPerPanel": 4,
      "speechDefault": true,
      "audioDefault": true,
      "sfxDefault": true,
      "scrollingDefault": true,
      "videoPlayModeDefault": "once",
      "videoStartModeDefault": "on-view",
      "videoMutedDefault": true
    },
    "preload": {
      "strategy": "lookahead",
      "panelsAhead": 2,
      "maxConcurrent": 4
    },
    "outputPresets": {
      "bigscreen-landscape": {
        "panelView": true,
        "pageView": true,
        "defaultTransition": { "type": "slide", "dir": "left", "durationMs": 400 }
      },
      "mobile-portrait": {
        "panelView": true,
        "pageView": false,
        "defaultTransition": { "type": "fade", "durationMs": 200 }
      }
    }
  }
}