xemle/home-gallery

어떤 프로젝트인가요?

핵심 기능

• 01가상 스크롤을 지원하는 끊임없이 이어지는 사진 스트림
• 02단일 및 다중 선택 태그 지정
• 03유사 이미지 검색 및 얼굴 검색
• 04동영상 트랜스코딩 및 Chromecast 스트리밍
• 05GPS 위치 역조회
• 06콘텐츠 기반 중복 제거 및 빠른 변경 감지
• 07XMP 사이드카 파일 및 정적 사이트로 내보내기

활용 사례

• 집의 NAS에 저장된 가족 사진 보관함을 휴대폰으로 둘러보기
• 수동으로 태그를 지정하지 않고 개인 사진 라이브러리에서 비슷한 노을 사진이나 음식 사진 찾기
• 한 번 색인한 뒤 오프라인 또는 읽기 전용 외장 드라이브의 미디어 제공하기
• 사진 컬렉션의 정적 스냅샷 게시하기

빠른 시작

1. 1

   미리 빌드된 바이너리를 다운로드합니다

   curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery
2. 2

   바이너리에 실행 권한을 부여합니다

   chmod 755 gallery
3. 3

   미디어 소스를 지정해 설정을 초기화합니다

   ./gallery init --source ~/Pictures
4. 4

   서버를 시작한 다음 localhost:3000을 엽니다

   ./gallery run server

사용 전 알아둘 점

• !미디어 데이터베이스 전체를 브라우저에 로드하므로 라이브러리가 매우 크면 성능이 저하될 수 있습니다.
• !객체 감지와 얼굴 인식은 기본적으로 프로젝트의 공개 API를 사용하므로 로컬에서 실행하지 않으면 미리보기 이미지가 기기 외부로 전송됩니다.
• !프로젝트는 보증이 없는 개인 여가 시간 프로젝트라고 설명하고 있습니다.

토픽

자주 묻는 질문

home-gallery은(는) 무엇인가요?

태그 지정과 모바일 UI, 유사 이미지 및 얼굴 검색을 지원하는 셀프 호스팅 웹 갤러리 HomeGallery는 개인 사진과 동영상을 둘러볼 수 있는 셀프 호스팅 웹 갤러리입니다. 개인 컴퓨터나 NAS에서 실행하도록 설계되었으며, 하나 이상의 로컬 소스 디렉터리에서 미디어를 색인하므로 원본을 클라우드 서비스에 제공할 필요가 없습니다.

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

home-gallery은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

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

활발히 유지보수 중. home-gallery의 마지막 커밋은 2026년 10월 13일입니다.

home-gallery은(는) 어디에 사용할 수 있나요?

집의 NAS에 저장된 가족 사진 보관함을 휴대폰으로 둘러보기 수동으로 태그를 지정하지 않고 개인 사진 라이브러리에서 비슷한 노을 사진이나 음식 사진 찾기 한 번 색인한 뒤 오프라인 또는 읽기 전용 외장 드라이브의 미디어 제공하기 사진 컬렉션의 정적 스냅샷 게시하기

home-gallery는 어떻게 설치하나요?

미리 빌드된 바이너리를 다운로드합니다: curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery 바이너리에 실행 권한을 부여합니다: chmod 755 gallery 미디어 소스를 지정해 설정을 초기화합니다: ./gallery init --source ~/Pictures 서버를 시작한 다음 localhost:3000을 엽니다: ./gallery run server

home-gallery은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/xemle/home-gallery