Repolode
제출하기
0xSero

0xSero/video-edit

macOS 화면 녹화 원본을 군더더기 없이 편집하고 민감 정보를 가려, 렌더링까지 검증된 업로드용 영상으로 만들어 주는 에이전트 스킬 및 스크립트 모음입니다.

GitHub에서 보기
스타
86
포크
5
열린 이슈
0
마지막 커밋
3일 전

어떤 프로젝트인가요?

video-edit는 Python 및 ffmpeg 스크립트와 에이전트 스킬로 구성되어 있으며, 45~90분 분량의 macOS 화면 녹화(OBS, 웹캠이 포함된 화면 녹화)를 업로드용 20~30분 영상으로 만들어 줍니다. 트랜스크립트를 중심으로 작업이 진행됩니다. 에이전트가 유지할 구간을 정하면 스크립트가 편집 결정 목록을 만들고, 영상을 렌더링한 뒤 결과를 검사합니다. 모든 작업은 로컬에서 실행됩니다.

이 도구 모음은 원본 녹화에서 흔히 발생하는 문제를 해결합니다. 시각적으로 변화가 적은 긴 구간은 무음 여부가 아니라 프레임 차이 분석으로 감지합니다. 일시 정지는 보정된 오디오가 조용한 구간에서만 줄이며, 호스트 이름이나 API 키 같은 민감한 텍스트는 블러 윈도로 가린 다음 렌더링 결과에 OCR을 적용해 확인합니다. Apple Vision으로 손의 포즈와 얼굴을 감지해 검토가 필요한 후보 구간을 표시합니다. 오디오는 DeepFilterNet3 노이즈 감소, EQ, 디에서, 압축을 거친 뒤 2패스 loudnorm으로 −16 LUFS에 맞춥니다.

렌더링은 그룹별로 중단 후 재개할 수 있습니다. 검증 스크립트는 예상 프레임 수를 다시 계산하고, 오디오 트랙 길이를 비교하며, 완성된 파일에 OCR을 다시 실행합니다. 정보가 하나라도 노출되면 0이 아닌 종료 코드를 반환합니다. selftest 스크립트는 합성 녹화 파일로 전체 파이프라인을 실행합니다.

핵심 기능

  • 01단일 job.json 파일에서 트랜스크립트 기반 유지 구간과 개인정보 보호를 위한 편집 구간을 정의합니다.
  • 02무음 감지와 별도로 프레임 차이를 이용해 정적인 화면을 감지합니다.
  • 03민감한 텍스트가 있는 창 전체를 블러 처리한 뒤, 렌더링 결과에 OCR을 적용해 정보가 노출되지 않았는지 확인합니다.
  • 04DeepFilterNet3 노이즈 감소와 2패스 loudnorm을 통한 −16 LUFS 조정이 포함된 오디오 처리 체인입니다.
  • 05macOS의 VideoToolbox를 사용한 재개 가능한 그룹별 h264 렌더링과 검증 단계가 제공됩니다.

활용 사례

  • 코딩 세션이나 데모를 녹화한 긴 OBS 화면 녹화를 짧은 YouTube 영상으로 편집하기.
  • 녹화 영상을 게시하기 전에 호스트 이름, 토큰 또는 화면에 표시된 다른 비밀 정보를 가리기.
  • Mac에서 녹화한 발표 영상에서 유휴 구간을 제거하고 일시 정지를 줄이기.

빠른 시작

  1. 1

    저장소를 에이전트 스킬 디렉터리에 클론합니다

    git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit
  2. 2

    Python 종속 항목을 설치합니다

    python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz
  3. 3

    합성 녹화 파일로 셀프 테스트를 실행해 설치를 확인합니다

    bash scripts/selftest.sh /tmp/ved-selftest

사용 전 알아둘 점

  • macOS 14 이상이 필요하며, Linux는 별도 수정 없이 지원되지 않습니다.
  • 특정 OBS 스타일의 macOS 화면 녹화 워크플로에 맞춰 제작되었습니다.
  • ffmpeg 6.0 이상과 Python 3.10 이상을 별도로 설치해야 합니다.

포함된 컬렉션

오픈소스 Mac 앱프라이버시·로컬 퍼스트 도구PDF·OCR·문서 처리 도구AI 영상·오디오 도구

토픽

#video-editing#screen-recording#ffmpeg#audio-processing#privacy#ocr#macos#automation

자주 묻는 질문

video-edit은(는) 무엇인가요?
macOS 화면 녹화 원본을 군더더기 없이 편집하고 민감 정보를 가려, 렌더링까지 검증된 업로드용 영상으로 만들어 주는 에이전트 스킬 및 스크립트 모음입니다. video-edit는 Python 및 ffmpeg 스크립트와 에이전트 스킬로 구성되어 있으며, 45~90분 분량의 macOS 화면 녹화(OBS, 웹캠이 포함된 화면 녹화)를 업로드용 20~30분 영상으로 만들어 줍니다. 트랜스크립트를 중심으로 작업이 진행됩니다. 에이전트가 유지할 구간을 정하면 스크립트가 편집 결정 목록을 만들고, 영상을 렌더링한 뒤 결과를 검사합니다. 모든 작업은 로컬에서 실행됩니다.
video-edit은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
video-edit은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
video-edit은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. video-edit의 마지막 커밋은 2026년 11월 4일입니다.
video-edit은(는) 어디에 사용할 수 있나요?
코딩 세션이나 데모를 녹화한 긴 OBS 화면 녹화를 짧은 YouTube 영상으로 편집하기. 녹화 영상을 게시하기 전에 호스트 이름, 토큰 또는 화면에 표시된 다른 비밀 정보를 가리기. Mac에서 녹화한 발표 영상에서 유휴 구간을 제거하고 일시 정지를 줄이기.
video-edit는 어떻게 설치하나요?
저장소를 에이전트 스킬 디렉터리에 클론합니다: git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit Python 종속 항목을 설치합니다: python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz 합성 녹화 파일로 셀프 테스트를 실행해 설치를 확인합니다: bash scripts/selftest.sh /tmp/ved-selftest
video-edit은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/0xSero/video-edit

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트