LipTalk Audio Converter - Installation Guide

Back

πŸ“¦ Step 0: Download & Extract

Download the liptalk_converter_2026_source package and extract it to your computer.

🐍 Step 1: Install Python 3.11.5

Python 3.11.5 is required:

  1. Go to the Windows or macOS archive.
  2. Download and install Version 3.11.5.
  3. Windows: Check "Add Python 3.11 to PATH" during installation!

βš™οΈ Setup & Execution

πŸͺŸ Windows

1. Open Folder:
Enter liptalk_converter_resource_files. Click the address bar, type cmd and press Enter.

2. Activate Venv:

py -3.11 -m venv venv
venv\Scripts\activate
⚠️ Keep this terminal window open!

3. Install Modules:

⏳ Large Download (~1GB). Please wait:
pip install -r requirements.txt

4. Run Program:

python liptalk_converter_2026.py
πŸš€ Future Starts:
To start the converter later without installing everything again:

Option A (Double-Click):
Run START_AUDIOCONVERTER.bat

Option B (Manual): Activate venv and run:

venv\Scripts\activate
python liptalk_converter_2026.py

🍎 macOS

1. Open Terminal:
Right-click liptalk_converter_resource_files β†’ Services β†’ New Terminal at Folder.

2. Homebrew Check:
Type brew --version.
β€’ If you see a version: Skip to step 3.
β€’ If "command not found": Run this install command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
πŸ”‘ Note: Type your Mac Password and press Enter (Invisible while typing!). Press Enter again when asked to continue.

3. Setup Environment:

brew install cmake
πŸ’¬ If asked (Y/n), type y and press Enter.
python3.11 -m venv venv
source venv/bin/activate
⚠️ Keep this terminal window open!

4. Install Modules:

⏳ Large Download (~1GB). Please wait:
pip install -r requirements.txt
5. Allosaurus Fix:
Copy the pretrained folder (from main package) to:
venv/lib/python3.11/site-packages/allosaurus/

6. Run Program:

python3 liptalk_converter_2026.py
7. Future Starts:
Run this command once in the active terminal to enable double-click:
chmod +x START_AUDIOCONVERTER.command

Option A (Double-Click):
Just double-click START_AUDIOCONVERTER.command

Option B (Manual): In Terminal, type:

source venv/bin/activate
python3 liptalk_converter_2026.py