🎬 Gemini Video Manager (GM)

무료 3개월 구독으로 만나게 된 Gemini 프로 모델과 함께 만든 비디오 라이브러리 관리 도구입니다.

"평소 자주 쓰던 프로그램과 비슷한 걸 직접 만들 수 있을까?"라는 호기심에서 시작했는데,

AI와의 협업을 통해 기대 이상의 성능과 편의성을 갖추게 되어 깃허브에 공개하게 되었습니다.

특히 1,000개에 가까운 영상 리스트를 불러올 때의 렉을 해결하고, 사용자 편의를 위한

스마트 태그 시스템(수동)을 구축하는 데 집중했습니다.

✨ 주요 기능

• 초고속 로딩 (Lazy Loading): 수천 개의 영상이 있어도 시작 시 프리징 없이 즉각 실행됩니다. 배경에서 위젯을 순차적으로 생성합니다.
• 스마트 태그 시스템: 체크박스 없는 원클릭 토글 방식으로 여러 태그를 조합하여 실시간 필터링이 가능합니다.
• 8단계 썸네일 추출: 영상마다 8개의 프레임을 자동 추출하며, 마우스 오버 시 라이브 미리보기를 지원합니다.
• 정교한 검색: 파일 이름은 물론, 전체 파일 경로(예: D:\Movies)를 기준으로 실시간 검색을 지원합니다.
• 별점 및 정렬: 0.5단위 별점 시스템과 등록순, 제목순, 크기순 정렬 기능을 제공합니다.
• 외부 플레이어 연동: 기본 연결 프로그램 외에 원하는 특정 플레이어(팟플레이어 등)를 지정하여 재생할 수 있습니다.
• 상태 표시: 현재 필터링된 영상 개수와 선택된 파일 개수를 하단 바에 실시간으로 표시합니다.

🚀 설치 방법

1. Python 설치: Python 3.8 버전 이상이 필요합니다.
2. 필수 라이브러리 설치:

   pip install PyQt5
   pip install opencv-python

3. 실행:

   python main.pyw
   

🛠 사용 팁

• 태그/그룹 추가: 좌측 메뉴의 + 버튼을 누르세요.
• 태그 지정: 영상 선택 후 영상을 태그에 드롭하여 태그를 지정 할 수 있습니다.
• 이름 수정: 그룹이나 태그를 더블클릭하면 이름을 변경할 수 있습니다.
• 다중 태그 검색: 여러 태그를 클릭하면 해당 태그를 모두 포함한 영상만 필터링됩니다.
• 단축키:
  • Ctrl + F: 검색창 포커스
  • F2: 선택된 영상 상세 정보 수정
  • Shift + Del: 목록에서 제거

---

✍️ 개발 소회

"AI가 코드를 짜주는 것을 넘어, 성능 최적화 아이디어를 제안하고 버그를 함께 잡아가는 과정이 매우 인상적이었습니다.

특히 대용량 데이터를 다룰 때의 UI 프리징 문제를 해결해 나가는 과정에서 Gemini 프로 모델의 논리적인 추론 능력이 큰 도움이 되었습니다.

부족한 점이 많지만 필요한 분들께 도움이 되길 바랍니다."

---

GeminiVideoManager is a fast and lightweight local video management tool built with PyQt5. It automatically captures specific segments of your videos to generate 12 distinct thumbnails. With an intuitive UI, you can easily assign and filter videos by tags, actors, groups, and ratings. It is designed for those who want to quickly search and seamlessly categorize large collections of video files based on custom conditions.

---