본문 바로가기
Dev Util

[멀티미디어 분석 툴] ffprobe.exe

by 잘 까먹는 다람쥐 2025. 3. 4.

[멀티미디어 변환 툴] FFmpeg.exe  에 이어,

 

ffprobe.exe 를 소개한다. (설치방법은 위 링크를 참조하도록 한다.)

 

ffprobe.exe란?

ffprobe는 FFmpeg 패키지에 포함된 강력한 멀티미디어 분석 도구로, 오디오 및 비디오 파일의 메타데이터, 코덱 정보, 스트림 구성 등을 확인하는 데 사용된다. 특히 GUI 없이도 간단한 명령어만으로 다양한 정보를 추출할 수 있어 자동화 시스템에 유용하다.

기본 사용법

ffprobe를 실행하는 가장 간단한 방법은 다음과 같다.

ffprobe 파일경로

이렇게 실행하면 파일의 기본적인 메타데이터와 스트림 정보를 확인할 수 있다. 하지만 너무 많은 정보가 출력되므로, 원하는 데이터만 필터링하는 것이 중요하다.

자주 사용하는 명령어 및 활용법

1. 오디오 및 비디오 코덱 확인

특정 스트림(비디오 또는 오디오)의 코덱 정보를 출력하려면 다음 명령어를 사용한다.

ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 파일경로

이 명령어는 첫 번째 비디오 스트림(v:0)의 코덱 이름만 출력한다.

비디오가 아닌 오디오 코덱을 확인하고 싶다면 다음과 같이 변경한다.

ffprobe -v error -select_streams a:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 파일경로

2. 해상도 및 프레임 레이트 확인

비디오의 해상도와 프레임 레이트를 확인하는 명령어는 다음과 같다.

ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate -of json 파일경로

이 명령어를 실행하면 JSON 형식으로 가로(width), 세로(height) 해상도와 프레임 속도(r_frame_rate)를 출력한다.

3. 전체 메타데이터 확인

파일의 전체적인 메타데이터를 출력하려면 다음과 같이 실행하면 된다.

ffprobe -v error -show_format -show_streams 파일경로

이 명령어는 스트림 정보뿐만 아니라 파일의 포맷, 지속 시간(duration), 비트레이트(bit_rate) 등의 정보도 함께 제공한다.

4. 특정 시간의 프레임 정보 가져오기

영상 파일에서 특정 시간대의 프레임 정보를 확인하려면 다음과 같이 실행한다.

ffprobe -v error -select_streams v:0 -show_frames -read_intervals 00:00:10%+1 파일경로

위 명령어는 10초 시점의 첫 번째 프레임 정보를 출력한다.

5. 오디오 채널 개수 확인

오디오 스트림의 채널 수를 확인하려면 다음과 같이 입력한다.

ffprobe -v error -select_streams a:0 -show_entries stream=channels -of default=noprint_wrappers=1:nokey=1 파일경로

이 명령어를 실행하면 오디오 채널 개수(모노: 1, 스테레오: 2 등)만 출력된다.

6. 다양한 출력 형식 설정

ffprobe는 JSON, XML, CSV 등 다양한 출력 형식을 지원한다. -of 옵션을 사용하여 원하는 형식으로 데이터를 출력할 수 있다.

JSON 형식 출력

ffprobe -v error -show_format -show_streams -of json 파일경로

XML 형식 출력

ffprobe -v error -show_format -show_streams -of xml 파일경로

CSV 형식 출력

ffprobe -v error -show_entries stream=index,codec_name -of csv 파일경로

이처럼 다양한 형식으로 데이터를 출력하면 후처리나 자동화 시스템과의 연동이 더욱 편리해진다.

활용 예시

ffprobe는 다양한 자동화 시스템에서 활용될 수 있다.

 

예를 들어:

  • 영상 파일을 처리하기 전에 코덱을 확인하여 지원 여부 결정
  • 파일의 해상도 정보를 읽어 적절한 출력 포맷을 선택
  • 메타데이터를 기반으로 라이브러리 관리 및 분류

 

이처럼 ffprobe를 활용하면 멀티미디어 파일을 더욱 효율적으로 관리하고 분석할 수 있다.

 

FFmpeg을 사용할 때 함께 활용하면 범용성이 높은 워크플로우를 구축할 수 있으니 머리 한 켠에 적용 사례를 기억해두고 필요할 때 찾아보도록 한다.

 

'Dev Util' 카테고리의 다른 글

게으른 개발자의 키매핑 세팅  (0) 2025.10.12
[동적 분석 Tool] Procmon.exe  (0) 2025.02.11
[멀티미디어 변환 툴] FFmpeg.exe  (0) 2025.01.19