Skip to content

octopus7/OctoCut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OctoCut

OctoCut preview

OctoCut은 .NET 10 WPF 기반의 간이 영상 편집 도구입니다. 하나의 영상을 열고, 타임라인에서 클립을 분할하거나 삭제한 뒤 FFmpeg로 결과물을 렌더링하는 MVP를 목표로 합니다.

구현된 기능

  • 단일 영상 파일 열기
  • 편집기 스타일 타임라인
    • 분할 후 원본 기준이 아니라 분할된 클립들이 이어진 편집 타임라인으로 동작
    • 시간 눈금, 썸네일 트랙, 오디오 파형 미리 보기 표시
    • 현재 위치는 1px 세로선으로 표시
  • 현재 타임라인 위치에서 클립 분할
  • 선택한 클립 삭제
  • 잔물결 삭제 옵션
    • 기본값은 켜짐
    • 켜져 있으면 삭제로 생긴 빈 구간을 뒤 클립이 앞으로 당겨 붙여 메웁니다.
  • 하단 상태 영역에 현재 시간, 전체 시간, 현재 프레임 번호, 전체 프레임 수 표시
  • 현재 프레임 캡처
    • F12로 현재 프레임을 원본 영상 해상도 PNG 이미지로 추출해 클립보드에 복사
    • File > 현재 프레임 파일로 저장 메뉴에서 PNG 파일로 저장
  • 보기 > 디버그 로그 보기 토글 메뉴
    • 일반 화면에는 로그 메시지를 표시하지 않습니다.
    • 토글을 켜면 별도 창에서 내부 작업 로그를 확인할 수 있습니다.
  • 다국어 UI
    • 기본 제공 언어: 한국어, English, 日本語, 简体中文, 繁體中文
    • 언어 설정 저장 이력이 없으면 최초 실행 시 OS 언어를 감지해 자동 선택하고 저장합니다.
    • 이후 실행부터는 저장된 언어를 계속 사용하며, File > Settings에서 변경할 수 있습니다.
    • Languages 폴더에 같은 구조의 JSON 언어 파일을 추가하면 설정의 언어 목록에 표시됩니다.
    • 언어 선택 목록의 언어 이름은 각 언어의 자체 표기(nativeName)를 그대로 사용하며 번역 대상이 아닙니다.
  • FFmpeg 기반 렌더링
    • 무인코딩 렌더: 가능한 경우 FFmpeg stream copy로 새 인코딩 없이 렌더링
    • 인코딩 렌더: H.264/AAC로 새 출력 파일 생성
  • FFmpeg 필수 실행 조건
    • 경로가 설정되어 있지 않고 자동 탐색도 실패하면 시작 시 안내 창 표시
    • WinGet 설치, 공식 다운로드 페이지 열기, 수동 경로 지정 지원
    • FFmpeg가 끝내 준비되지 않으면 앱은 종료됩니다.
  • File > Settings 메뉴에서 FFmpeg 경로 변경
  • 도움말 > 단축키 메뉴에서 단축키 안내

사전 준비

  • .NET 10 SDK
  • FFmpeg
    • OctoCut 실행과 렌더링에 필요합니다.
    • PATH에 등록하거나 앱 설정에서 ffmpeg.exe 경로를 직접 지정할 수 있습니다.
    • 최초 실행 시 FFmpeg를 찾지 못하면 안내 창에서 WinGet 설치 또는 수동 경로 지정을 선택할 수 있습니다.

언어 파일 확장

언어 파일은 실행 파일 옆의 Languages 폴더에 있는 JSON 파일입니다. 새 언어를 추가하려면 기존 파일을 복사해 code, nativeName, strings 값을 채우면 됩니다.

{
  "code": "en-US",
  "nativeName": "English",
  "strings": {
    "Main.Button.OpenVideo": "Open Video"
  }
}

앱은 누락된 문자열을 기본 언어인 한국어에서 찾아 사용합니다.

기본 사용법

  1. OctoCut을 실행합니다.
  2. 영상을 엽니다.
  3. 타임라인에서 원하는 위치로 이동합니다.
  4. S 키 또는 분할 버튼으로 현재 위치에서 클립을 나눕니다.
  5. 삭제할 클립을 선택하고 Delete 키 또는 삭제 버튼으로 삭제합니다.
  6. 잔물결 삭제가 켜져 있으면 삭제된 구간만큼 뒤 클립이 앞으로 당겨져 이어집니다.
  7. 렌더 메뉴에서 무인코딩 또는 인코딩 렌더를 선택해 결과물을 저장합니다.

단축키

  • Enter: 재생 / 일시정지
  • Space: 현재 위치에서 재생을 시작하고, 다시 누르면 재생 시작 위치로 돌아가 정지
  • S: 현재 위치에서 클립 분할
  • Delete: 선택 클립 삭제
  • Left / Right: 이전 / 다음 프레임으로 이동
  • F12: 현재 프레임을 클립보드로 복사

프로젝트 구조

  • OctoCut.sln: 솔루션 파일
  • OctoCut/: WPF 애플리케이션 프로젝트
  • README.md: 프로젝트 개요와 사용 안내

About

간단한 영상 트림 툴 (ffmpeg 기반)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages