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.
Files changed (38) hide show
  1. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/CONTRIBUTING.md +1 -1
  2. subtitle_generator-2.0.2/PKG-INFO +149 -0
  3. subtitle_generator-2.0.2/PYPI_README.md +104 -0
  4. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/README.md +27 -10
  5. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/pyproject.toml +2 -2
  6. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/__init__.py +1 -1
  7. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/subtitle_generator.egg-info/SOURCES.txt +1 -0
  8. subtitle_generator-2.0.0/PKG-INFO +0 -161
  9. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/LICENSE +0 -0
  10. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/MANIFEST.in +0 -0
  11. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/config/default.yaml +0 -0
  12. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/API.md +0 -0
  13. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/PACKAGING.md +0 -0
  14. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/TROUBLESHOOTING.md +0 -0
  15. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/docs/example.md +0 -0
  16. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/environment.yml +0 -0
  17. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/requirements.txt +0 -0
  18. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/setup.cfg +0 -0
  19. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/setup.py +0 -0
  20. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/cli/__init__.py +0 -0
  21. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/cli/commands.py +0 -0
  22. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/__init__.py +0 -0
  23. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/config_loader.py +0 -0
  24. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/config/settings.py +0 -0
  25. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/__init__.py +0 -0
  26. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/async_processor.py +0 -0
  27. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/batch_processor.py +0 -0
  28. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/subtitle_gen.py +0 -0
  29. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/transcriber.py +0 -0
  30. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/core/video_processor.py +0 -0
  31. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/models/__init__.py +0 -0
  32. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/models/model_manager.py +0 -0
  33. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/__init__.py +0 -0
  34. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/downloader.py +0 -0
  35. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/exceptions.py +0 -0
  36. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/file_handler.py +0 -0
  37. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/formatters.py +0 -0
  38. {subtitle_generator-2.0.0 → subtitle_generator-2.0.2}/src/utils/validators.py +0 -0
@@ -77,7 +77,7 @@ tests/
77
77
  ## Pull Request Process
78
78
 
79
79
  1. **Fork** the repository
80
- 2. **Create a branch** from `main`:
80
+ 2. **Create a branch** from `master`:
81
81
  ```bash
82
82
  git checkout -b feature/your-feature-name
83
83
  ```
@@ -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
+ [![PyPI version](https://badge.fury.io/py/subtitle-generator.svg)](https://pypi.org/project/subtitle-generator/)
51
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
52
+ [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](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
+ [![PyPI version](https://badge.fury.io/py/subtitle-generator.svg)](https://pypi.org/project/subtitle-generator/)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+ [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](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
- Open-source subtitle generation for seamless content translation.
3
+ [![PyPI version](https://badge.fury.io/py/subtitle-generator.svg)](https://pypi.org/project/subtitle-generator/)
4
+ [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+ [![Downloads](https://static.pepy.tech/badge/subtitle-generator)](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
- - **Open-source** - Freely available for use, modification, and distribution
8
- - **Self-hosted** - Run on your own servers for enhanced control and privacy
9
- - **AI-powered** - Leverage Whisper for accurate, natural-sounding subtitles
10
- - **Multilingual** - Generate subtitles in a wide range of languages
11
- - **Fast** - Uses whisper.cpp for high-performance inference
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
- ### Prerequisites
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
- ### Setup
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.0"
7
+ version = "2.0.2"
8
8
  description = "Open-source subtitle generation for seamless content translation."
9
- readme = "README.md"
9
+ readme = "PYPI_README.md"
10
10
  license = {text = "MIT"}
11
11
  authors = [
12
12
  {name = "Ved Gupta", email = "vedgupta@protonmail.com"}
@@ -5,4 +5,4 @@ A clean, modular subtitle generation system using Whisper.cpp
5
5
  with proper separation of concerns and design patterns.
6
6
  """
7
7
 
8
- __version__ = "2.0.0"
8
+ __version__ = "2.0.2"
@@ -1,6 +1,7 @@
1
1
  CONTRIBUTING.md
2
2
  LICENSE
3
3
  MANIFEST.in
4
+ PYPI_README.md
4
5
  README.md
5
6
  environment.yml
6
7
  pyproject.toml
@@ -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