Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@gcpreston/slippi-viewer

gcpreston36MIT0.1.16

View Slippi replays and streams in the browser

slippi, project-slippi, slp, melee, ssbm

readme

slippi-viewer

A Web Component for viewing Slippi replays and streams in the browser. Extracted from Slippi Lab.

Features

  • <input checked="" disabled="" type="checkbox"> View replays
  • <input checked="" disabled="" type="checkbox"> View streams
  • <input checked="" disabled="" type="checkbox"> Pause/play/rewind/fast forward/skip
  • <input disabled="" type="checkbox"> Highlights
  • <input checked="" disabled="" type="checkbox"> Use as custom element
  • <input disabled="" type="checkbox"> Use as SolidJS component

Usage

<slippi-viewer zips-base-url="/" />

The zips-base-url attribute refers to where to find the character data for the visualizer. If you have your own site, it is recommended to host the zips yourself. Using zips-base-url="/" says "look for a folder called zips at the root of this site, and load each character's data from there". An example of this setup can be found at examples/replay.

It is also possible to fetch zips from a remote URL. At the time of writing, this works for both SpectatorMode (via zips-base-url="https://spectatormode.tv), and Slippi Lab.

Replay mode

const viewer = document.querySelector("slippi-viewer");
const replayFileData; // get from file upload input, for example
viewer.setReplay(replayFileData);

Spectate mode

const viewer = document.querySelector("slippi-viewer");
viewer.spectate("wss://spectatormode.tv/viewer_socket/websocket?stream_id=<stream ID>");

The spectate example points to the websocket URL where a stream can be found on SpectatorMode, to give a concrete example.