a0a094b517
5/16 사용자 요구 "변환 너무 느려 20배는 빠르게 해줘" 대응. libx264 -preset ultrafast 보다 실질적으로 20배 빠른 길은 GPU/전용 ASIC 인코더밖에 없으므로, 첫 사용 시점에 한 번 자동 탐지해서 캐시한다. 탐지 흐름: 1) ffmpeg `-encoders` 출력에서 h264_nvenc, h264_qsv, h264_videotoolbox, h264_vaapi 후보를 추린다 (vaapi 는 /dev/dri/renderD128 도 필요). 2) 각 후보를 lavfi color 1프레임 인코드로 실측. 5초 타임아웃. 3) 첫 성공을 캐시; 모두 실패하면 libx264 ultrafast 폴백. 4) 우선순위: nvenc > qsv > videotoolbox > vaapi > libx264. 각 프로필은 (preInputArgs, vfilterSuffix, codecArgs) 세 묶음을 들고 있어 호출자는 자기 vfilter chain 끝과 `-i` 앞에 그대로 spread 만 하면 된다. vaapi 의 `-vaapi_device .../renderD128` 와 `,format=nv12,hwupload` 가 이 모델로 깨끗하게 흡수된다. 연결 지점: - upscaleOriginalTo60Fps: libx264 자리에 enc.codecArgs spread. vfilter 끝에 enc.vfilterSuffix 이어붙임. preInputArgs 를 -i 앞에 prepend. - applyTrimToVideo 재인코드 경로: 동일 처리. baseArgs 를 처음부터 다시 쌓아 preInputArgs 가 ffmpeg 전역 옵션 위치(-ss/-to/-i 보다 앞)에 가게. - stream-copy trim 경로는 그대로 둠 (인코더 안 씀). 검증 (fake ffmpeg + lavfi 1프레임 테스트): - only libx264 listed → libx264 (폴백) - nvenc+qsv listed, nvenc fails → qsv - nvenc works → nvenc - only vaapi works → vaapi (+ preInput/vfilter suffix 확인) - nvenc+qsv+vaapi listed, all HW fail → libx264 (폴백)
비디오 사이트
영상 업로드 및 저장을 위한 사이트
실행
처음 한 번은 setup 으로 의존성 + yt-dlp 바이너리 + 빌드까지 한 번에 끝낼 수 있어요:
cp .env.example .env # 포트/호스트 등 환경변수 편집
npm run setup # npm install + ./bin/yt-dlp 다운로드 + tsc
npm start # .env 의 HOST:PORT 로 바인딩
수동으로 단계별로 하고 싶다면:
npm install
npm run build
npm start
설정은 전부 .env 한 파일로 모았습니다 (.env.example 참고).
HOST— 바인딩 주소. 외부 노출이 필요하면0.0.0.0, 로컬 전용이면127.0.0.1.PORT— 바인딩 포트 (기본3000).SESSION_SECRET— 운영 시 반드시 충분히 긴 랜덤 문자열로 교체.UPLOAD_MAX_BYTES— 업로드 용량 한도(바이트). 비우거나 미설정이면 기본1073741824(1 GiB). 무제한으로 두려면0또는Infinity. 잘못된 값은 기본 1 GiB 로 fallback.HTTP_REQUEST_TIMEOUT_MS— 대용량 업로드용 HTTP 요청 타임아웃(밀리초).0/미설정이면 무제한.- 관리자 비밀번호는
account.json의password값 (초기값admin, 운영 시 반드시 변경).
외부 의존
yt-dlp— YouTube 영상 가져오기.npm run setup이./bin/yt-dlp로 자동 설치하지만 PATH 에 이미 있어도 됩니다. Alpine / distroless 같이 glibc 가 없는 슬림 도커 베이스에서는 번들 바이너리가 안 도니apk add yt-dlp(또는apt-get install yt-dlp,pip install yt-dlp) 로 PATH 에 직접 설치하세요. 도커 빌드에서 아예 받지 않으려면SKIP_YT_DLP=1 npm run setup. (검증 실패해도 setup 은 경고만 출력하고 빌드는 계속 진행됩니다.)ffmpeg— 영상 트림 저장 (PATH에 설치). 없으면 trim 설정만 저장됩니다.npm run setup이 설치 여부를 검사해 안내 메시지를 출력합니다.
데이터 위치
data/
folders/<폴더이름>/<videoId>/
meta.json # 영상 메타 (제목, trim, 원본/편집본 파일명)
original.<ext> # 원본 (항상 보존)
edited.<ext> # 편집본 (저장 시 생성)
jobs/<jobId>.json # YouTube 다운로드 작업 상태
스펙
메인 페이지 (/)
- 동영상이 저장되어있는 폴더를 나열합니다.
- 폴더를 선택해 안에 영상을 확인할수있습니다.
- 폴더를 선택하면 /folder/:폴더이름 으로 이동합니다.
폴더 화면 페이지 (/folder/:폴더이름)
- 폴더 내부에 영상을 유튜브처럼 목록으로 보여줍니다.
- 누르면 재생 플레이어가 뜨며 영상이 재생됩니다.
- 재생플레이어는 /player/:videoId로 합니다.
- 플레이어는 내부팝업처럼 띄워줍니다.
관리자 페이지 (/op)
- 동영상을 추가, 삭제, 관리하는 페이지입니다.
- https://git.tkrmagid.kr/tkrmagid/minecraft_launcher repo에 사이트에 있는 op페이지에 로그인 로직을 똑같이 가져와서 적용합니다. (navbar도 채택해서 가져오기)
- 메인 페이지처럼 폴더를 나열하고 우클릭으로 폴더 이름 수정, 삭제가 가능하도록 합니다.
- 폴더를 선택하면 /op/folder/:폴더이름 으로 이동합니다.
- 오른쪽위에 폴더추가버튼으로 폴더를 추가할수있도록 합니다.
- 폴더추가버튼 누르면 팝업으로 생성할 폴더이름을 작성한뒤 생성누르면 폴더 생성되게 설정합니다.
관리자 폴더 화면 (/op/folder/:폴더이름)
- 폴더 화면 페이지처럼 유튜브형식으로 영상을 나열하고 우클릭으로 수정, 삭제가 가능하도록 합니다.
- 오른쪽위에 영상추가버튼으로 영상을 추가할수있도록 합니다.
- 영상추가버튼 누르면 /op/folder/:폴더이름/video/editor 로 이동합니다.
영상추가 화면 (/op/folder/:폴더이름/video/editor)
- 예시1: https://github.com/boostcamp-2020/Project13-Web-Video-Editor
- 예시2: https://github.com/mifi/lossless-cut
- 예시1, 예시2 처럼 영상을 수정할수있는 편집기 페이지를 보여줍니다.
- 영상 추가는 컴퓨터에있는 영상을 드래그 드랍 하거나, 직접 폴더에서 찾거나, 유튜브 영상 주소를 추가해서 영상을 추가할수있도록 합니다.
- 유튜브에서 영상 가져오는건 백그라운드에서도 진행 되도록해서 하면서 다른걸 할수있도록 합니다.
- 영상 가져오는 시간을 미리 계산해서 5분 이상 걸릴거같으면 미리 경고를 보냅니다.
- 위쪽에 네비게이션바를 만듭니다.
- 네비게이션바 왼쪽에서 영상 이름을 수정합니다.
- 오른쪽 위에 저장을 누르면 수정한 영상이 저장됩니다.
- 원본 영상과 수정한 내용을 전부 저장해두고, 관리자폴더화면에서 영상을 우클릭해 수정을 누르면 수정하던 화면을 보여줍니다.