Shotcut 딥다이브
— Qt6 + MLT로 만든, 15년째 살아 있는 오픈소스 영상편집기 해부

1한 줄 정체

Shotcut은 "MLT라는 멀티미디어 엔진 위에 Qt6로 얹은, 타임라인 기반의 무료·크로스플랫폼 영상편집기"다. 여러분이 화면에서 보는 것 — 클립을 끌어다 놓는 타임라인, 필터 목록, 미리보기 재생기 — 은 전부 Qt/QML로 그린 껍데기(GUI)이고, 그 뒤에서 실제로 영상을 읽고·자르고·합치고·내보내는 일은 MLT 엔진이 한다. Shotcut의 소스를 읽는다는 건 곧 "GUI가 엔진에게 일을 어떻게 시키는가"를 읽는 것이다.

사용자가 타임라인에서 클립 하나를 드래그해 옮겼을 때, Shotcut 내부에서 벌어지는 일을 압축하면 이렇다:

이 7단계가 Shotcut의 데이터 흐름 한 사이클이다. 눈여겨볼 것은 ③에서 명령 객체(Command)를 거친다는 점 — 덕분에 모든 편집이 Ctrl+Z로 되돌려진다. 그리고 ④~⑦처럼 "직접 UI를 고치지 않고, 엔진을 바꾼 뒤 그 변화가 신호로 돌아와 UI를 갱신"하는 단방향 흐름이 앱 전체에서 반복된다.

2왜 주목받는가 — 구독 없는 "완전한 소유"

Shotcut은 2011년에 시작된 15년차 프로젝트다. 신생 레포가 아닌데 TrendShift에 다시 오른 데는 이유가 있다. 요즘 영상편집 시장은 구독제(Premiere)와 무료지만 폐쇄형(DaVinci Resolve 무료판)으로 양분돼 있는데, Shotcut은 "진짜로 공짜이고, 소스가 열려 있고, 계정·워터마크·기능 제한이 전혀 없는" 몇 안 되는 선택지다. 최근 AI 자막·TTS 기능이 붙으면서 다시 주목받았다.

경쟁 제품과 비교하면 위치가 분명해진다

기술적으로 주목할 세 가지

① 엔진/GUI 분리 설계가 교과서적이다. 앞서 본 MLT(엔진) ↔ Qt(GUI) 분업은 대형 데스크탑 앱을 어떻게 층으로 쪼개는지 보여주는 살아있는 예시다. UI를 바꿔도 엔진은 그대로, 엔진을 업그레이드해도 UI는 그대로다.

② 되돌리기(undo)가 전 기능에 일관되게 박혀 있다. 편집·필터·자막·마커 등 모든 변경이 QUndoCommand 객체로 표현돼 하나의 스택에 쌓인다. "모든 사용자 행동을 객체로 만든다"는 명령 패턴(Command Pattern)의 대규모 실전 사례다.

③ AI 기능이 외부 프로세스로 깔끔하게 붙었다. 음성→자막(Whisper), 텍스트→음성(Kokoro TTS)이 앱 본체를 무겁게 만들지 않고 백그라운드 작업(Job)으로 분리돼 있다. 무거운 AI를 앱에 통합하는 현실적인 방법을 보여준다.

3기술 스택 전체 지도

Shotcut은 "엔진 + GUI + 백그라운드 도구"의 3층 구조다. 각 층이 어떤 라이브러리를 쓰는지 지도로 펼치면 이렇다.

① 엔진 층 (실제 미디어 처리)

② GUI 층 (사용자가 보는 화면)

③ 백그라운드 도구 층 (무거운 일은 별도 프로세스로)

4아키텍처 심화 — 엔진·명령·모델·뷰의 4겹

Shotcut을 이해하는 열쇠는 4개의 전역 싱글턴(singleton)이다. 이 넷이 앱의 기둥이고, 나머지 코드는 대부분 이들 사이의 심부름이다. 개발자들은 편하게 부르려고 짧은 매크로 별명까지 붙여놨다.

