wav2polaris

wav2polaris is a Python library and command-line utility for converting lightsaber sound font .wav files into .RAW files for use with a Polaris Anima-based lightsaber, such as those from Lama di Luce or LudoSport Atlas.

Lightsaber icons created by Nhor Phai - Flaticon. Sound wave icon by KMpumlwana (WMF), CC0, via Wikimedia Commons

Features

• Automatically converts the input .wav to the correct sound parameters for Polaris Anima
• Automatically translate file names from various common lightsaber sound font formats (CFX, Proffie, Verso, Xenopixel) to Polaris Anima standard
• Can process a single file or mutliple files at once
• Can process all .wav files in a directory/folder
• Supports File Explorer drag-and-drop or command-line usage

Program Usage

Drag-and-Drop

Download the pre-built executable for your OS. In Windows Explorer or macOS Finder, drag the files or folder you want to convert onto the wav2polaris icon. wav2polaris will convert any .wav files and place the equivalent .RAW files in the same location.

Command Line

Download the pre-built executable for your OS. Place it in the folder with your .wav files or somewhere in your environment's PATH.

Alternately, you can clone the GitHub repository, install the requirements with pip3 install -r requirements.txt, and invoke with Python >= 3.10: python3 wav2polaris.py

usage: wav2polaris [-h] [-v] [-s | -w] [-c] [-D] [-N] [-o OUTDIR] [files ...]

A utility for converting lightsaber sound font .wav files to .RAW files for Polaris Anima sabers.

positional arguments:
  files                 one or more .wav files to convert (separated by spaces)

options:
  -h, --help            show this help message and exit
  -v, --version         display version and author information, then exit
  -s, --silent          exit without waiting for keypress
  -w, --wait            wait for keypress before exiting (default)
  -c, --continue-on-file-not-found
                        if one or more specified files do not exist, continue processing the remaining files (otherwise program will exit)
  -D, --debug           Show debugging information
  -N, --no-rename       do not attempt to rename output files to Polaris standards (e.g., CLASH_1_0.RAW)
  -o OUTDIR, --outdir OUTDIR
                        put output files in specified directory (will be created if it does not exist)