subtitle-generator 2.0.0__tar.gz → 2.0.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/CONTRIBUTING.md +1 -1
- subtitle_generator-2.0.2/PKG-INFO +149 -0
- subtitle_generator-2.0.2/PYPI_README.md +104 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/README.md +27 -10
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/pyproject.toml +2 -2
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/__init__.py +1 -1
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/subtitle_generator.egg-info/SOURCES.txt +1 -0
- subtitle_generator-2.0.0/PKG-INFO +0 -161
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/LICENSE +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/MANIFEST.in +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/config/default.yaml +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/API.md +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/PACKAGING.md +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/TROUBLESHOOTING.md +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/example.md +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/environment.yml +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/requirements.txt +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/setup.cfg +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/setup.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/cli/__init__.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/cli/commands.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/__init__.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/config_loader.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/settings.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/__init__.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/async_processor.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/batch_processor.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/subtitle_gen.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/transcriber.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/video_processor.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/models/__init__.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/models/model_manager.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/__init__.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/downloader.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/exceptions.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/file_handler.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/formatters.py +0 -0
- {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/validators.py +0 -0
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: subtitle-generator
|
|
3
|
+
Version: 2.0.2
|
|
4
|
+
Summary: Open-source subtitle generation for seamless content translation.
|
|
5
|
+
Author-email: Ved Gupta <vedgupta@protonmail.com>
|
|
6
|
+
Maintainer-email: Ved Gupta <vedgupta@protonmail.com>
|
|
7
|
+
License: MIT
|
|
8
|
+
Project-URL: Homepage, https://github.com/innovatorved/subtitle
|
|
9
|
+
Project-URL: Documentation, https://github.com/innovatorved/subtitle#readme
|
|
10
|
+
Project-URL: Repository, https://github.com/innovatorved/subtitle.git
|
|
11
|
+
Project-URL: Issues, https://github.com/innovatorved/subtitle/issues
|
|
12
|
+
Project-URL: Changelog, https://github.com/innovatorved/subtitle/releases
|
|
13
|
+
Keywords: subtitle,transcription,whisper,ai,speech-to-text,video,audio,srt,vtt,innovatorved
|
|
14
|
+
Classifier: Development Status :: 4 - Beta
|
|
15
|
+
Classifier: Intended Audience :: Developers
|
|
16
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
17
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
18
|
+
Classifier: Operating System :: OS Independent
|
|
19
|
+
Classifier: Programming Language :: Python :: 3
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
+
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
|
|
25
|
+
Classifier: Topic :: Multimedia :: Video
|
|
26
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
27
|
+
Requires-Python: >=3.9
|
|
28
|
+
Description-Content-Type: text/markdown
|
|
29
|
+
License-File: LICENSE
|
|
30
|
+
Requires-Dist: ffmpeg-python>=0.2.0
|
|
31
|
+
Requires-Dist: tqdm>=4.66.0
|
|
32
|
+
Requires-Dist: pyyaml>=6.0.0
|
|
33
|
+
Requires-Dist: gdown>=4.7.0
|
|
34
|
+
Provides-Extra: dev
|
|
35
|
+
Requires-Dist: pytest>=7.0.0; extra == "dev"
|
|
36
|
+
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
37
|
+
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
38
|
+
Requires-Dist: black>=23.0.0; extra == "dev"
|
|
39
|
+
Requires-Dist: isort>=5.0.0; extra == "dev"
|
|
40
|
+
Requires-Dist: mypy>=1.0.0; extra == "dev"
|
|
41
|
+
Requires-Dist: flake8>=6.0.0; extra == "dev"
|
|
42
|
+
Requires-Dist: build>=1.0.0; extra == "dev"
|
|
43
|
+
Requires-Dist: twine>=4.0.0; extra == "dev"
|
|
44
|
+
Dynamic: license-file
|
|
45
|
+
|
|
46
|
+
# Subtitle Generator
|
|
47
|
+
|
|
48
|
+
> AI-powered subtitle generation using Whisper for accurate speech-to-text transcription.
|
|
49
|
+
|
|
50
|
+
[](https://pypi.org/project/subtitle-generator/)
|
|
51
|
+
[](https://opensource.org/licenses/MIT)
|
|
52
|
+
[](https://www.python.org/downloads/)
|
|
53
|
+
|
|
54
|
+
## Features
|
|
55
|
+
|
|
56
|
+
- 🎯 **Multi-format output** - VTT, SRT, TXT, JSON, LRC, ASS, TTML
|
|
57
|
+
- 🚀 **Fast processing** - Powered by whisper.cpp for high-performance inference
|
|
58
|
+
- 📦 **Batch processing** - Process multiple videos at once
|
|
59
|
+
- 🔄 **Video embedding** - Embed subtitles directly into videos
|
|
60
|
+
- 🌍 **Multilingual** - Support for multiple languages
|
|
61
|
+
|
|
62
|
+
## Installation
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
pip install subtitle-generator
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Prerequisites
|
|
69
|
+
|
|
70
|
+
- **FFmpeg** is required for video/audio processing:
|
|
71
|
+
```bash
|
|
72
|
+
# macOS
|
|
73
|
+
brew install ffmpeg
|
|
74
|
+
|
|
75
|
+
# Ubuntu/Debian
|
|
76
|
+
sudo apt install ffmpeg
|
|
77
|
+
|
|
78
|
+
# Windows (via chocolatey)
|
|
79
|
+
choco install ffmpeg
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Quick Start
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
# Generate subtitles (VTT format)
|
|
86
|
+
subtitle video.mp4
|
|
87
|
+
|
|
88
|
+
# Generate SRT format
|
|
89
|
+
subtitle video.mp4 --format srt
|
|
90
|
+
|
|
91
|
+
# Embed subtitles into video
|
|
92
|
+
subtitle video.mp4 --merge
|
|
93
|
+
|
|
94
|
+
# Use a larger model for better accuracy
|
|
95
|
+
subtitle video.mp4 --model large
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## CLI Commands
|
|
99
|
+
|
|
100
|
+
| Command | Description |
|
|
101
|
+
|---------|-------------|
|
|
102
|
+
| `subtitle <video>` | Generate subtitles for a video |
|
|
103
|
+
| `subtitle models --list` | List available Whisper models |
|
|
104
|
+
| `subtitle models --download <model>` | Download a specific model |
|
|
105
|
+
| `subtitle batch --input-dir <dir>` | Batch process multiple videos |
|
|
106
|
+
| `subtitle formats` | Show supported output formats |
|
|
107
|
+
|
|
108
|
+
## Options
|
|
109
|
+
|
|
110
|
+
| Option | Description |
|
|
111
|
+
|--------|-------------|
|
|
112
|
+
| `--model`, `-m` | Model to use: tiny, base, small, medium, large |
|
|
113
|
+
| `--format`, `-f` | Output format: vtt, srt, txt, json, lrc, ass, ttml |
|
|
114
|
+
| `--merge` | Embed subtitles into the video file |
|
|
115
|
+
| `--threads`, `-t` | Number of processing threads |
|
|
116
|
+
| `--verbose`, `-v` | Enable verbose output |
|
|
117
|
+
|
|
118
|
+
## Python API
|
|
119
|
+
|
|
120
|
+
```python
|
|
121
|
+
from src.core.subtitle_gen import SubtitleGenerator
|
|
122
|
+
|
|
123
|
+
# Generate subtitles
|
|
124
|
+
generator = SubtitleGenerator()
|
|
125
|
+
result = generator.generate("video.mp4", format="srt")
|
|
126
|
+
print(f"Subtitles saved to: {result}")
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Models
|
|
130
|
+
|
|
131
|
+
| Model | Size | Speed | Accuracy |
|
|
132
|
+
|-------|------|-------|----------|
|
|
133
|
+
| `tiny` | ~75MB | ⚡⚡⚡⚡ | ⭐⭐ |
|
|
134
|
+
| `base` | ~140MB | ⚡⚡⚡ | ⭐⭐⭐ |
|
|
135
|
+
| `small` | ~460MB | ⚡⚡ | ⭐⭐⭐⭐ |
|
|
136
|
+
| `medium` | ~1.5GB | ⚡ | ⭐⭐⭐⭐⭐ |
|
|
137
|
+
| `large` | ~3GB | 🐢 | ⭐⭐⭐⭐⭐ |
|
|
138
|
+
|
|
139
|
+
> **Tip:** Use `.en` models (e.g., `base.en`) for English-only content for faster processing.
|
|
140
|
+
|
|
141
|
+
## Links
|
|
142
|
+
|
|
143
|
+
- 📖 [Documentation](https://github.com/innovatorved/subtitle#readme)
|
|
144
|
+
- 🐛 [Issue Tracker](https://github.com/innovatorved/subtitle/issues)
|
|
145
|
+
- 📦 [Source Code](https://github.com/innovatorved/subtitle)
|
|
146
|
+
|
|
147
|
+
## License
|
|
148
|
+
|
|
149
|
+
MIT License - see [LICENSE](https://github.com/innovatorved/subtitle/blob/master/LICENSE) for details.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Subtitle Generator
|
|
2
|
+
|
|
3
|
+
> AI-powered subtitle generation using Whisper for accurate speech-to-text transcription.
|
|
4
|
+
|
|
5
|
+
[](https://pypi.org/project/subtitle-generator/)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://www.python.org/downloads/)
|
|
8
|
+
|
|
9
|
+
## Features
|
|
10
|
+
|
|
11
|
+
- 🎯 **Multi-format output** - VTT, SRT, TXT, JSON, LRC, ASS, TTML
|
|
12
|
+
- 🚀 **Fast processing** - Powered by whisper.cpp for high-performance inference
|
|
13
|
+
- 📦 **Batch processing** - Process multiple videos at once
|
|
14
|
+
- 🔄 **Video embedding** - Embed subtitles directly into videos
|
|
15
|
+
- 🌍 **Multilingual** - Support for multiple languages
|
|
16
|
+
|
|
17
|
+
## Installation
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
pip install subtitle-generator
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### Prerequisites
|
|
24
|
+
|
|
25
|
+
- **FFmpeg** is required for video/audio processing:
|
|
26
|
+
```bash
|
|
27
|
+
# macOS
|
|
28
|
+
brew install ffmpeg
|
|
29
|
+
|
|
30
|
+
# Ubuntu/Debian
|
|
31
|
+
sudo apt install ffmpeg
|
|
32
|
+
|
|
33
|
+
# Windows (via chocolatey)
|
|
34
|
+
choco install ffmpeg
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Quick Start
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
# Generate subtitles (VTT format)
|
|
41
|
+
subtitle video.mp4
|
|
42
|
+
|
|
43
|
+
# Generate SRT format
|
|
44
|
+
subtitle video.mp4 --format srt
|
|
45
|
+
|
|
46
|
+
# Embed subtitles into video
|
|
47
|
+
subtitle video.mp4 --merge
|
|
48
|
+
|
|
49
|
+
# Use a larger model for better accuracy
|
|
50
|
+
subtitle video.mp4 --model large
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## CLI Commands
|
|
54
|
+
|
|
55
|
+
| Command | Description |
|
|
56
|
+
|---------|-------------|
|
|
57
|
+
| `subtitle <video>` | Generate subtitles for a video |
|
|
58
|
+
| `subtitle models --list` | List available Whisper models |
|
|
59
|
+
| `subtitle models --download <model>` | Download a specific model |
|
|
60
|
+
| `subtitle batch --input-dir <dir>` | Batch process multiple videos |
|
|
61
|
+
| `subtitle formats` | Show supported output formats |
|
|
62
|
+
|
|
63
|
+
## Options
|
|
64
|
+
|
|
65
|
+
| Option | Description |
|
|
66
|
+
|--------|-------------|
|
|
67
|
+
| `--model`, `-m` | Model to use: tiny, base, small, medium, large |
|
|
68
|
+
| `--format`, `-f` | Output format: vtt, srt, txt, json, lrc, ass, ttml |
|
|
69
|
+
| `--merge` | Embed subtitles into the video file |
|
|
70
|
+
| `--threads`, `-t` | Number of processing threads |
|
|
71
|
+
| `--verbose`, `-v` | Enable verbose output |
|
|
72
|
+
|
|
73
|
+
## Python API
|
|
74
|
+
|
|
75
|
+
```python
|
|
76
|
+
from src.core.subtitle_gen import SubtitleGenerator
|
|
77
|
+
|
|
78
|
+
# Generate subtitles
|
|
79
|
+
generator = SubtitleGenerator()
|
|
80
|
+
result = generator.generate("video.mp4", format="srt")
|
|
81
|
+
print(f"Subtitles saved to: {result}")
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Models
|
|
85
|
+
|
|
86
|
+
| Model | Size | Speed | Accuracy |
|
|
87
|
+
|-------|------|-------|----------|
|
|
88
|
+
| `tiny` | ~75MB | ⚡⚡⚡⚡ | ⭐⭐ |
|
|
89
|
+
| `base` | ~140MB | ⚡⚡⚡ | ⭐⭐⭐ |
|
|
90
|
+
| `small` | ~460MB | ⚡⚡ | ⭐⭐⭐⭐ |
|
|
91
|
+
| `medium` | ~1.5GB | ⚡ | ⭐⭐⭐⭐⭐ |
|
|
92
|
+
| `large` | ~3GB | 🐢 | ⭐⭐⭐⭐⭐ |
|
|
93
|
+
|
|
94
|
+
> **Tip:** Use `.en` models (e.g., `base.en`) for English-only content for faster processing.
|
|
95
|
+
|
|
96
|
+
## Links
|
|
97
|
+
|
|
98
|
+
- 📖 [Documentation](https://github.com/innovatorved/subtitle#readme)
|
|
99
|
+
- 🐛 [Issue Tracker](https://github.com/innovatorved/subtitle/issues)
|
|
100
|
+
- 📦 [Source Code](https://github.com/innovatorved/subtitle)
|
|
101
|
+
|
|
102
|
+
## License
|
|
103
|
+
|
|
104
|
+
MIT License - see [LICENSE](https://github.com/innovatorved/subtitle/blob/master/LICENSE) for details.
|
|
@@ -1,25 +1,42 @@
|
|
|
1
|
-
# Subtitle
|
|
1
|
+
# Subtitle Generator
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://pypi.org/project/subtitle-generator/)
|
|
4
|
+
[](https://www.python.org/downloads/)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://pepy.tech/project/subtitle-generator)
|
|
7
|
+
|
|
8
|
+
> AI-powered subtitle generation using Whisper for accurate speech-to-text transcription.
|
|
4
9
|
|
|
5
10
|
**Key Features:**
|
|
6
11
|
|
|
7
|
-
- **
|
|
8
|
-
- **
|
|
9
|
-
- **
|
|
10
|
-
- **
|
|
11
|
-
- **
|
|
12
|
+
- 🎯 **Multi-format output** - VTT, SRT, TXT, JSON, LRC, ASS, TTML
|
|
13
|
+
- 🚀 **Fast processing** - Powered by whisper.cpp for high-performance inference
|
|
14
|
+
- 📦 **Batch processing** - Process multiple videos at once
|
|
15
|
+
- 🔄 **Video embedding** - Embed subtitles directly into videos
|
|
16
|
+
- 🌍 **Multilingual** - Support for multiple languages
|
|
17
|
+
- 🔓 **Open-source** - Freely available for use, modification, and distribution
|
|
12
18
|
|
|
13
19
|
## Installation
|
|
14
20
|
|
|
15
|
-
###
|
|
21
|
+
### Quick Install (PyPI)
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
pip install subtitle-generator
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
> **Note:** FFmpeg is required. Install via: `brew install ffmpeg` (macOS) or `sudo apt install ffmpeg` (Ubuntu)
|
|
28
|
+
|
|
29
|
+
### Development Setup
|
|
30
|
+
|
|
31
|
+
For contributors or if you need to build whisper.cpp from source:
|
|
32
|
+
|
|
33
|
+
#### Prerequisites
|
|
16
34
|
|
|
17
|
-
Ensure you have the following installed:
|
|
18
35
|
- `git`, `make`, `cmake`
|
|
19
36
|
- `ffmpeg` (Required for video processing)
|
|
20
37
|
- `conda` (Anaconda or Miniconda)
|
|
21
38
|
|
|
22
|
-
|
|
39
|
+
#### Setup
|
|
23
40
|
|
|
24
41
|
1. **Clone and setup Whisper.cpp:**
|
|
25
42
|
```bash
|
|
@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "subtitle-generator"
|
|
7
|
-
version = "2.0.
|
|
7
|
+
version = "2.0.2"
|
|
8
8
|
description = "Open-source subtitle generation for seamless content translation."
|
|
9
|
-
readme = "
|
|
9
|
+
readme = "PYPI_README.md"
|
|
10
10
|
license = {text = "MIT"}
|
|
11
11
|
authors = [
|
|
12
12
|
{name = "Ved Gupta", email = "vedgupta@protonmail.com"}
|
|
@@ -1,161 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: subtitle-generator
|
|
3
|
-
Version: 2.0.0
|
|
4
|
-
Summary: Open-source subtitle generation for seamless content translation.
|
|
5
|
-
Author-email: Ved Gupta <vedgupta@protonmail.com>
|
|
6
|
-
Maintainer-email: Ved Gupta <vedgupta@protonmail.com>
|
|
7
|
-
License: MIT
|
|
8
|
-
Project-URL: Homepage, https://github.com/innovatorved/subtitle
|
|
9
|
-
Project-URL: Documentation, https://github.com/innovatorved/subtitle#readme
|
|
10
|
-
Project-URL: Repository, https://github.com/innovatorved/subtitle.git
|
|
11
|
-
Project-URL: Issues, https://github.com/innovatorved/subtitle/issues
|
|
12
|
-
Project-URL: Changelog, https://github.com/innovatorved/subtitle/releases
|
|
13
|
-
Keywords: subtitle,transcription,whisper,ai,speech-to-text,video,audio,srt,vtt,innovatorved
|
|
14
|
-
Classifier: Development Status :: 4 - Beta
|
|
15
|
-
Classifier: Intended Audience :: Developers
|
|
16
|
-
Classifier: Intended Audience :: End Users/Desktop
|
|
17
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
18
|
-
Classifier: Operating System :: OS Independent
|
|
19
|
-
Classifier: Programming Language :: Python :: 3
|
|
20
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
21
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
22
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
-
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
|
|
25
|
-
Classifier: Topic :: Multimedia :: Video
|
|
26
|
-
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
27
|
-
Requires-Python: >=3.9
|
|
28
|
-
Description-Content-Type: text/markdown
|
|
29
|
-
License-File: LICENSE
|
|
30
|
-
Requires-Dist: ffmpeg-python>=0.2.0
|
|
31
|
-
Requires-Dist: tqdm>=4.66.0
|
|
32
|
-
Requires-Dist: pyyaml>=6.0.0
|
|
33
|
-
Requires-Dist: gdown>=4.7.0
|
|
34
|
-
Provides-Extra: dev
|
|
35
|
-
Requires-Dist: pytest>=7.0.0; extra == "dev"
|
|
36
|
-
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
37
|
-
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
38
|
-
Requires-Dist: black>=23.0.0; extra == "dev"
|
|
39
|
-
Requires-Dist: isort>=5.0.0; extra == "dev"
|
|
40
|
-
Requires-Dist: mypy>=1.0.0; extra == "dev"
|
|
41
|
-
Requires-Dist: flake8>=6.0.0; extra == "dev"
|
|
42
|
-
Requires-Dist: build>=1.0.0; extra == "dev"
|
|
43
|
-
Requires-Dist: twine>=4.0.0; extra == "dev"
|
|
44
|
-
Dynamic: license-file
|
|
45
|
-
|
|
46
|
-
# Subtitle
|
|
47
|
-
|
|
48
|
-
Open-source subtitle generation for seamless content translation.
|
|
49
|
-
|
|
50
|
-
**Key Features:**
|
|
51
|
-
|
|
52
|
-
- **Open-source** - Freely available for use, modification, and distribution
|
|
53
|
-
- **Self-hosted** - Run on your own servers for enhanced control and privacy
|
|
54
|
-
- **AI-powered** - Leverage Whisper for accurate, natural-sounding subtitles
|
|
55
|
-
- **Multilingual** - Generate subtitles in a wide range of languages
|
|
56
|
-
- **Fast** - Uses whisper.cpp for high-performance inference
|
|
57
|
-
|
|
58
|
-
## Installation
|
|
59
|
-
|
|
60
|
-
### Prerequisites
|
|
61
|
-
|
|
62
|
-
Ensure you have the following installed:
|
|
63
|
-
- `git`, `make`, `cmake`
|
|
64
|
-
- `ffmpeg` (Required for video processing)
|
|
65
|
-
- `conda` (Anaconda or Miniconda)
|
|
66
|
-
|
|
67
|
-
### Setup
|
|
68
|
-
|
|
69
|
-
1. **Clone and setup Whisper.cpp:**
|
|
70
|
-
```bash
|
|
71
|
-
./setup_whisper.sh
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
2. **Create and activate conda environment:**
|
|
75
|
-
```bash
|
|
76
|
-
conda env create -f environment.yml
|
|
77
|
-
conda activate subtitle
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
## Usage
|
|
81
|
-
|
|
82
|
-
### Generate Subtitles
|
|
83
|
-
|
|
84
|
-
```bash
|
|
85
|
-
# Basic usage (generates VTT subtitle file)
|
|
86
|
-
python subtitle.py video.mp4
|
|
87
|
-
|
|
88
|
-
# Generate and embed subtitles into video
|
|
89
|
-
python subtitle.py video.mp4 --merge
|
|
90
|
-
|
|
91
|
-
# Use a specific model
|
|
92
|
-
python subtitle.py video.mp4 --model base
|
|
93
|
-
|
|
94
|
-
# Generate SRT format
|
|
95
|
-
python subtitle.py video.mp4 --format srt
|
|
96
|
-
|
|
97
|
-
# From URL
|
|
98
|
-
python subtitle.py "https://example.com/video.mp4"
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
### Model Management
|
|
102
|
-
|
|
103
|
-
```bash
|
|
104
|
-
# List all available models
|
|
105
|
-
python subtitle.py models --list
|
|
106
|
-
|
|
107
|
-
# Download a specific model
|
|
108
|
-
python subtitle.py models --download large
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### View Supported Formats
|
|
112
|
-
|
|
113
|
-
```bash
|
|
114
|
-
python subtitle.py formats
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
### Options
|
|
118
|
-
|
|
119
|
-
| Option | Description |
|
|
120
|
-
|--------|-------------|
|
|
121
|
-
| `--model`, `-m` | Model to use (default: base) |
|
|
122
|
-
| `--format`, `-f` | Output format: vtt, srt, txt, json, lrc (default: vtt) |
|
|
123
|
-
| `--merge` | Embed subtitles into video |
|
|
124
|
-
| `--threads`, `-t` | Number of threads (default: 4) |
|
|
125
|
-
| `--verbose`, `-v` | Verbose output |
|
|
126
|
-
|
|
127
|
-
### Available Models
|
|
128
|
-
|
|
129
|
-
| Model | Size | Speed | Best For |
|
|
130
|
-
|-------|------|-------|----------|
|
|
131
|
-
| `tiny` | ~75MB | Fastest | Quick previews |
|
|
132
|
-
| `base` | ~140MB | Fast | General use (default) |
|
|
133
|
-
| `small` | ~460MB | Medium | Quality output |
|
|
134
|
-
| `medium` | ~1.5GB | Slow | Professional work |
|
|
135
|
-
| `large` | ~3GB | Slowest | Maximum accuracy |
|
|
136
|
-
|
|
137
|
-
> **Tip:** Use `.en` models (e.g., `base.en`) for English-only content.
|
|
138
|
-
|
|
139
|
-
## Documentation
|
|
140
|
-
|
|
141
|
-
- [Usage Examples](docs/example.md) - CLI and Python API examples
|
|
142
|
-
- [API Reference](docs/API.md) - Programmatic API documentation
|
|
143
|
-
- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
|
|
144
|
-
- [Contributing](CONTRIBUTING.md) - Contribution guidelines
|
|
145
|
-
|
|
146
|
-
## License
|
|
147
|
-
|
|
148
|
-
[MIT](https://choosealicense.com/licenses/mit/)
|
|
149
|
-
|
|
150
|
-
## Reference & Credits
|
|
151
|
-
|
|
152
|
-
- [OpenAI Whisper](https://github.com/openai/whisper)
|
|
153
|
-
- [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
|
|
154
|
-
|
|
155
|
-
## Author
|
|
156
|
-
|
|
157
|
-
- [Ved Gupta](https://www.github.com/innovatorved)
|
|
158
|
-
|
|
159
|
-
## Support
|
|
160
|
-
|
|
161
|
-
For support, email vedgupta@protonmail.com
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|