FFMPEG 스크립트 작성 - 실험 도서관

스크립트 작성의 필요성

FFMPEG을 명령줄에서 반복적으로 사용해야 할 경우, 매번 동일한 명령어를 입력하는 것은 비효율적일 수 있다. 특히 여러 파일을 변환하거나 복잡한 파라미터를 사용하는 경우, 스크립트로 작업을 자동화하면 시간과 노력을 절약할 수 있다. 스크립트 작성은 FFMPEG의 강력한 기능을 효율적으로 사용할 수 있게 해주는 중요한 도구이다.

스크립트 작성의 기본 개념

스크립트는 단순히 여러 명령을 한 번에 실행할 수 있도록 미리 작성한 명령어 모음이다. 스크립트는 다양한 운영체제에서 사용할 수 있으며, 주로 셸 스크립트(bash), 배치 파일(batch file), 파이썬 스크립트 등이 사용된다.

셸 스크립트에서 FFMPEG 사용

리눅스 및 macOS에서 주로 사용되는 셸 스크립트를 활용해 FFMPEG 명령어를 자동화할 수 있다. 예를 들어, 다음과 같은 간단한 스크립트를 작성하여 여러 비디오 파일을 일괄 변환할 수 있다.

#!/bin/bash
for file in *.mp4; do
    ffmpeg -i "$file" -c:v libx264 "${file%.mp4}.mkv"
done

이 스크립트는 디렉토리 내에 있는 모든 .mp4 파일을 .mkv 파일로 변환한다. 여기서 for 루프는 디렉토리 내의 모든 파일을 순차적으로 처리하며, ffmpeg 명령을 통해 비디오 변환 작업을 수행한다.

스크립트 내 변수 사용

스크립트 내에서 변수를 사용하면 코드의 재사용성을 높일 수 있다. 특히 FFMPEG 명령어는 다양한 파라미터를 사용하는 경우가 많기 때문에, 변수를 활용하면 코드를 더 효율적으로 관리할 수 있다.

변수 설정 예시

#!/bin/bash
input_format="mp4"
output_format="mkv"
codec="libx264"

for file in *.$input_format; do
    ffmpeg -i "$file" -c:v$codec "${file%.$input_format}.$output_format"
done

여기서 input_format, output_format, 그리고 codec 변수를 사용하여 입력 파일 형식, 출력 파일 형식, 코덱을 설정하였다. 이러한 방식을 사용하면 간단한 변수 변경만으로도 여러 파일을 쉽게 변환할 수 있다.

조건문 사용

스크립트에서 조건문을 사용하여 특정 조건에 따라 FFMPEG 명령을 다르게 실행할 수 있다. 이를 통해 더 복잡한 변환 작업을 자동화할 수 있다.

조건문 예시

#!/bin/bash
input_format="mp4"
output_format="mkv"
codec="libx264"

for file in *.$input_format; do
    if [ "${file: -4}" == ".mp4" ]; then
        ffmpeg -i "$file" -c:v$codec "${file%.$input_format}.$output_format"
    else
        echo "Skipping non-mp4 file: $file"
    fi
done

위 예시에서는 .mp4 파일만 변환하며, 다른 형식의 파일은 변환하지 않고 건너뛰게 된다. if 조건문을 사용하여 파일 확장자를 검사하며, 조건을 만족하는 경우에만 FFMPEG 명령어를 실행한다.

파일 경로 처리

스크립트를 작성할 때 파일 경로를 처리하는 방법도 중요하다. 특히 여러 디렉토리에 분산된 파일을 처리해야 하는 경우 파일 경로를 적절히 관리해야 한다.

파일 경로 처리 예시

#!/bin/bash
input_dir="/path/to/input/"
output_dir="/path/to/output/"
codec="libx264"

for file in "$input_dir"*.mp4; do
    filename=$(basename "$file")
    ffmpeg -i "$file" -c:v$codec "$output_dir${filename%.mp4}.mkv"
done

