Repolode
GhostPeony

GhostPeony/clip-finder

YouTube 자막을 의미 기반으로 검색해 채널, 재생목록, 동영상에서 원하는 시점으로 바로 이동

스타
55
포크
6
열린 이슈
0
마지막 커밋
4개월 전

어떤 프로젝트인가요?

SearchTube는 채널, 재생목록 또는 단일 동영상의 YouTube 자막을 색인한 뒤, 정확한 키워드가 아니라 의미를 기준으로 검색할 수 있게 해줍니다. 각 검색 결과는 해당 동영상의 일치하는 시점으로 연결되므로, 관련 클립으로 바로 이동할 수 있습니다.

두 가지 모드로 실행됩니다. 로컬 모드에서는 로그인할 필요가 없고 벡터를 로컬 ChromaDB 디렉터리에 저장하며, Gemini 키는 브라우저에서 직접 입력합니다. Supabase 모드에서는 사용자 인증, pgvector를 사용하는 Postgres, 사용량 할당량, 서버에서 관리하는 Gemini 키를 지원하며, 사용자별 키를 선택적으로 암호화해 저장할 수도 있습니다.

React 프론트엔드와 FastAPI 백엔드로 구성되며, 검색에는 Gemini 임베딩을 사용합니다. 기본값을 변경하기 전에 임베딩 모델과 차원을 비교할 수 있는 평가 스크립트도 포함되어 있습니다.

핵심 기능

  • 01타임스탬프 링크를 제공하는 YouTube 자막 의미 기반 검색
  • 02채널, 재생목록 및 단일 동영상 색인
  • 03이미 색인된 동영상은 건너뜀
  • 04인증이 필요 없는 로컬 모드 또는 다중 사용자 로그인을 지원하는 Supabase 모드
  • 05브라우저에서 직접 키를 입력하거나 서버 측에 키를 암호화해 저장
  • 06SRT 형식 자막 다운로드 및 최근 검색 기록

활용 사례

  • 긴 강의 시리즈나 튜토리얼 채널에서 특정 설명 찾기
  • 모든 동영상을 시청하지 않고 재생목록 전체에서 주제 검색
  • 팀 또는 개인 아카이브를 위한 비공개 셀프 호스팅 자막 검색 운영

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/GhostPeony/SearchTube.git
  2. 2

    Python 가상 환경을 만들고 백엔드 종속성을 설치합니다

    python -m venv venv venv\Scripts\activate pip install -r requirements.txt
  3. 3

    프런트엔드 종속성을 설치한 다음 Gemini API 키를 입력한 .env.local 파일을 만듭니다

    npm install
  4. 4

    한 터미널에서 백엔드를 시작하고 다른 터미널에서 프런트엔드를 시작한 다음 http://localhost:3001 을 엽니다

    python backend/server.py npm run dev

사용 전 알아둘 점

  • 로컬 모드에서 임베딩과 검색을 사용하려면 Gemini API 키가 필요합니다.
  • 설정 안내에는 Windows 전용 venv 활성화 명령이 사용됩니다. 다른 플랫폼에서는 별도의 활성화 명령이 필요합니다.
  • 자막이 없거나 지역 또는 연령 제한이 있는 동영상은 스크립트를 사용할 수 없습니다.

토픽

자주 묻는 질문

clip-finder은(는) 무엇인가요?
YouTube 자막을 의미 기반으로 검색해 채널, 재생목록, 동영상에서 원하는 시점으로 바로 이동 SearchTube는 채널, 재생목록 또는 단일 동영상의 YouTube 자막을 색인한 뒤, 정확한 키워드가 아니라 의미를 기준으로 검색할 수 있게 해줍니다. 각 검색 결과는 해당 동영상의 일치하는 시점으로 연결되므로, 관련 클립으로 바로 이동할 수 있습니다.
clip-finder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
clip-finder은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
clip-finder은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. clip-finder의 마지막 커밋은 2026년 7월 2일입니다.
clip-finder은(는) 어디에 사용할 수 있나요?
긴 강의 시리즈나 튜토리얼 채널에서 특정 설명 찾기 모든 동영상을 시청하지 않고 재생목록 전체에서 주제 검색 팀 또는 개인 아카이브를 위한 비공개 셀프 호스팅 자막 검색 운영
clip-finder는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/GhostPeony/SearchTube.git Python 가상 환경을 만들고 백엔드 종속성을 설치합니다: python -m venv venv venv\Scripts\activate pip install -r requirements.txt 프런트엔드 종속성을 설치한 다음 Gemini API 키를 입력한 .env.local 파일을 만듭니다: npm install 한 터미널에서 백엔드를 시작하고 다른 터미널에서 프런트엔드를 시작한 다음 http://localhost:3001 을 엽니다: python backend/server.py npm run dev
clip-finder은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/GhostPeony/clip-finder

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

관련 프로젝트