slp to mp4

slp-to-mp4 converts Project Slippi replay files for Super Smash Bros. Melee to mp4 videos.

The goal is to make it easy to batch-convert replays to HD video without screen recording software.

Dependencies

Python >= 3.7
https://www.python.org/downloads/
ffmpeg for combining the raw the video and audio streams (if on Linux you can install with your package manager)
https://ffmpeg.org/download.html
A 'playback build' of Dolphin. This is a special Dolphin used for playing back Slippi replays.
- If your replays are from the latest rollback Slippi (e.g. 2.2.3) you can get the playback dolphin by installing Slippi Desktop App:
  https://slippi.gg/downloads
  On Windows, the playback dolphin will be installed somewhere like: C:\Users\YourName\AppData\Roaming\Slippi Desktop App\dolphin
- FM-Slippi-r18 playback dolphin can be found here:
  https://www.smashladder.com/download/dolphin/18/Project+Slippi+%28r18%29
py-slippi for parsing the slippi file (pip install)
https://github.com/hohav/py-slippi
psutil for finding number of physical cores (pip install) https://github.com/giampaolo/psutil

A Super Smash Bros. Melee v1.02 NTSC ISO.

Setup

Install the above dependencies to your machine.

Linux

Modify the paths in config.json to point to your Melee ISO, ffmpeg binary and the directory of the playback instance of Dolphin.

Windows

Modify the paths in config_windows.json to point to your Melee ISO, ffmpeg binary and the directory of the playback instance of Dolphin.

Usage

slp-to-mp4.py REPLAY_FILE [OUTPUT_FILE_OR_DIRECTORY]

slp-to-mp4.py DIRECTORY_WITH_SLP_REPLAYS

This launches Dolphin, which plays the replay and dumps frames and audio.
Then ffmpeg is invoked to combine audio and video.

If recording one replay file with no output file specified, the video file with the same name will be placed in slp2mp4/out.

If recording a directory and not combining, the individual games will be placed in a subfolder in slp2mp4/out/ with the .slp parent folder's name. Example:

Name_Of_Event/Game_1234.slp
Name_Of_Event/Set_A/Game_1234.slp
Name_Of_Event/Set_A/Game_1235.slp

gives

slp2mp4/out/Name_Of_Event/Game_1234.mp4
slp2mp4/out/Set_A/Game_1234.mp4
slp2mp4/out/Set_A/Game_1235.mp4

If recording a directory and combining, one video will be created in slp2mp4/out/ for each subdirectory with the .slp parent folder's name. Example:

Name_Of_Event/Game_1234.slp
Name_Of_Event/Set_A/Game_1234.slp
Name_Of_Event/Set_A/Game_1235.slp

gives

slp2mp4/out/Name_Of_Event.mp4
slp2mp4/out/Set_A.mp4

Configuration

For linux, the configuration file is config.json. For Windows, the file is config_windows.json.

'melee_iso' is the path to your Super Smash Bros. Melee 1.02 ISO.
'dolphin_dir' and 'ffmpeg' in linux need to be set to the playback path in the installed version of dolphin, and the default installed path of ffmpeg. In windows, these dependencies are downloaded and installed in the local directory so there is no need to change the paths; 'ffmpeg' can also be the command name if it's in your PATH
'resolution' can be set to the following. The output resolution is the minimum resolution dolphin can run above the resolution in this configuration.
- 480p
- 720p
- 1080p
- 1440p
- 2160p
'widescreen' can be true or false. Enabling will set the resolution to 16:9
'bitrateKbps' must be a number. It selects the bitrate in Kilobits per second that dolphin records at.
'parallel_games' must be a number greater than 0 or "recommended". This is the maximum number of games that will run at the same time. "recommended" will select the number of physical cores in the CPU.
'remove_short' can be true or false. Enabling will not record games less than 30 seconds. Most games less than 30 seconds are handwarmers, so it can save time not to record them.
'combine': can be true or false, and matters only when recording a folder of .slp files. If false, the .mp4 files will be left in their subfolders in the output folder. If true, each subfolder of .mp4 files will be combined into .mp4 files in the output folder.

Performance

Resolution, widescreen, bitrate, and the number of parallel games will all affect performance. Dolphin will not record well (skips additional frames) when running less than or greater than 60 FPS. It becomes noticeable below 58 FPS. YouTube requires a resolution of at least 720p to upload a 60 FPS video, so it should be a goal to run at that resolution or higher. A higher bitrate will come with better video quality but larger file size and worse performance because dolphin has more to encode. The number of parallel games will have the largest effect on performance. The 'recommended' value is the number of physical cpu cores, but greater or fewer parallel games may be optimal.

Future work

Make installation/setup easier
- There was previously an auto-installer for ffmpeg + playback dolphin on windows, but it relied on a direct download of the playback dolphin, which isn't available for the latest slippi
- Would be nice to remove dependencies on py-slippi and psutil somehow.
- Package everything in a release
Multiprocessing
- Allow combining after all required files are done recording while multiprocessing
- Better progress reporting
- Warning on completion if average runtime frame rate is below 58 fps
Run Dolphin at higher emulation speed if possible
GUI

NunoDasNeves/slp-to-mp4