Simple tool for labelling tournament vods to upload to YouTube using the start.gg API for set data. I designed this tool to work with vods recorded using the AverMedia Live Gamer Portable 2 Plus, since I bring a few to tournaments I go to and there isn't a way to have it label the vods, but it should work with any vods (though if you're uploading stream vods there are better tools out there for managing that process, such as Streameta).
Download the latest version from the releases page. Run it once to generate all of the files and folders. You will need to generate a start.gg API key; instructions to do so can be found here. Once generated, copy it and paste it into token.txt. You will also need to install the userscript.js with a userscript manager like TamperMonkey.
Put the VODs you want to upload into the videos folder and run the program. It will prompt you for a start.gg tournament link and a short name for the tournament (see Title/Description Templates). It will then open the first vod in your default media player and print a list of all sets in the tournament, grouped by round, with a id in green next to each one. Enter the id of the set for that video and respond to the remaining prompts and repeat for all remaining videos. After you have finished all of the videos, it will copy an export code to your clipboard and save it to export.json as a backup. Open the YouTube Creator Studio and begin your uploads. If you have setup the userscript correctly, pressing ctrl+F8 will prompt you to paste the export code. Once entered, you can press F8 while on the details page of a video to automatically enter the title and description. The detection for this relies on the filename matching, so do not rename the files after running the script.
VODr allows you to customize the titles and descriptions of your videos with dynamic templates. You can edit the templates using the following files:
- Title:
/templates/title.txt - Description:
/templates/description.txt
Note that YouTube only allows titles up to 100 characters long. Titles can get very long when expanding template strings, particularly if a player played many different characters, so I recommend using %TournamentShort and %RoundShort for titles to avoid exceeding this limit.
| Argument | Description | Example |
|---|---|---|
%Tournament |
Full tournament name | Local of Lafayette 69 |
%TournamentShort |
Abbreviated tournament name | LoL#69 |
%Link |
Link to the tournament on start.gg | https://start.gg/tournament/local-of-lafayette-69 |
%Event |
Name of the event | Singles |
%Phase |
Name of the phase | Pools |
%RoundFull |
Full round name | Winners Round 1 |
%RoundShort |
Abbreviated round name | WR1 |
%Game |
Game title | Super Smash Bros. Ultimate |
%P1 |
Player 1 tag (includes prefix) | puff.rest | Yhsanave |
%P2 |
Player 2 tag (includes prefix) | Not Yhsanave |
%P1Chars |
Characters for player 1 | Jigglypuff |
%P2Chars |
Characters for player 2 | Sonic, Yoshi, Steve |
Template:
%TournamentShort %Event %Phase %RoundShort - %P1 (%P1Chars) vs %P2 (%P2Chars)
Output:
LoL#69 Singles Pools WR1 - puff.rest | Yhsanave (Jigglypuff) vs Not Yhsanave (Sonic, Yoshi, Steve)
Template:
%P1 vs %P2 playing %Game at %Tournament in %Round
Bracket: %Link
This is the bit of the description where I would include other information or link to my other socials, but since this is just an example to demonstrate how one would put this part in the description I won't actually put anything meaningfull here. You can put any text in these templates, only the special strings listed above will be dynamically replaced.
Output:
puff.rest | Yhsanave vs Not Yhsanave playing Super Smash Bros. Ultimate at Local of Lafayette 69 in Winners Round 1
Bracket: https://start.gg/tournament/local-of-lafayette-69
This is the bit of the description where I would include other information or link to my other socials, but since this is just an example to demonstrate how one would put this part in the description I won't actually put anything meaningfull here. You can put any text in these templates, only the special strings listed above will be dynamically replaced.