Добавить финальные титры
Показывает текст в конце ролика с плавным появлением и исчезновением.
Что делает скрипт
Скрипт вычисляет начало титров от длительности видео, пишет текст во временный файл и применяет drawtext с плавной прозрачностью. Шрифт можно указать явно или оставить поиск по стандартным путям. Исходное видео не перезаписывается.
- Нужна сборка FFmpeg с фильтром drawtext и доступный TTF-шрифт.
Быстрый старт
python end_credits.py clip.mp4 --text "Спасибо за просмотр"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python end_credits.py clip.mp4 --text "Спасибо за просмотр"python end_credits.py film.mkv --text "Автор: demo" --duration 12python end_credits.py demo.mov --text "Конец" --font-size 56 --output final.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
end_credits.py
#!/usr/bin/env python3
"""Финальные титры поверх последних секунд видео."""
from __future__ import annotations
import argparse
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("--duration", type=float, default=8.0)
parser.add_argument("--font-size", type=int, default=42)
parser.add_argument("--font", help="Путь к TTF или OTF")
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)
credits = max(0.5, min(args.duration, total))
start = max(0.0, total - credits)
end = total
fade = max(0.1, min(1.0, credits / 4))
target = args.output.expanduser() if args.output else Path("credits") / f"{source.stem}_credits.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)
alpha = (
f"if(lt(t,{start:.3f}),0,"
f"if(lt(t,{start + fade:.3f}),(t-{start:.3f})/{fade:.3f},"
f"if(lt(t,{end - fade:.3f}),1,"
f"if(lt(t,{end:.3f}),({end:.3f}-t)/{fade:.3f},0))))"
)
with tempfile.TemporaryDirectory(prefix="credits_") as temp_dir:
text_file = Path(temp_dir) / "credits.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}:line_spacing=14:"
"shadowcolor=black@0.7:shadowx=2:shadowy=2:"
f"x=(w-text_w)/2:y=(h-text_h)/2:alpha='{alpha}'"
)
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} - {end:.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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.