Build from Source

Set up dependencies and package Roneat Studio Pro from source on Windows.

Run or package Roneat Studio Pro from source on Windows.

Use this guide when you need a local developer setup or a distributable build.

The project depends on audio, scientific, and video libraries. Environment setup matters.

Scope

This guide covers:

• local dependency setup

• video export requirements

• packaging notes

• common environment issues

This workflow targets Windows.

Prerequisites

Before you begin, make sure you have:

• Python 3.10 or later

• a local clone of the repository

• terminal access to the project root

Install dependencies

From the project root, install the required packages:

pip install -r requirements.txt

If you want a cleaner local setup, create a virtual environment first.

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

Core dependencies include:

• customtkinter for the interface

• librosa, numpy, and scipy for audio analysis

• sounddevice and soundfile for playback

• reportlab for PDF export

• imageio-ffmpeg for video export

Add FFmpeg for video export

MP4 export requires ffmpeg.exe.

Place ffmpeg.exe directly in the main project folder before you run or package the app.

If ffmpeg.exe is missing, video export will not work in the built application.

PDF export can still work when MP4 export fails. That usually means ffmpeg.exe is missing or not copied to the right location.

Packaging notes

If you build a standalone version, also copy ffmpeg.exe into the final dist/ output.

Without that file, exported videos cannot be encoded correctly.

For a fuller release workflow, see Packaging and Distribution.

Common setup issues

Dependency mismatch

If the app fails to start after install:

1. verify your Python version

2. reinstall dependencies from requirements.txt

3. retry from a clean virtual environment if needed

Missing video export support

If PDF export works but MP4 export does not, confirm that ffmpeg.exe exists in both locations:

• the project root during development

• the final distribution folder after packaging

Quick checklist

• Python version is 3.10+

• dependencies installed from requirements.txt

• ffmpeg.exe present in the project root

• ffmpeg.exe copied into dist/ for packaged builds

Once these are in place, the source build environment is ready.

First smoke test

After setup, verify these basics before you start coding:

• the app launches

• the editor opens

• audio playback works

• PDF export works

• MP4 export works when ffmpeg.exe is present