Skip to main content

A Python package (+CLI) for voice over subtitles, with the ability to embed in video, audio ducking, and dynamic voice changer for a single track.

Project description

Package for voice over subtitles:

  • with the ability to embed in video,
  • audio ducking,
  • dynamic voice changer for a single track. Add "!: voice name" at the beginning of the subtitle line. (Applies to all subsequent ones)

pip install PyFastDub

python -m FastDub --help

CLI

usage: FastDub [-h] -i INPUT [-vf VIDEO_FORMAT] [-sf SUBTITLES_FORMAT] [-En EXCLUDE [EXCLUDE ...]] [-Eu EXCLUDE_UNDERSCORE]
               [--ducking | --no-ducking] [--min-silence-len MIN_SILENCE_LEN] [--silence-thresh SILENCE_THRESH]
               [--gain-during-overlay GAIN_DURING_OVERLAY]
               [-v {...}]
               [-a ALIGN] [-ll LOGLEVEL] [-y] [-rf CLEANUP_LEVEL] [-rc]

FastDub is a tool for dubbing videos by subtitle files.

options:
  -h, --help            show this help message and exit
  -rc, --remove-cache   Remove all cache files

Input:
  -i INPUT, --input INPUT
                        Input file or directory.
  -vf VIDEO_FORMAT, --video-format VIDEO_FORMAT
                        Video format (default .mp4).
  -sf SUBTITLES_FORMAT, --subtitles-format SUBTITLES_FORMAT
                        Subtitles format (default .srt).

Audio Ducking:
  -dk, --ducking, --no-ducking
                        Enable audio ducking (default: True)
  -dk-msl MIN_SILENCE_LEN, --min-silence-len MIN_SILENCE_LEN
                        Minimum silence length in ms (default 100)
  -dk-st SILENCE_THRESH, --silence-thresh SILENCE_THRESH
                        Silence threshold in dB
  -dk-gdo GAIN_DURING_OVERLAY, --gain-during-overlay GAIN_DURING_OVERLAY
                        Gain during overlay in dB

Voicer:
  -v {microsoft irina desktop - russian,microsoft zira desktop - english (united states),microsoft david desktop - english (united states),yuriy}, 
--voice {microsoft irina desktop - russian,microsoft zira desktop - english (united states),microsoft david desktop - english (united states),yuriy
}
                        Voice
  -a ALIGN, --align ALIGN
                        Audio fit align
                                1 = right
                                2 = center

Output:
  -ll LOGLEVEL, --loglevel LOGLEVEL
                        FFMpegWrapper loglevel
  -y, --yes             Don't ask for confirmation
  -rf CLEANUP_LEVEL, --cleanup-level CLEANUP_LEVEL
                        Cleanup level (0 = No removing any files
                                > 0 remove audio from video (default)
                                > 1 = remove dubbed audio if video exists)
                                > 2 = reomve dubbed cache files

If the voice set after !: is not selected during voiceover, clear the cache with the -rc argument

Example

python -m FastDub -i "DirToDub" -v "Yuriy" --no-ducking --min-silence-len 200

name = "Any name"

DirToDub:

  • name.srt
  • name.mp4
  • name2.srt
  • name2.mp4

Then: name and name2 will be announced, and the results will be saved to a folder with the appropriate name.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

PyFastDub-2.0.2-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file PyFastDub-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: PyFastDub-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.10.4

File hashes

Hashes for PyFastDub-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bfe3cde0341eba734c870497c4f9922b40367dc93d813ea355579c5aa0d5aacc
MD5 c15dd38845387a530f455f2781b5f732
BLAKE2b-256 4136ece78847d5835229d1f281f7511ce448238d6de7903a88787c254cb1950f

See more details on using hashes here.

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