dengji85/avm

어떤 프로젝트인가요?

핵심 기능

• 01작품 코드를 표준화하고 파일 이름에서 자막, 무수정판, VR, 4K 표기를 감지합니다.
• 02JavBus, JavDB, AV-Wiki, 로컬 NFO 파일 등 플러그인형 소스에서 메타데이터를 가져옵니다.
• 03파일 크기와 콘텐츠 해시로 중복 파일을 감지하고 여러 버전의 사본을 그룹화합니다.
• 04브라우저에서 영상을 재생하고 VLC, PotPlayer, mpv 같은 외부 플레이어의 재생 진행 상황을 추적합니다.
• 05통계, 스마트 플레이리스트, 출연자 페이지, 연간 시청 보고서를 제공합니다.
• 06QR 코드로 로그인해 휴대폰과 태블릿에서 LAN으로 접속할 수 있습니다.

활용 사례

• 크고 어수선한 로컬 컬렉션을 하나의 탐색 가능한 라이브러리로 통합하기.
• 중복 사본을 정리하고 각 작품의 최적 버전을 보관하기.
• Docker로 NAS에서 실행하고 네트워크의 다른 기기에서 라이브러리에 접속하기.
• 시청 기록을 추적하고 시간에 따른 개인 시청 패턴을 살펴보기.

빠른 시작

1. 1

   Python 종속 항목을 설치합니다

   pip install -r requirements.txt
2. 2

   백엔드 서버를 시작합니다

   python run.py serve
3. 3

   프런트엔드 개발 서버를 설치하고 실행합니다(그런 다음 http://localhost:5173 을 엽니다)

   cd web_src && npm install && npm run dev

사용 전 알아둘 점

• !README에는 MIT 라이선스라고 명시되어 있지만 저장소 메타데이터에는 라이선스가 표시되어 있지 않으므로, 재사용하기 전에 조건을 확인하세요.
• !소스에서 실행하려면 Python과 Node.js가 모두 필요하며, Windows exe와 Docker를 이용하는 편이 더 간편합니다.
• !일부 스크래핑 소스는 로컬에 설치된 Chrome에서 가장 잘 작동하며, Chrome이 없으면 앱은 일반 요청 방식으로 대체합니다.

토픽

자주 묻는 질문

avm은(는) 무엇인가요?

개인 AV 영상 컬렉션을 정리하고 메타데이터를 수집해 재생하는 로컬 우선 미디어 라이브러리 관리자 AVM (Adult Video Manager)은 여기저기 흩어진 성인 영상 파일을 검색 가능한 로컬 라이브러리로 정리해 주는 셀프 호스팅 웹 앱입니다. 작품 코드를 표준화하고 샘플 및 예고편을 건너뛰며 디렉터리를 스캔합니다. 또한 JavBus, JavDB, AV-Wiki 같은 플러그인형 소스와 로컬 .nfo 파일에서 커버, 출연자, 장르, 시리즈, 평점 정보를 가져옵니다.

avm은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

avm에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.

avm은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. avm의 마지막 커밋은 2026년 10월 18일입니다.

avm은(는) 어디에 사용할 수 있나요?

크고 어수선한 로컬 컬렉션을 하나의 탐색 가능한 라이브러리로 통합하기. 중복 사본을 정리하고 각 작품의 최적 버전을 보관하기. Docker로 NAS에서 실행하고 네트워크의 다른 기기에서 라이브러리에 접속하기. 시청 기록을 추적하고 시간에 따른 개인 시청 패턴을 살펴보기.

avm는 어떻게 설치하나요?

Python 종속 항목을 설치합니다: pip install -r requirements.txt 백엔드 서버를 시작합니다: python run.py serve 프런트엔드 개발 서버를 설치하고 실행합니다(그런 다음 http://localhost:5173 을 엽니다): cd web_src && npm install && npm run dev

avm은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dengji85/avm