History

caadiq 5855a6f08a Add README files for root, backend, and frontend		2025-12-15 23:59:24 +09:00
..
.gitignore	Add backend .gitignore and remove node_modules from tracking	2025-12-15 23:56:27 +09:00
package-lock.json	Initial commit: ffmpeg-gui	2025-12-15 23:53:29 +09:00
package.json	Initial commit: ffmpeg-gui	2025-12-15 23:53:29 +09:00
README.md	Add README files for root, backend, and frontend	2025-12-15 23:59:24 +09:00
server.js	Initial commit: ffmpeg-gui	2025-12-15 23:53:29 +09:00

README.md

🖥️ FFmpeg GUI - Backend

FFmpeg를 활용한 영상 다운로드/변환 API 서버입니다.

🛠️ 기술 스택

기술	설명
Node.js	런타임 환경
Express	웹 프레임워크
FFmpeg	영상 처리
UUID	고유 ID 생성

📡 API 엔드포인트

`POST /api/download-request`

다운로드 요청을 생성합니다.

Request Body:

{
  "url": "영상 URL",
  "title": "파일명 (선택)",
  "options": {
    "startTime": "00:00:00",
    "endTime": "00:01:00",
    "userAgent": "브라우저 UA",
    "referer": "리퍼러 URL"
  }
}

Response:

{
  "id": "uuid-v4-format"
}

`GET /api/download/:id`

생성된 요청 ID로 영상을 다운로드합니다.

요청은 5분 후 자동 만료됩니다.
Content-Type: video/mp4로 스트리밍됩니다.

🚀 실행 방법

# 의존성 설치
npm install

# 서버 실행
npm start

서버는 포트 3000에서 실행됩니다.

⚠️ 요구사항

Node.js 18+
FFmpeg 설치 필요 (ffmpeg, ffprobe)