맥에서 command not found: ffmpeg가 떠도 곧바로 재설치할 필요는 없습니다. 먼저 command -v ffmpeg로 현재 셸의 검색 결과를 보고, 설치 위치를 알고 있다면 그 파일을 절대경로로 실행해 보세요. 절대경로에서는 버전이 나오는데 이름만으로는 찾지 못한다면 PATH를 먼저 확인할 상황입니다.
2026년 11월 3일, FFmpeg가 이미 설치된 Apple Silicon 맥에서 실행 환경만 바꿔 이 차이를 재현했습니다. 설치나 업데이트, 셸 설정 파일 수정은 하지 않았습니다. 아래 결과는 이 한 대의 맥에 관한 기록이며, 모든 맥 오류의 원인 비율을 뜻하지 않습니다.
우선 이 두 가지를 비교하세요
command -v ffmpeg
/opt/homebrew/bin/ffmpeg -version
두 번째 줄은 Apple Silicon 기본 위치에 Homebrew로 설치한 경우의 예입니다. 다른 위치에 설치했다면 실제 경로로 바꿔야 합니다. /opt/homebrew/bin/ffmpeg가 없다는 결과만으로 맥 전체에 FFmpeg가 없다고 단정할 수는 없습니다.
| 내 맥의 결과 | 그 결과로 알 수 있는 것 | 다음 확인 |
|---|---|---|
| 첫 명령은 출력 없음, 절대경로는 버전 출력 | 지정한 FFmpeg는 실행 가능하지만 현재 검색 경로에서는 이름을 찾지 못함 | PATH와 Homebrew 셸 환경 확인 |
| 두 명령 모두 버전·경로 확인 가능 | 그 셸에서는 FFmpeg를 찾고 실행할 수 있음 | 오류가 나는 앱·스크립트의 환경을 별도로 확인 |
| 절대경로도 없거나 실행 실패 | 예시 경로만으로 설치·실행 상태를 확인할 수 없음 | 실제 설치 위치와 전체 오류 문구 확인 |
command -v는 별칭이나 함수가 있으면 그것을 표시할 수도 있습니다. 이 글의 재현은 사용자 설정을 읽지 않는 새 zsh에서 진행했습니다. 내 터미널에 예상과 다른 별칭·함수가 표시된다면 경로 문제와 구분해서 확인하세요.
같은 맥에서 PATH만 바꿨을 때의 실제 결과
확인 환경은 arm64, macOS 26.6.2, FFmpeg·ffprobe 9.0.1입니다. 실행 파일은 /opt/homebrew/bin에 있었고, 그 링크는 설치된 9.0.1_1 버전을 가리켰습니다. env -i로 환경을 비운 별도 프로세스에서 시험했으므로, 평소 터미널이나 다른 앱이 같은 환경이라는 뜻은 아닙니다.
| 시험 조건 | 실제 확인 결과 | 해석 범위 |
|---|---|---|
| 시스템 PATH만 사용 | command -v ffmpeg 출력 없음. ffmpeg -version은 zsh:1: command not found: ffmpeg, 종료 코드 127 |
이 환경에서 이름으로 찾지 못함 |
같은 PATH 앞에 /opt/homebrew/bin 추가 |
/opt/homebrew/bin/ffmpeg와 버전 9.0.1 출력. ffprobe도 경로와 버전 9.0.1 출력 |
기존 설치를 그대로 실행함 |
| 시스템 PATH에서 절대경로로 실행 | FFmpeg 버전 9.0.1 출력 | 검색 경로에 없어도 이 파일은 실행 가능함 |
| 시스템 PATH에서 Homebrew의 zsh용 shellenv 적용 | /opt/homebrew/bin/ffmpeg와 버전 9.0.1 출력 |
이 별도 셸의 환경을 설정한 결과 |
첫 두 조건 사이에서 바꾼 것은 실행 프로세스의 PATH입니다. 같은 설치 파일이 한 조건에서는 검색되지 않고 다른 조건에서는 실행됐으므로, 이번 재현에서는 재설치 없이 검색 경로 차이를 구분할 수 있었습니다. 최신 버전으로 바꿔 해결됐다는 실험은 아닙니다.
Homebrew는 있는데 ffmpeg를 못 찾는다면
현재 PATH는 다음처럼 확인할 수 있습니다. 이 명령은 설정을 바꾸지 않습니다.
printf '%s\n' "$PATH"
기존 Homebrew가 /opt/homebrew에 설치되어 있다면, 현재 zsh에서 다음 명령으로 Homebrew 환경을 적용한 뒤 다시 확인할 수 있습니다.
eval "$(/opt/homebrew/bin/brew shellenv zsh)"
command -v ffmpeg
ffmpeg -version
Homebrew 공식 shellenv 설명은 이 명령의 출력으로 PATH 등의 환경 변수를 설정한다고 안내합니다. 위 명령은 현재 셸에 적용됩니다. 새로운 터미널에서도 적용하려면 Homebrew 설치 때 나온 안내와 사용하는 셸에 맞는 설정 파일을 확인하세요. 공식 문서는 macOS의 예로 ~/.zprofile 등을 들지만, 같은 줄이 이미 있는지 먼저 살펴보고 중복 추가하지 않는 편이 좋습니다.
이번 시험에서는 설정 파일에 줄을 추가하지 않았습니다. 따라서 특정 독자의 .zprofile을 고쳤다거나, 모든 앱에서 영구적으로 해결된다고 말할 수는 없습니다.
Homebrew나 FFmpeg가 실제로 설치되지 않았다면
먼저 command -v brew로 Homebrew 검색 결과를 확인하세요. 이것도 출력이 없다면, 이미 설치됐지만 PATH에 없는 경우와 아직 설치하지 않은 경우를 구분해야 합니다. 알고 있는 설치 위치나 Homebrew 공식 설치·설치 후 설정 안내를 확인하는 순서입니다.
Homebrew가 정상적으로 실행되고 FFmpeg를 설치하려는 상황이라면, Homebrew의 FFmpeg 공식 패키지 페이지가 안내하는 설치 명령은 다음과 같습니다.
brew install ffmpeg
이 설치 명령은 이번 시험에서 실행하지 않았습니다. 공식 페이지의 2026년 11월 3일 확인 버전은 9.0.2이고, 실측에 사용한 기존 설치 버전은 9.0.1입니다. 두 버전을 구분해서 기록합니다. 새 맥의 처음 설치 과정이나 업데이트 성공 여부는 이번 결과에 포함되지 않습니다.
터미널에서는 되는데 자동화 스크립트에서만 안 된다면
오류가 나는 실행 환경에서 command -v ffmpeg와 PATH를 직접 확인하세요. 터미널에서 확인한 결과를 다른 앱이나 자동화 프로세스의 결과로 옮겨 적으면 원인을 놓칠 수 있습니다. 이번 시험도 같은 맥의 별도 셸 두 개에서 서로 다른 결과가 나왔습니다.
실행할 파일의 위치를 확인한 스크립트에서는 절대경로를 쓰거나, 그 스크립트에 필요한 PATH를 지정하는 방법을 검토할 수 있습니다. 다음은 이번에 성공을 확인한 두 방식의 재현 예입니다.
# 이름 검색 대신 확인한 실행 파일을 직접 사용
/opt/homebrew/bin/ffmpeg -version
# 이 명령 한 번의 실행 환경에만 PATH 지정
PATH=/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin ffmpeg -version
여기서 사용한 ffmpeg -version은 파일을 변환하거나 원본 영상을 덮어쓰지 않는 확인 명령입니다. 버전이 출력된 다음에 실제 작업 명령을 점검하세요. 경로를 찾은 뒤 별도의 라이브러리·코덱 오류가 나온다면, command not found와는 다른 단계의 문제입니다.
직접 같은 차이를 재현하려면
FFmpeg가 이미 /opt/homebrew/bin에 있는 맥에서 다음 두 명령을 각각 실행해 보세요. 사용자 셸 설정을 읽지 않는 별도 프로세스에서 비교하므로 현재 터미널의 PATH나 설정 파일을 고치지 않습니다.
/usr/bin/env -i PATH=/usr/bin:/bin:/usr/sbin:/sbin /bin/zsh -fc 'command -v ffmpeg; ffmpeg -version'
/usr/bin/env -i PATH=/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin /bin/zsh -fc 'command -v ffmpeg; ffmpeg -version'
이 맥에서는 첫 명령이 종료 코드 127로 끝났고, 두 번째는 설치 경로와 버전을 출력했습니다. Homebrew 위치가 다른 맥에서는 경로를 맞춰야 하며 결과도 달라질 수 있습니다. 이 재현은 FFmpeg 검색 경로 확인용이며, 특정 편집 앱·서비스의 실제 실행 환경을 복제한 것은 아닙니다.
자주 묻는 질문
command not found가 나오면 FFmpeg가 설치되지 않은 건가요?
그 메시지만으로 설치 여부를 확정할 수 없습니다. 이번에는 FFmpeg가 이미 설치되어 있었지만 시스템 PATH만 준 셸에서 같은 오류가 났습니다. 알고 있는 실제 설치 위치의 실행 파일과 현재 셸의 검색 결과를 함께 확인하세요.
brew shellenv를 실행하면 다음에 여는 앱에서도 해결되나요?
이번에 확인한 것은 명령을 실행한 별도 셸에서의 성공입니다. 설정 파일의 지속 적용이나 다른 앱의 환경은 별도로 확인해야 합니다. 이 시험에서는 셸 설정 파일을 수정하지 않았습니다.
공식 최신 버전과 내 버전이 다르면 다시 설치해야 하나요?
버전 차이 자체가 이번 command not found 재현의 원인은 아니었습니다. 설치 버전 9.0.1을 그대로 두고 PATH만 바꿨을 때 검색·실행 결과가 달라졌습니다. 버전 업그레이드 필요성과 실행 파일 검색 문제를 구분해서 확인하세요.
실행이 확인됐다면 다음 문제로 이어가기
FFmpeg를 실행할 수 있는 상태가 됐다면, 하려던 작업에 맞는 확인 절차를 이어가세요.
- 출력 영상의 소리가 작거나 큰가요? 내보낸 파일의 LUFS·트루 피크를 재는 법
- FFmpeg가 무음이라고 했는데 파형이 보이나요? 무음 판정 기준을 비교한 기록
- AI 영상이 정지 화면처럼 보이나요? 정지 화면 여부를 확인하는 FFmpeg 명령
AI 도움으로 작성했으며, 표의 실행 결과는 2026년 11월 3일 같은 Mac에서 직접 확인했습니다. Homebrew 신규 설치·업데이트, Intel·Windows, 개별 편집 앱에서의 동작은 시험하지 않았습니다. 제휴 링크와 상품 구매 유도는 없습니다.