smash-tourney 0.1.1

The Open Source Super Smash Bros. 1v1 randomizer with customizable "versus" voice implementer!

smash-tourney

About

A simple Python script that, given a list of player names, outputs a random pairing of them (representing two players who will fight) and creates .mp3 files for each pairing. The .mp3 file contains a text-to-speech reading of the first player's name, followed by a customizable phrase (say, a classic "VERSUS" line?) and ends with the second player's name.

smash_tourney accepts a versus.wav file in your working directory. This is used to customize the sound used in the end result. Previously, I had included the file in this repository, but I'm not quite sure I'm allowed to do that. Instead, I'll link to The Sounds Resource, where you can find Smash Bros announcer voice samples. Make sure the file is called versus.wav inside your working directory!

How to use

Intended for use with Python >= 3.6.

smash_tourney depends on two external libraries: pydub to handle audio files and gTTS to interface with Google's text-to-speech API.

You can install smash_tourney using pip!

$ pip install smash-tourney

Next, you'll need to create a file with line-separated names for the players who will be participating the the tourney.

You're ready to run the script! Suppose the file with the player names is called names.txt in the current directory. Then simply run:

$ smash-tourney names.txt

IMPORTANT

smash_tourney will create a folder called tourney in its working directory, where it will store the created .wav files for convenience.