이 스크립트에서는 basename 명령어를 사용하여 파일 이름만 추출한 후, 출력 디렉토리 경로와 함께 출력 파일을 생성한다. input_dir과 output_dir 변수를 사용하여 입력 및 출력 파일의 디렉토리를 각각 설정한다.

배치 파일에서 FFMPEG 사용

윈도우 환경에서는 배치 파일을 사용하여 FFMPEG 명령어를 자동화할 수 있다. 배치 파일 역시 반복적인 작업을 자동화하는 데 유용하며, 셸 스크립트와 유사한 방식으로 작동한다.

배치 파일 예시

@echo off
set input_format=mp4
set output_format=mkv
set codec=libx264

for %%f in (*.%input_format%) do (
    ffmpeg -i "%%f" -c:v %codec% "%%~nf.%output_format%"
)

위 배치 파일은 현재 디렉토리 내의 모든 .mp4 파일을 .mkv 파일로 변환한다. set 명령어를 통해 변수를 설정하며, for 루프를 사용하여 파일을 순차적으로 처리한다.

파이썬 스크립트에서 FFMPEG 사용

FFMPEG은 파이썬과 같은 프로그래밍 언어에서도 쉽게 호출할 수 있다. 파이썬 스크립트를 통해 FFMPEG 명령어를 실행하는 것은 더 복잡한 작업을 자동화하거나, GUI를 통해 작업을 제어하고자 할 때 매우 유용하다.

파이썬에서 FFMPEG 호출

파이썬의 subprocess 모듈을 사용하여 FFMPEG 명령어를 실행할 수 있다. 예를 들어, 다음과 같은 파이썬 스크립트는 여러 파일을 변환하는 작업을 수행할 수 있다.

import subprocess
import os

input_dir = "/path/to/input/"
output_dir = "/path/to/output/"
codec = "libx264"

for filename in os.listdir(input_dir):
    if filename.endswith(".mp4"):
        input_path = os.path.join(input_dir, filename)
        output_filename = filename.replace(".mp4", ".mkv")
        output_path = os.path.join(output_dir, output_filename)
        subprocess.run(["ffmpeg", "-i", input_path, "-c:v", codec, output_path])

이 파이썬 스크립트는 주어진 디렉토리 내에서 .mp4 파일을 찾아 .mkv 형식으로 변환한다. subprocess.run을 사용하여 FFMPEG 명령어를 실행하며, os.path.join을 통해 파일 경로를 처리한다.

스크립트의 실행 및 디버깅

스크립트를 작성한 후에는 실행 결과를 확인하고, 필요한 경우 디버깅 작업을 수행해야 한다. 특히 복잡한 FFMPEG 명령어를 사용할 때는 예상치 못한 오류가 발생할 수 있으므로, 스크립트의 각 부분을 꼼꼼히 확인해야 한다.

디버깅 기법

에러 출력 확인: FFMPEG은 명령어 실행 중 발생한 오류를 상세히 출력하므로, 이를 활용하여 문제를 해결할 수 있다.
로그 파일 저장: 스크립트 실행 시 로그 파일에 출력을 저장하여, 이후에 오류를 추적하고 분석할 수 있다.

ffmpeg -i input.mp4 output.mkv 2> error.log

위 명령어는 오류 메시지를 error.log 파일에 저장한다. 스크립트에서 이 방법을 사용하면, 변환 중 발생한 모든 오류를 한눈에 확인할 수 있다.

루프와 반복 처리

FFMPEG 작업을 자동화할 때, 반복 처리 루프를 활용하면 효율성을 극대화할 수 있다. 여러 파일을 처리하거나, 동일한 작업을 반복해야 할 때 유용하다.

루프 구조의 활용

반복적으로 동일한 작업을 수행해야 할 경우, 루프를 사용하여 각 파일에 대해 FFMPEG 명령을 실행할 수 있다. 예를 들어, 아래의 예시는 셸 스크립트에서 다양한 파일 형식을 순차적으로 변환하는 방법을 보여준다.

#!/bin/bash
for ext in mp4 mov avi; do
    for file in *.$ext; do
        ffmpeg -i "$file" -c:v libx264 "${file%.$ext}.mkv"
    done