실제 코드에서 별명은 이렇게 정의돼 있다(mltcontroller.h 등):

// 각 헤더 끝에 매크로로 "짧은 별명"을 심어둠
#define MLT       Mlt::Controller::singleton()
#define MAIN      MainWindow::singleton()
#define Actions   ShotcutActions::singleton()
#define Settings  ShotcutSettings::singleton()

// 그래서 코드 어디서든 이렇게 쓴다:
MAIN.undoStack()->push(command);   // 되돌리기 스택에 명령 추가
MLT.setProducer(producer);          // 엔진에 새 입력 지정

데이터 흐름 — 왜 "명령"을 거치나

가장 중요한 설계 결정은 "UI가 엔진을 직접 만지지 않는다"는 것이다. 모든 편집은 반드시 QUndoCommand 객체를 거쳐 간다. 이 우회로 덕분에 되돌리기/다시하기가 공짜로 따라온다.

C++와 QML을 잇는 다리 — 모델

QML은 C++ 객체를 직접 못 만진다. 그래서 그 사이에 모델(Model)이 다리를 놓는다. MultitrackModel은 QAbstractItemModel을 상속해 "트랙-클립 2단계" 데이터를 QML이 읽을 수 있는 형태(role)로 노출한다. 클립의 이름·색·길이·잠금 여부 등이 모두 role로 정의돼 있어, QML 쪽은 model.name, model.duration처럼 접근한다.

// multitrackmodel.h — 트랙 종류를 enum으로 정의
typedef enum {
    PlaylistTrackType,   // 일반 트랙
    BlackTrackType,      // 배경(맨 밑 검은 트랙)
    SilentTrackType,
    AudioTrackType,      // 오디오 트랙
    VideoTrackType       // 비디오 트랙
} TrackType;

// 2단계 모델: 트랙, 그리고 트랙 위의 클립
Mlt::Tractor *tractor() const { return m_tractor; }

5디렉토리 구조 해부

규모가 큰 만큼 폴더가 곧 기능 지도다. 파일 수와 함께 보면 "어디에 무게가 실렸는지"가 한눈에 들어온다.

6학습 포인트 — 기술별 배울 것

Shotcut은 "실무급 데스크탑 앱이 어떻게 조립되는가"의 완성된 표본이다. 튜토리얼용 장난감이 아니라 15년간 다듬어진 실전 코드라, 아래 주제들을 "이론"이 아니라 "현장 코드"로 배울 수 있다.

① 대형 앱의 층 분리 (아키텍처)

엔진(MLT) ↔ 명령(commands) ↔ 모델(models) ↔ 뷰(qml)의 4겹 분리는 어떤 언어·프레임워크로 옮겨도 통하는 보편 설계다. "UI 코드에서 비즈니스 로직을 어떻게 떼어내는가"를 배우려면 src/commands/와 src/models/를 대조해 읽어라. UI는 명령만 만들고, 명령이 엔진을 바꾸고, 모델이 그 변화를 UI에 되돌려준다.

② 되돌리기 시스템 (명령 패턴)

모든 편집을 QUndoCommand로 표현하는 방식은 그림판·문서편집기·IDE 등 되돌리기가 필요한 모든 앱의 핵심이다. undohelper.cpp를 보면 "되돌리기 전에 상태를 어떻게 저장하고, 최적화 힌트(SkipXML 등)로 어떻게 빠르게 복원하는지"까지 나온다.

③ C++ ↔ QML 하이브리드 UI

요즘 Qt 앱의 정석은 "골격은 C++, 동적 UI는 QML"이다. Shotcut은 src/qmltypes/에서 색상휠·파일다이얼로그 같은 C++ 위젯을 QML에 등록하는 법을, src/models/에서 데이터를 넘기는 법을 보여준다. Qt로 앱을 만들 계획이라면 이 다리 놓는 패턴이 가장 값지다.

④ 무거운 작업의 비동기 처리 (Job 큐)

