<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - fork/replay-manager-for-slippi @ 2.3.7</title>
<meta name="description" content="README.md in fork/replay-manager-for-slippi at 2.3.7.">
<meta property="og:title" content="README.md - fork/replay-manager-for-slippi @ 2.3.7">
<meta property="og:description" content="README.md in fork/replay-manager-for-slippi at 2.3.7.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="2.3.7" data-tip="937a09d7041226132f26a1b70f306827aae4d37a">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/replay-manager-for-slippi</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/replay-manager-for-slippi</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Nicolet</span><span class="commit-message" data-commit="704b90b32814455558aafa2bb3f5151d6906107b">Replay Manager -&gt; Replay Reporter</span><span class="snapshot-sha sha" data-commit="704b90b32814455558aafa2bb3f5151d6906107b">704b90b</span><time datetime="2026-02-09T13:48:24-06:00" title="2026-02-09 13:48:24 -0600">2026-02-09</time></p>
<header class="topbar"><details class="switcher"><summary>2.3.7</summary><div class="menu"><strong>branches</strong><a href="/fork/replay-manager-for-slippi/ref/main/">main</a><strong>tags</strong><a href="/fork/replay-manager-for-slippi/ref/2.3.4/">2.3.4</a><a href="/fork/replay-manager-for-slippi/ref/2.3.5/">2.3.5</a><a href="/fork/replay-manager-for-slippi/ref/2.3.6/">2.3.6</a><a class="current" href="/fork/replay-manager-for-slippi/ref/2.3.7/">2.3.7</a><a href="/fork/replay-manager-for-slippi/ref/2.4.0/">2.4.0</a><a href="/fork/replay-manager-for-slippi/ref/2.4.1/">2.4.1</a><a href="/fork/replay-manager-for-slippi/ref/2.5.0/">2.5.0</a><a href="/fork/replay-manager-for-slippi/ref/2.5.1/">2.5.1</a><a class="all" href="/fork/replay-manager-for-slippi/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/replay-manager-for-slippi/">replay-manager-for-slippi</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>3.9 KiB</span><span>70 lines</span></span><span class="actions"><a class="raw" href="/fork/replay-manager-for-slippi/raw/68c9af3e7d1f3188b656e9e48eb47794b144ae88/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Replay Reporter for Slippi</h1>
<p>The shortcoming of Slippi replays is that they work per-game, while much of console Melee is played per-set. Now, USB hotswap in Slippi Nintendont makes it practical to collect replays per-set. With Replay Reporter for Slippi we can add player names, scores, and information about the set all while reporting the result to start.gg in the same amount of time. The result is replays grouped and labelled by set, packaged together with all relevant context, henceforth referred to as <em>Per-Set Replays</em>. <em>Per-Set Replays</em> can then be used for Auto Streaming and Auto VODs.</p>
<p>Mac users, please see how to <a href="https://support.apple.com/en-gb/guide/mac-help/mh40616/mac">open an app from an unidentified developer</a>.</p>
<p><a href="http://github.com/jmlee337/replay-manager-for-slippi/releases/latest"><img src="https://github.com/user-attachments/assets/0f155c5c-bd25-45fb-99f7-db055a380e12" alt="Download" /></a></p>
<h2>Features</h2>
<ul>
<li>Auto-detect USB drive</li>
<li>"Safely Remove" USB drive on replay folder deletion</li>
<li>Mark set started<br />
<img src="https://github.com/user-attachments/assets/026bed5f-59a8-43f9-82b5-cdfdc88368c9" alt="Screenshot 2024-07-20 101744" /></li>
<li>Report winner or DQ maually<br />
<img src="https://github.com/user-attachments/assets/bd927d3d-26d6-48b4-82dd-663b957da014" alt="Screenshot 2024-07-20 101736" /><br />
<img src="https://github.com/user-attachments/assets/6db64645-52be-4ba6-9c06-728913aa6f0d" alt="Screenshot 2024-07-20 101806" /></li>
<li>1-click report, copy, delete<br />
<img src="https://github.com/user-attachments/assets/d6c2d916-4d82-4d84-8878-63f9731d7cbc" alt="Screenshot 2024-07-20 100937" /></li>
<li>Batch set players<br />
<img src="https://github.com/user-attachments/assets/5df4f4af-9715-4141-b150-65d1a6f0a236" alt="ezgif-2-173f6cddcc" /></li>
<li>Set players per match if necessary<br />
<img src="https://github.com/user-attachments/assets/ba0c6227-7d9b-49a7-90d5-160c37d000fb" alt="ezgif-2-ced60802c4" /></li>
<li>Set winner<br />
<img src="https://github.com/user-attachments/assets/423633af-74ca-47c3-872a-f96d24de076a" alt="ezgif-7-a894f4189f" /></li>
<li>Override winner<br />
<img src="https://github.com/user-attachments/assets/acc7f9cb-bb2d-4db5-b733-5e5468fcff76" alt="ezgif-7-86d9cca68a" /></li>
<li>Unset winner<br />
<img src="https://github.com/user-attachments/assets/2363ca84-0464-4963-b0aa-1f27911bfe70" alt="ezgif-7-34f4f654c4" /></li>
<li>Swap Zelda/Sheik<br />
<img src="https://github.com/user-attachments/assets/4f88c0ca-0efd-4968-b791-ffed3eed193e" alt="ezgif-2-9c596e3604" /></li>
<li>Re-time replays according to your PC clock (so you don't have to keep your Wii clocks in sync)<br />
<img src="https://github.com/user-attachments/assets/6f3ad5e9-9d26-4997-a524-c016ac9202d3" alt="image" /></li>
<li>Can use a manually entered list of names if not using start.gg or challonge<br />
<img src="https://github.com/user-attachments/assets/a4335fb1-c6f1-4299-b586-a1805d759847" alt="Screenshot 2024-08-09 at 20 49 31" /></li>
<li>Search player tags with ctrl/cmd-f<br />
<img src="https://github.com/user-attachments/assets/5e5a2215-85e0-4f6e-ab1d-2f4bd67f58f7" alt="Untitled2" /></li>
<li>Re-order replays/fix start times with ctrl/cmd-t<br />
<img src="https://github.com/user-attachments/assets/853fa3b0-37f8-4cce-a230-7dd49b816e32" alt="Untitled" /></li>
<li>Generate context for tiebreaker sets<br />
<img src="https://github.com/user-attachments/assets/147ed7e2-b8f3-4a96-86a2-aff7bede9c45" alt="Screenshot 2024-08-15 at 16 07 49" />
<img src="https://github.com/user-attachments/assets/c10b8882-42a5-4428-bf9c-61a56c0f2172" alt="Screenshot 2024-08-15 at 16 07 18" /></li>
</ul>
<h2>Users</h2>
<p>Please <a href="https://github.com/jmlee337/replay-manager-for-slippi/discussions">check discussions/ask for help</a> before <a href="https://github.com/jmlee337/replay-manager-for-slippi/issues">checking issues/filing a bug report or feature request</a>.</p>
<h2>Development</h2>
<p>Clone the repo and install dependencies:</p>
<pre class="language-bash"><a-f>git</a-f> clone https://github.com/jmlee337/replay-manager-for-slippi.git replay-manager-for-slippi
<a-f>cd</a-f> replay-manager-for-slippi
<a-f>npm</a-f> install</pre>
<p>I use <code>node</code> version 20. Try switching to that if <code>npm install</code> still fails after installing <code>node-gyp</code> dependencies.</p>
<p>Start the app in the <code>dev</code> environment:</p>
<pre class="language-bash"><a-f>npm</a-f> run start</pre>
<p>To package apps for the local platform:</p>
<pre class="language-bash"><a-f>npm</a-f> run package</pre>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Replay Reporter for Slippi</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">The shortcoming of Slippi replays is that they work per-game, while much of console Melee is played per-set. Now, USB hotswap in Slippi Nintendont makes it practical to collect replays per-set. With Replay Reporter for Slippi we can add player names, scores, and information about the set all while reporting the result to start.gg in the same amount of time. The result is replays grouped and labelled by set, packaged together with all relevant context, henceforth referred to as _Per-Set Replays_. _Per-Set Replays_ can then be used for Auto Streaming and Auto VODs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">Mac users, please see how to [open an app from an unidentified developer](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">[![Download](https://github.com/user-attachments/assets/0f155c5c-bd25-45fb-99f7-db055a380e12)](http://github.com/jmlee337/replay-manager-for-slippi/releases/latest)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>##</a-p> <a-tt>Features</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>- </a-p>Auto-detect USB drive</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"><a-p>- </a-p>&quot;Safely Remove&quot; USB drive on replay folder deletion</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>- </a-p>Mark set started  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-07-20 101744](https://github.com/user-attachments/assets/026bed5f-59a8-43f9-82b5-cdfdc88368c9)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>- </a-p>Report winner or DQ maually  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-07-20 101736](https://github.com/user-attachments/assets/bd927d3d-26d6-48b4-82dd-663b957da014)  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-07-20 101806](https://github.com/user-attachments/assets/6db64645-52be-4ba6-9c06-728913aa6f0d)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>- </a-p>1-click report, copy, delete  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-07-20 100937](https://github.com/user-attachments/assets/d6c2d916-4d82-4d84-8878-63f9731d7cbc)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>- </a-p>Batch set players  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>  </a-p>![ezgif-2-173f6cddcc](https://github.com/user-attachments/assets/5df4f4af-9715-4141-b150-65d1a6f0a236)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>- </a-p>Set players per match if necessary  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>  </a-p>![ezgif-2-ced60802c4](https://github.com/user-attachments/assets/ba0c6227-7d9b-49a7-90d5-160c37d000fb)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>- </a-p>Set winner  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>  </a-p>![ezgif-7-a894f4189f](https://github.com/user-attachments/assets/423633af-74ca-47c3-872a-f96d24de076a)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>- </a-p>Override winner  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>  </a-p>![ezgif-7-86d9cca68a](https://github.com/user-attachments/assets/acc7f9cb-bb2d-4db5-b733-5e5468fcff76)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>- </a-p>Unset winner  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>  </a-p>![ezgif-7-34f4f654c4](https://github.com/user-attachments/assets/2363ca84-0464-4963-b0aa-1f27911bfe70)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>- </a-p>Swap Zelda/Sheik  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>  </a-p>![ezgif-2-9c596e3604](https://github.com/user-attachments/assets/4f88c0ca-0efd-4968-b791-ffed3eed193e)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>- </a-p>Re-time replays according to your PC clock (so you don&#39;t have to keep your Wii clocks in sync)  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>  </a-p>![image](https://github.com/user-attachments/assets/6f3ad5e9-9d26-4997-a524-c016ac9202d3)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>- </a-p>Can use a manually entered list of names if not using start.gg or challonge  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-08-09 at 20 49 31](https://github.com/user-attachments/assets/a4335fb1-c6f1-4299-b586-a1805d759847)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>- </a-p>Search player tags with ctrl/cmd-f  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>  </a-p>![Untitled2](https://github.com/user-attachments/assets/5e5a2215-85e0-4f6e-ab1d-2f4bd67f58f7)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>- </a-p>Re-order replays/fix start times with ctrl/cmd-t  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>  </a-p>![Untitled](https://github.com/user-attachments/assets/853fa3b0-37f8-4cce-a230-7dd49b816e32)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>- </a-p>Generate context for tiebreaker sets  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-08-15 at 16 07 49](https://github.com/user-attachments/assets/147ed7e2-b8f3-4a96-86a2-aff7bede9c45)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>  </a-p>![Screenshot 2024-08-15 at 16 07 18](https://github.com/user-attachments/assets/c10b8882-42a5-4428-bf9c-61a56c0f2172)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>## </a-p><a-tt>Users</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>Please [check discussions/ask for help](https://github.com/jmlee337/replay-manager-for-slippi/discussions) before [checking issues/filing a bug report or feature request](https://github.com/jmlee337/replay-manager-for-slippi/issues).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>## </a-p><a-tt>Development</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>Clone the repo and install dependencies:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>```</a-p><a-tl>bash</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>git clone https://github.com/jmlee337/replay-manager-for-slippi.git replay-manager-for-slippi</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>cd replay-manager-for-slippi</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>npm install</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>I use `node` version 20. Try switching to that if `npm install` still fails after installing `node-gyp` dependencies.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>Start the app in the `dev` environment:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>```</a-p><a-tl>bash</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>npm run start</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>To package apps for the local platform:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>```</a-p><a-tl>bash</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>npm run package</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>```</a-p></span></span></pre></div></div>
</main>
</body>
</html>