done

이 스크립트는 .mp4, .mov, 그리고 .avi 형식의 파일을 순차적으로 변환한다. for 루프를 사용하여 각 파일 형식을 처리하며, 하나의 스크립트로 여러 형식의 파일을 자동으로 변환할 수 있다.

오류 처리 및 예외 처리

스크립트를 작성할 때 오류 처리 및 예외 처리는 필수적인 부분이다. 특히 FFMPEG은 다양한 미디어 파일을 처리하는 과정에서 파일 형식, 코덱, 해상도 등 여러 가지 이유로 오류가 발생할 수 있다. 스크립트 내에서 이러한 오류를 감지하고 처리할 수 있도록 해야 한다.

셸 스크립트에서의 오류 처리

셸 스크립트에서는 명령어가 실패했을 경우, 그에 대한 적절한 처리를 추가할 수 있다. if 문과 $? 변수를 활용하여 오류 발생 여부를 확인할 수 있다. $? 변수는 마지막 명령어의 종료 상태를 나타내며, 0이면 성공, 1 이상이면 실패를 의미한다.

오류 처리 예시

#!/bin/bash
input_file="input.mp4"
output_file="output.mkv"

ffmpeg -i "$input_file" -c:v libx264 "$output_file"
if [ $? -ne 0 ]; then
    echo "FFMPEG 변환에 실패하였다. 파일: $input_file"
    exit 1
else
    echo "FFMPEG 변환이 성공적으로 완료되었다. 파일: $output_file"
fi

위 스크립트는 FFMPEG 변환이 성공했는지 여부를 확인하고, 실패한 경우 에러 메시지를 출력한다. 성공적으로 변환이 완료되면 그 결과를 사용자에게 알려준다.

파이썬에서의 예외 처리

파이썬에서는 try-except 블록을 사용하여 예외 처리를 할 수 있다. 특히 FFMPEG 명령어가 실패할 경우, 이를 예외로 처리하여 오류 메시지를 출력하고 스크립트가 비정상적으로 종료되지 않도록 할 수 있다.

파이썬 예외 처리 예시

import subprocess
import os

input_file = "input.mp4"
output_file = "output.mkv"
codec = "libx264"

try:
    subprocess.run(["ffmpeg", "-i", input_file, "-c:v", codec, output_file], check=True)
    print(f"변환 성공: {output_file}")
except subprocess.CalledProcessError as e:
    print(f"FFMPEG 변환 실패: {e}")

이 예시에서 subprocess.run 함수는 check=True 옵션을 사용하여 명령어가 실패하면 CalledProcessError 예외를 발생시킨다. try-except 블록을 사용하여 이러한 예외를 처리하고, 오류가 발생했을 때 사용자에게 적절한 메시지를 출력한다.

로그 파일 관리

스크립트 작성 시 변환 작업의 진행 상황과 오류 로그를 파일로 저장하면, 이후 문제를 분석할 때 유용하다. FFMPEG은 기본적으로 명령어 실행 중 발생하는 모든 출력과 오류 메시지를 출력하는데, 이를 파일로 저장할 수 있다.

로그 파일 저장 예시

셸 스크립트에서는 표준 출력과 표준 오류 출력을 각각 다른 파일에 저장할 수 있다.

#!/bin/bash
input_file="input.mp4"
output_file="output.mkv"
log_file="output.log"
error_log_file="error.log"

ffmpeg -i "$input_file" -c:v libx264 "$output_file" > "$log_file" 2> "$error_log_file"

이 스크립트는 FFMPEG 명령어 실행 결과를 output.log 파일에 저장하고, 오류는 error.log 파일에 저장한다. 이렇게 하면, 스크립트를 실행한 후 로그 파일을 통해 변환 과정에서 발생한 문제를 쉽게 확인할 수 있다.

병렬 처리

FFMPEG 작업이 대량의 파일을 처리하거나 고화질 영상을 인코딩할 경우, 작업 시간이 길어질 수 있다. 이때 병렬 처리를 통해 작업 시간을 단축할 수 있다. 셸 스크립트와 파이썬 모두에서 병렬 처리를 적용할 수 있다.

