Metadata-Version: 2.1
Name: txt2dub
Version: 0.1.0
Summary: A terminal UI application for editing voiceover scripts and generating text to speech performances.
License: MIT
Author: Mike Kibbel
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: pyttsx3 (>=2.90,<3.0)
Requires-Dist: textual (>=0.24.1,<0.25.0)
Description-Content-Type: text/markdown

txt2dub
=======

Write and edit voiceover scripts and generate text-to-speech performances in a text-based user interface.

## What is `txt2dub` for?

`txt2dub` is a video content creation tool for writing scripts and generating overdub performances as MP3 files that can be imported into your video editing software. This supports a workflow for arranging video assets on your timeline based on the voice performance's timing. You can record your own voiceovers to replace the robotic text-to-speech performance, or you can keep the placeholders if that's the style you're targeting.

## Who is `txt2dub` for?

`txt2dub` is designed to be easily installable on the major desktop platforms (Windows, Mac and Linux) without programming skills. More detailed installation instructions will be posted soon. For those familiar with Python, you can install `txt2dub` in a virtual environment or globally with:

```bash
pip install txt2dub
```

It can be run from its installed script:

```
txt2dub
```

or from its Python module:

```
python -m txt2dub
```

## Why isn't `txt2dub` an app or web-based service?

`txt2dub` aims to unlock access to the text-to-speech services provided by your operating system, all wrapped in a simple application that tries to improve the workflow for voiceover script writing. It is built on top of the [Textual](https://textual.textualize.io/) rapid application development framework for text-based UIs. This makes it easy to install and run in [any supported terminal](https://textual.textualize.io/getting_started/#requirements) with Python 3.7 or later.

This project doesn't require a subscription, a new account or payment. It's entirely open source, free to use, and it doesn't share your data or the content you create using it with anyone.

## Is `txt2dub` ready for production use?

It has been used successfully for production work by the project's author in Windows 10. Testing on Mac will proceed in the near future. Linux testing will be community-driven. Please report issues with details about your OS (Windows, Mac, Linux + version) and Python environment (version) if you encounter bugs.

