Добавить титры в начало видео
Показывает текстовый заголовок в первые секунды ролика через drawtext.
Что делает скрипт
Скрипт пишет текст во временный файл и передаёт его фильтру drawtext, поэтому двоеточия и кавычки не ломают команду. Можно выбрать шрифт, размер, позицию и длительность показа. Видео перекодируется, звук сохраняется в AAC.
- Нужна сборка FFmpeg с фильтром drawtext и доступный TTF-шрифт.
Быстрый старт
python add_titles.py clip.mp4 --text "Название проекта"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python add_titles.py clip.mp4 --text "Название проекта"python add_titles.py demo.mov --text "Глава 1" --position top --duration 4python add_titles.py lesson.mkv --text "Практика" --font-size 64 --output intro.mp4
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
sudo apt install ffmpeg
add_titles.py
#!/usr/bin/env python3
"""Добавление титров в начало видео."""
from __future__ import annotations
import argparse
import json
import shutil
import subprocess
import tempfile
from pathlib import Path
FONT_CANDIDATES = [
Path("C:/Windows/Fonts/arial.ttf"),
Path("C:/Windows/Fonts/segoeui.ttf"),
Path("/System/Library/Fonts/Supplemental/Arial.ttf"),
Path("/Library/Fonts/Arial.ttf"),
Path("/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"),
Path("/usr/share/fonts/TTF/DejaVuSans.ttf"),
]
def duration_of(path: Path) -> float:
result = subprocess.run(
[
"ffprobe", "-v", "error", "-show_entries", "format=duration",
"-of", "default=noprint_wrappers=1:nokey=1", str(path),
],
capture_output=True,
text=True,
check=False,
)
if result.returncode != 0:
raise SystemExit(f"ffprobe не смог прочитать {path}:\n{result.stderr.strip()}")
return float(result.stdout.strip())
def find_font(explicit: str | None) -> Path | None:
if explicit:
path = Path(explicit).expanduser()
if not path.is_file():
raise SystemExit(f"Шрифт не найден: {path}")
return path
for candidate in FONT_CANDIDATES:
if candidate.is_file():
return candidate
return None
def escape_filter_path(path: Path) -> str:
text = str(path).replace("\\", "/")
return text.replace(":", "\\:").replace("'", "\\'")
def main() -> int:
parser = argparse.ArgumentParser(description="Добавить титры в начало видео")
parser.add_argument("input", type=Path)
parser.add_argument("--text", required=True)
parser.add_argument("--output", "-o", type=Path)
parser.add_argument("--start", type=float, default=0.0)
parser.add_argument("--duration", type=float, default=5.0)
parser.add_argument("--font-size", type=int, default=48)
parser.add_argument("--font", help="Путь к TTF или OTF")
parser.add_argument("--position", choices=("top", "center", "bottom"), default="bottom")
parser.add_argument("--overwrite", action="store_true")
args = parser.parse_args()
if shutil.which("ffmpeg") is None:
raise SystemExit("Не найден ffmpeg. Установите FFmpeg.")
source = args.input.expanduser()
if not source.is_file():
parser.error(f"Файл не найден: {source}")
if not args.text.strip():
parser.error("Текст титров не может быть пустым")
total = duration_of(source)
start = max(0.0, args.start)
if start >= total:
parser.error("Начало показа за пределами ролика")
duration = min(args.duration, total - start)
if duration <= 0:
parser.error("Длительность показа должна быть больше нуля")
target = args.output.expanduser() if args.output else Path("titles") / f"{source.stem}_titled.mp4"
if target.resolve() == source.resolve():
raise SystemExit("Результат не должен совпадать с исходником")
if target.exists() and not args.overwrite:
raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")
target.parent.mkdir(parents=True, exist_ok=True)
font = find_font(args.font)
y_positions = {"top": "80", "center": "(h-th)/2", "bottom": "h-th-80"}
with tempfile.TemporaryDirectory(prefix="titles_") as temp_dir:
text_file = Path(temp_dir) / "title.txt"
text_file.write_text(args.text, encoding="utf-8")
drawtext = "drawtext="
if font is not None:
drawtext += f"fontfile='{escape_filter_path(font)}':"
drawtext += (
f"textfile='{escape_filter_path(text_file)}':"
f"fontcolor=white:fontsize={args.font_size}:"
"box=1:boxcolor=black@0.5:boxborderw=18:"
f"x=(w-text_w)/2:y={y_positions[args.position]}:"
f"enable='between(t,{start:.3f},{start + duration:.3f})'"
)
command = [
"ffmpeg", "-hide_banner", "-nostdin", "-i", str(source),
"-vf", drawtext,
"-c:v", "libx264", "-preset", "medium", "-crf", "20",
"-pix_fmt", "yuv420p", "-c:a", "aac", "-b:a", "192k",
"-movflags", "+faststart", "-y" if args.overwrite else "-n", str(target),
]
print(f"Титры: {start:.1f} - {start + duration:.1f} с")
result = subprocess.run(command, check=False)
if result.returncode != 0:
raise SystemExit(f"ffmpeg завершился с кодом {result.returncode}")
print(f"Готово: {target}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.