인코딩·AI 자막 같은 몇 분짜리 작업을 UI를 얼리지 않고 돌리는 법. src/jobs/의 AbstractJob을 상속한 각 Job은 대개 외부 프로세스(ffmpeg·whisper)를 QProcess로 띄우고, 출력을 파싱해 진행률(%)을 갱신한다. whisperjob.h를 보면 GPU 실패 시 CPU로 재시도하는 폴백까지 들어있다.

// whisperjob.h — 외부 프로세스로 AI 자막 생성
class WhisperJob : public AbstractJob {
    WhisperJob(const QString &name,
               const QString &iWavFile,   // 입력: WAV 오디오
               const QString &oSrtFile,   // 출력: SRT 자막
               const QString &lang,
               bool translate,           // 번역까지?
               int maxLength,
               bool useGpu = true);     // GPU 우선, 실패시 CPU
private:
    bool m_retryingWithoutGpu;    // ← 폴백 상태 플래그
    int  m_previousPercent;       // ← 진행률 추적
};

⑤ 진짜 크로스플랫폼 C++

main.cpp 하나에도 #ifdef Q_OS_WIN / Q_OS_MAC / Q_OS_LINUX 분기가 가득하다. 윈도우는 discrete GPU 힌트(NvOptimus)와 뮤텍스 기반 단일 실행, 리눅스는 PipeWire/PulseAudio 선택 등 OS별 차이를 하나의 코드베이스에서 어떻게 흡수하는지 실전 사례가 즐비하다.

실습 아이디어(가벼운 것부터)

• 필터 하나 골라 src/qml/filters/<이름>/의 UI QML을 열어보고, 슬라이더 범위를 바꿔 빌드 → 파라미터 UI가 어떻게 값과 연결되는지 관찰
• src/commands/markercommands.cpp에서 가장 단순한 명령 하나를 골라 redo()/undo() 짝을 읽고 그림으로 그려보기
• AGENTS.md의 grid/zoom 정수 인코딩 표(10010=10px, 20169=16:9)를 코드에서 실제로 쓰는 곳 찾아보기

7시스템 / 빌드 요구사항

사용(설치본 실행) 요구사항

빌드(소스 컴파일) 요구사항

# AGENTS.md가 알려주는 가장 빠른 빌드 (프리셋 사용)
cmake --preset cc-debug              # 구성: Ninja + Qt6 + Debug
cmake --build build/cc-debug         # 빌드
build/cc-debug/src/shotcut           # 빌드 트리에서 바로 실행

# 설치하지 않으면 QML 파일을 못 찾아 실행이 실패할 수 있다
cmake --install .                    # (별도 빌드 디렉토리 사용 시)

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 로드맵 (주차별)

이 레포는 두 갈래 학습의 교차로다 — (A) Qt 데스크탑 앱 개발과 (B) 영상/오디오 처리. 6주 코스로 짜면 이렇다.

10핵심 키워드 사전

11참고 링크

• GitHub 저장소: github.com/mltframework/shotcut
• 공식 사이트 · 다운로드: shotcut.org (바이너리·기능 소개·로드맵)
• MLT 엔진: mltframework.org — Shotcut의 심장, 같은 저자
• 1차 소스(꼭 읽을 것): AGENTS.md(아키텍처 요약·코드 관례) · src/main.cpp(앱 부트) · src/mainwindow.cpp(허브) · src/commands/(되돌리기) · src/models/multitrackmodel.cpp(타임라인)
• UI 프레임워크: Qt · Qt Quick/QML 문서
• 엔진이 부리는 도구: FFmpeg · Frei0r · FFTW · SDL
• AI 기능 원천: whisper.cpp(자막 STT) · Kokoro TTS(음성 합성)
• 비슷한 프로젝트: Kdenlive(같은 MLT 엔진) · OpenShot · Olive(오픈소스 편집기들)
• 참고 개념: 명령 패턴, 모델-뷰 아키텍처, 싱글턴, QProcess 비동기, 크로스플랫폼 조건부 컴파일, 논리니어 편집(NLE)