Медиатека

Сдвинуть время субтитров в медиатеке

Добавляет или вычитает секунды у всех реплик и сохраняет результат в новый файл.

Python Windows macOS Linux Новичок
Скачать subtitle_shift.py
Описание

Что делает скрипт

Скрипт использует pysubs2, применяет сдвиг к каждому событию и предупреждает, если после правки появляются отрицательные таймкоды. По умолчанию пишется отдельный файл shifted, исходник не меняется. Для записи поверх нужен явный флаг --in-place и --force.

Перед запуском
  • Сдвиг в минус может сделать начало субтитров отрицательным. Проверьте предупреждения.
Запуск

Быстрый старт

python subtitle_shift.py --input movie.srt --seconds 2.5

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python subtitle_shift.py --input movie.srt --seconds 1.5
  • python subtitle_shift.py --input movie.srt --seconds -2.0 --output fixed.srt
  • python subtitle_shift.py --input movie.srt --seconds 0.8 --in-place --force
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
pysubs2 Разбор и запись файлов субтитров
Windows py -m pip install pysubs2
macOS python3 -m pip install pysubs2
Linux python3 -m pip install pysubs2
Исходник

subtitle_shift.py

#!/usr/bin/env python3
"""Сдвигает все события субтитров на заданное число секунд."""
from __future__ import annotations

import argparse
from pathlib import Path

import pysubs2


def main() -> int:
    parser = argparse.ArgumentParser(description="Сдвинуть субтитры")
    parser.add_argument("--input", type=Path, required=True, help="Исходный файл субтитров")
    parser.add_argument("--seconds", type=float, required=True, help="Сдвиг в секундах, можно отрицательный")
    parser.add_argument("--output", type=Path, help="Куда сохранить результат")
    parser.add_argument("--in-place", action="store_true", help="Перезаписать исходный файл")
    parser.add_argument("--force", action="store_true", help="Разрешить перезапись")
    parser.add_argument("--allow-negative", action="store_true", help="Не останавливаться на отрицательных таймкодах")
    args = parser.parse_args()

    source = args.input.expanduser().resolve()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")

    try:
        subs = pysubs2.load(str(source))
    except Exception as error:
        parser.error(f"Не удалось прочитать субтитры: {error}")

    subs.shift(s=args.seconds)
    negative = [event for event in subs if event.start < 0 or event.end < 0]
    if negative and not args.allow_negative:
        print(f"После сдвига отрицательные таймкоды у {len(negative)} событий.")
        print("Уменьшите сдвиг или добавьте --allow-negative.")
        return 2

    if args.in_place:
        target = source
        if not args.force:
            parser.error("Для --in-place нужен --force")
    else:
        target = args.output.expanduser() if args.output else source.with_name(f"{source.stem}.shifted{source.suffix}")
        if target.exists() and not args.force:
            parser.error(f"Файл уже существует: {target}. Добавьте --force.")

    subs.save(str(target))
    print(f"Сохранено: {target} (сдвиг {args.seconds:+.3f} s)")
    if args.seconds < 0:
        print("Напоминание: отрицательный сдвиг ускоряет появление реплик.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get media-subtitle-shift
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Медиатека

Плейлисты, метаданные, обложки, субтитры и порядок в коллекциях.