No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-03 14:16:23 +08:00
examples Expand playlist schema 2026-07-03 14:16:23 +08:00
LICENSE Initial commit 2026-04-12 03:35:10 +00:00
playlist.schema.json Expand playlist schema 2026-07-03 14:16:23 +08:00
README.md add shared playlist schema and example playlist 2026-04-12 12:04:48 +08:00

hana-playlist-schema

Shared JSON Schema for Hana playlist data.

This schema is used by both:

  • HanaPlayer
  • hana-mpv-scripts

Purpose

This repository provides a single source of truth for playlist structure and validation rules, so both projects can stay compatible.

What It Describes

playlist.json is a video list.

Each video item contains:

  • Exactly one video track
  • Zero or more external audio tracks
  • Zero or more subtitle tracks
  • At most one danmaku track

In addition to track definitions, the playlist also carries basic metadata such as playlist name, description, and timestamps.

Files

  • playlist.schema.json: JSON Schema (Draft 2020-12) for playlist payloads.
  • examples/playlist.json: Example playlist data compatible with the schema.

Example

Use examples/playlist.json as a reference when creating your own playlist file.