셸 스크립트에서의 병렬 처리

리눅스 셸에서는 & 기호를 사용하여 백그라운드에서 명령어를 실행할 수 있다. 이를 활용하면 여러 FFMPEG 변환 작업을 병렬로 실행할 수 있다.

#!/bin/bash
for file in *.mp4; do
    ffmpeg -i "$file" -c:v libx264 "${file%.mp4}.mkv" &
done
wait

위 스크립트는 .mp4 파일을 병렬로 변환한 후, 모든 작업이 완료될 때까지 wait 명령어를 사용하여 대기한다. 이렇게 하면 여러 파일을 동시에 처리할 수 있어 작업 시간이 크게 단축된다.

파이썬에서의 병렬 처리

파이썬에서는 concurrent.futures 모듈을 사용하여 병렬 처리를 구현할 수 있다. ThreadPoolExecutor나 ProcessPoolExecutor를 사용하여 여러 작업을 동시에 실행할 수 있다.

파이썬 병렬 처리 예시

import subprocess
import os
from concurrent.futures import ThreadPoolExecutor

input_dir = "/path/to/input/"
output_dir = "/path/to/output/"
codec = "libx264"

def convert_video(filename):
    input_path = os.path.join(input_dir, filename)
    output_filename = filename.replace(".mp4", ".mkv")
    output_path = os.path.join(output_dir, output_filename)
    subprocess.run(["ffmpeg", "-i", input_path, "-c:v", codec, output_path])

with ThreadPoolExecutor() as executor:
    files = [f for f in os.listdir(input_dir) if f.endswith(".mp4")]
    executor.map(convert_video, files)

이 파이썬 스크립트는 ThreadPoolExecutor를 사용하여 .mp4 파일을 병렬로 변환한다. executor.map을 사용하여 파일 리스트를 순회하며 변환 작업을 동시에 처리한다.

스크립트에서 사용자 입력 받기

스크립트를 작성할 때, 사용자가 입력할 수 있는 옵션을 제공하면 더욱 유연한 스크립트를 만들 수 있다. 사용자는 파일 경로, 출력 형식, 코덱 등의 파라미터를 직접 입력할 수 있으며, 이를 통해 스크립트의 재사용성을 높일 수 있다.

셸 스크립트에서 사용자 입력 받기

셸 스크립트에서는 read 명령어를 사용하여 사용자로부터 입력을 받을 수 있다. 이를 통해 FFMPEG의 인코딩 설정이나 출력 파일 형식을 동적으로 설정할 수 있다.

사용자 입력 처리 예시

#!/bin/bash
echo "변환할 파일의 경로를 입력하라:"
read input_file
echo "출력 파일의 경로를 입력하라:"
read output_file
echo "사용할 코덱을 입력하라 (예: libx264, libx265):"
read codec

ffmpeg -i "$input_file" -c:v$codec "$output_file"

이 스크립트는 사용자로부터 입력 파일, 출력 파일, 그리고 사용할 코덱을 입력받아 FFMPEG 명령을 실행한다. 이를 통해 스크립트가 다양한 파일 변환 작업에 사용할 수 있도록 유연성을 제공한다.

파이썬에서 사용자 입력 받기

파이썬에서는 input() 함수를 사용하여 사용자 입력을 처리할 수 있다. 이를 통해 스크립트 실행 중에 변환할 파일이나 출력 형식 등을 사용자가 입력하도록 할 수 있다.

파이썬 사용자 입력 예시

import subprocess

input_file = input("변환할 파일의 경로를 입력하라: ")
output_file = input("출력 파일의 경로를 입력하라: ")
codec = input("사용할 코덱을 입력하라 (예: libx264, libx265): ")

subprocess.run(["ffmpeg", "-i", input_file, "-c:v", codec, output_file])

