3 мин на чтение

Почему рабочий Python-скрипт ломается после сборки в приложение

Два сбоя «Качалки» показывают, почему готовый дистрибутив и совместимость MP4 нужно проверять отдельно от исходного кода.

Программа для скачивания видео выглядит простой: вставить ссылку, выбрать качество, получить файл. Но между работающим скриптом и приложением, которое можно отправить другому человеку, появляется отдельный слой проблем. «Качалка» разработчика Валерия Барабанова столкнулась сразу с двумя: собранная версия не получала видео из TikTok, а уже скачанный MP4 открывался на Mac как аудиозапись.

Это полезный пример для небольших настольных утилит. В обоих случаях видимая ошибка находилась далеко от её причины. Проверка одного сетевого запроса или наличия видеодорожки не давала полного ответа: требовалось пройти путь пользователя до самого конца.

Окно «Качалки» объединяет выбор качества, состояние загрузки и доступ к папке с результатом.

Что меняется при упаковке

«Качалка» соединяет yt-dlp, FFmpeg и интерфейс на CustomTkinter. PyInstaller упаковывает их в приложение для macOS и исполняемый файл Windows. Такая сборка переносит на компьютер пользователя не только собственную логику программы, но и конкретное окружение с библиотеками и их зависимостями.

Локальный запуск Python и запуск готового файла поэтому нельзя считать равнозначными проверками. Даже одинаковая версия основной библиотеки не гарантирует одинаковое поведение сетевого стека. Особенно заметно это там, где внешний сервис оценивает характеристики соединения, а не только адрес страницы.

В случае TikTok автор связал различие с TLS-отпечатком сборок Python. Это диагностическая гипотеза, а не опубликованное описание внутренних правил платформы. Практическое исправление состояло в подключении curl_cffi и включении его ресурсов в дистрибутив. После этого результат проверили именно на файле, собранном системой автоматизации.

Почему MP4 ещё не означает совместимость

MP4 описывает контейнер. Внутри него находятся потоки, их параметры и сведения, по которым проигрыватель сопоставляет кадры со временем. Корректный видеокодек не освобождает от проверки этих данных. Файл может декодироваться одним инструментом и одновременно отвергаться другим.

У проблемного ролика FFmpeg видел видеопоток H.264, тогда как медиасистема macOS не возвращала ни одной видеодорожки. Временная база потока имела необычное значение 1/5995319. Исправлением стала повторная упаковка с масштабом времени видеодорожки 90000.

Здесь важна разница между упаковкой и перекодированием. При копировании потоков сжатые кадры не проходят повторно через видеокодер: меняется организация контейнера. Поэтому исправление служебных параметров не требует ухудшать изображение повторным сжатием. Флаг faststart дополнительно размещает информацию MP4 так, чтобы воспроизведение могло начинаться раньше.

Интерфейс должен отражать всю операцию

Для пользователя скачивание — одна задача. Для программы это может быть получение отдельного видео, получение аудио, объединение потоков и финальная обработка файла. Если каждый этап самостоятельно показывает сто процентов, полоска прогресса внезапно возвращается назад.

В «Качалке» общий прогресс учитывает размеры обеих загружаемых частей, а завершающей обработке оставлена отдельная доля. Тот же принцип полезен в экспорте, резервном копировании и установщиках: индикатор должен описывать готовность результата, а не локальный успех одного вспомогательного процесса.

Проверять нужно результат доставки

Репозиторий проекта открыт, а сборки для двух систем создаются автоматизированно. Но повторяемость сборки и работоспособность продукта отвечают на разные вопросы. Первая помогает установить происхождение файла; вторая требует открыть этот файл в целевой среде и проверить реальный сценарий.

Для подобной утилиты полезен короткий маршрут приёмки: запустить готовое приложение, получить видео, дождаться завершения обработки и открыть результат системным проигрывателем. Именно на стыках окружения, контейнера и пользовательского интерфейса обнаруживаются ошибки, которых не видно при успешном запуске исходного кода.

АвторAnthony Fubon

Anthony Fubon — российский музыкант, DJ, музыкальный продюсер, организатор мероприятий и специалист по цифровым продуктам. В музыке он использовал несколько имён, в частности Fubon, TheFubon и yagelProject. Его собственная биография описывает путь от рок-музыки и российской psytrance-сцены к электронной музыке разных направлений и созданию собственной цифровой экосистемы.