Skip to main content

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

Project description


Build Status Coverage Status pypi version Updates Python 3 Black code style


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 .wav files for each pairing. The .wav files contain 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


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smash-tourney-0.2.0.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

smash_tourney-0.2.0-py3-none-any.whl (5.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page