이 파이썬 스크립트는 사용자로부터 입력을 받아 FFMPEG 명령을 동적으로 실행한다. 이를 통해 다양한 파일을 변환하는 작업을 효율적으로 처리할 수 있다.

환경 변수 사용

스크립트에서 환경 변수를 활용하면 시스템의 다양한 설정을 스크립트 내에서 손쉽게 사용할 수 있다. 환경 변수는 스크립트 외부에서 설정된 값들을 참조하거나, 스크립트 실행 시 동적으로 설정할 수 있다.

환경 변수 설정 예시 (셸 스크립트)

셸 스크립트에서 환경 변수를 사용하려면 export 명령어를 사용하여 변수를 설정할 수 있다.

#!/bin/bash
export INPUT_DIR="/path/to/input"
export OUTPUT_DIR="/path/to/output"

for file in "$INPUT_DIR"/*.mp4; do
    ffmpeg -i "$file" -c:v libx264 "$OUTPUT_DIR/${file%.mp4}.mkv"
done

위 스크립트는 INPUT_DIR과 OUTPUT_DIR 환경 변수를 사용하여 입력 및 출력 파일의 디렉토리를 설정한다. export 명령어를 사용하여 설정된 환경 변수는 스크립트 내에서 사용할 수 있으며, 외부에서도 참조할 수 있다.

환경 변수 설정 예시 (파이썬)

파이썬에서 환경 변수를 사용하는 방법은 os 모듈의 environ을 사용하여 접근할 수 있다.

import os
import subprocess

input_dir = os.environ.get("INPUT_DIR", "/path/to/input/")
output_dir = os.environ.get("OUTPUT_DIR", "/path/to/output/")
codec = "libx264"

for filename in os.listdir(input_dir):
    if filename.endswith(".mp4"):
        input_path = os.path.join(input_dir, filename)
        output_filename = filename.replace(".mp4", ".mkv")
        output_path = os.path.join(output_dir, output_filename)
        subprocess.run(["ffmpeg", "-i", input_path, "-c:v", codec, output_path])

이 파이썬 스크립트는 환경 변수를 사용하여 입력 및 출력 디렉토리를 설정한다. os.environ.get을 사용하여 환경 변수 값을 가져오며, 환경 변수가 설정되지 않은 경우 기본 값을 사용할 수 있도록 처리한다.

배치 파일에서의 사용자 입력

윈도우 배치 파일에서도 사용자의 입력을 받아 FFMPEG 명령어를 동적으로 실행할 수 있다. set /p 명령어를 사용하여 사용자의 입력을 변수에 저장한 후 이를 FFMPEG 명령어에 사용할 수 있다.

배치 파일 사용자 입력 예시

@echo off
set /p input_file="변환할 파일의 경로를 입력하라: "
set /p output_file="출력 파일의 경로를 입력하라: "
set /p codec="사용할 코덱을 입력하라 (예: libx264, libx265): "

ffmpeg -i "%input_file%" -c:v %codec% "%output_file%"

이 배치 파일은 사용자로부터 입력을 받아 FFMPEG 명령어를 실행한다. 이를 통해 윈도우 환경에서도 스크립트를 유연하게 작성할 수 있다.

작업 자동화와 크론탭 사용

리눅스 환경에서는 cron을 사용하여 스크립트를 일정한 시간 간격으로 자동 실행할 수 있다. 이를 통해 FFMPEG 작업을 특정 시간마다 실행하도록 자동화할 수 있다.

크론탭 설정 예시

크론탭(crontab)은 리눅스의 예약 작업 관리 도구이다. FFMPEG 스크립트를 매일 일정한 시간에 실행하도록 설정할 수 있다.

터미널에서 크론탭 편집기를 엽니다. bash crontab -e
다음과 같은 크론탭 항목을 추가하여 매일 오전 3시에 FFMPEG 스크립트를 실행하도록 설정한다. bash 0 3 * * * /path/to/ffmpeg_script.sh

이 설정은 매일 오전 3시에 ffmpeg_script.sh 스크립트를 실행한다. 이를 통해 주기적인 비디오 파일 변환 작업을 자동화할 수 있다.