Repolode
제출하기
frederikemmer

frederikemmer/MediaLyze

ffprobe로 동영상·음악·오디오북 라이브러리를 스캔하고 웹 UI에서 기술 메타데이터를 보여주는 셀프 호스팅 도구입니다.

GitHub에서 보기웹사이트
스타
509
포크
17
열린 이슈
8
마지막 커밋
어제

어떤 프로젝트인가요?

MediaLyze는 로컬 동영상, 음악, 오디오북 컬렉션을 스캔하고 ffprobe로 파일을 분석해 형식, 스트림, 자막 정보를 정규화한 뒤 검색 가능한 라이브러리로 구성합니다. FastAPI와 React 기반 웹 인터페이스에서 차트, 과거 데이터 분석, 비교 보기, 컬렉션 전체의 품질 점수를 확인할 수 있습니다.

SQLite 데이터베이스 하나를 사용하는 단일 Docker 컨테이너로 실행하거나, Windows, macOS, Linux용 Electron 데스크톱 앱으로 빌드할 수 있습니다. 전체 및 증분 스캔은 경로, 크기, 수정 시간을 기준으로 변경 사항을 추적하고, glob 패턴으로 파일과 폴더를 제외할 수 있습니다.

또한 연결된 동영상 변형 파일을 만드는 베타 FFmpeg 트랜스코딩 기능도 포함되어 있습니다. Intel, AMD, NVIDIA, Apple 엔진의 하드웨어 가속 지원 여부를 확인하며, 명시적으로 교체를 승인하지 않는 한 원본 파일은 그대로 유지됩니다.

핵심 기능

  • 01ffprobe로 미디어 파일을 분석하고 형식, 스트림, 자막 정보를 정규화
  • 02경로, 크기, 수정 시간을 기준으로 라이브러리 전체 및 증분 스캔
  • 03컬렉션 전체의 차트, 과거 데이터 분석, 품질 점수 제공
  • 04프로그램, 시즌, 보너스 콘텐츠 인식
  • 05glob 패턴 기반으로 파일과 폴더 제외
  • 06하드웨어 가속 지원 여부를 확인하고 원본을 보존하는 베타 FFmpeg 트랜스코딩

활용 사례

  • 대규모 홈 동영상 또는 음악 라이브러리의 코덱, 해상도, 자막 지원 현황 점검
  • 대상 기기에서 재생하기 전에 재인코딩이 필요한 파일 찾기
  • NAS 미디어 컬렉션의 시간에 따른 변화 추적
  • Docker 환경에서 네트워크 마운트 미디어를 읽기 전용으로 분석

빠른 시작

  1. 1

    예제 환경 파일을 복사합니다

    cp docker/env.example .env
  2. 2

    Docker Compose로 컨테이너를 빌드하고 시작합니다

    docker compose -f docker-compose-dev.yaml up --build
  3. 3

    브라우저에서 http://localhost:8080을 엽니다

사용 전 알아둘 점

  • AGPL-3.0 라이선스가 적용됩니다. 강한 카피레프트 라이선스로, 수정한 버전을 네트워크를 통해 제공하는 경우에도 적용됩니다.
  • 트랜스코딩은 아직 베타 버전입니다.
  • 기본 제공 인증 기능이 없습니다. 자체 인증 계층을 마련해야 합니다.

포함된 컬렉션

셀프 호스팅 앱

토픽

#media-library#ffprobe#ffmpeg#self-hosted#media-analysis#transcoding#docker#video-metadata

자주 묻는 질문

MediaLyze은(는) 무엇인가요?
ffprobe로 동영상·음악·오디오북 라이브러리를 스캔하고 웹 UI에서 기술 메타데이터를 보여주는 셀프 호스팅 도구입니다. MediaLyze는 로컬 동영상, 음악, 오디오북 컬렉션을 스캔하고 ffprobe로 파일을 분석해 형식, 스트림, 자막 정보를 정규화한 뒤 검색 가능한 라이브러리로 구성합니다. FastAPI와 React 기반 웹 인터페이스에서 차트, 과거 데이터 분석, 비교 보기, 컬렉션 전체의 품질 점수를 확인할 수 있습니다.
MediaLyze은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
MediaLyze은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
MediaLyze은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. MediaLyze의 마지막 커밋은 2026년 11월 6일입니다.
MediaLyze은(는) 어디에 사용할 수 있나요?
대규모 홈 동영상 또는 음악 라이브러리의 코덱, 해상도, 자막 지원 현황 점검 대상 기기에서 재생하기 전에 재인코딩이 필요한 파일 찾기 NAS 미디어 컬렉션의 시간에 따른 변화 추적 Docker 환경에서 네트워크 마운트 미디어를 읽기 전용으로 분석
MediaLyze는 어떻게 설치하나요?
예제 환경 파일을 복사합니다: cp docker/env.example .env Docker Compose로 컨테이너를 빌드하고 시작합니다: docker compose -f docker-compose-dev.yaml up --build 브라우저에서 http://localhost:8080을 엽니다
MediaLyze은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/frederikemmer/MediaLyze

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

관련 프로젝트