Audio, voice, and video

This page is part of the GenPy Ren'Py learning path. It focuses on practical Ren'Py 8.x production and links each concept back to the GenPy workflow.

Learning goals

• Use music, sound, and voice channels intentionally.
• Define reusable audio aliases.
• Know when video should be fullscreen or a displayable.

Core syntax

• play music
• play sound
• voice
• queue
• stop
• Movie

Runnable example

define audio.town = "audio/town_theme.ogg"
define audio.woof = "audio/woof.mp3"

label start:
    play music town
    play sound woof

Study outline

• Start with the smallest example for audio, voice, and video.
• Test the key terms in a clean Ren'Py project: play music, play sound, voice, queue.
• Move the pattern back into your real project only after the example runs.
• Use GenPy docs and validation to keep the feature connected to story, assets, and export readiness.

Common pitfalls

• Test the smallest working script before layering on visual or UI complexity.
• Run Ren'Py Lint before release builds, even when the script appears to run locally.
• Keep examples in standard .rpy files so they remain editable outside GenPy.

Official references

• Ren'Py audio reference: https://www.renpy.org/doc/html/audio.html
• Ren'Py official reference: https://www.renpy.org/doc/html/voice.html
• Ren'Py official reference: https://www.renpy.org/doc/html/movie.html

How this fits in GenPy

• Use Assets to organize audio/video files before export.
• Use Performance Editor to connect audio beats to scene timing.

Recommended GenPy docs:

• Performance Editor
• Export and download
• Export and download