👋 H-GALLERY 소개

반갑습니다! H-GALLERY는 복잡한 프로그램 설치 없이 웹 브라우저만 있으면 어디서든 사용할 수 있는 차세대 웹 이미지 뷰어입니다. 사용자의 개인정보와 파일 보안을 최우선으로 생각하여, 모든 이미지 처리는 서버가 아닌 사용자의 PC(로컬)에서만 이루어집니다.

이제 느리고 무거운 뷰어 대신, 가볍고 빠른 H-GALLERY로 쾌적한 감상 환경을 경험해보세요.

🚀 왜 H-GALLERY 인가요?

🔒 완벽한 보안 (Client-Side) 서버로 이미지를 전송하지 않습니다. 오직 귀하의 브라우저 안에서만 작동하여 해킹이나 유출 걱정이 없습니다.
⚡ 압도적인 속도 (Super Fast) 수백 장의 고화질 이미지도 기다림 없이 즉시 로딩됩니다. IndexedDB 기술을 활용한 썸네일 캐싱을 지원합니다.
📂 편리한 폴더 관리 (Folder View) 파일을 일일이 선택할 필요가 없습니다. 폴더를 통째로 드래그하면 하위 폴더까지 자동으로 인식합니다.
💾 스마트한 기능 (Utility) 자동 재생(슬라이드쇼), 이어보기(히스토리), ZIP 썸네일 다운로드 등 꼭 필요한 편의 기능을 제공합니다.

💡 바로 시작하는 방법

원하는 이미지 폴더를 선택합니다.

화면 왼쪽의 드롭 영역(DROP ZONE)으로 폴더를 끌어다 놓으세요.

자동으로 뷰어가 실행되며, 화살표 키(←, →)로 감상하시면 됩니다.

📚 최근 본 폴더

아직 본 폴더가 없습니다.
좌측에 폴더를 드래그해주세요.

웹 이미지 뷰어 & 갤러리 관리 도구

hgall은 별도의 프로그램 설치 없이 웹브라우저에서 대용량 이미지 폴더를 빠르게 열람하고 관리할 수 있는 무료 웹 이미지 뷰어입니다. 사용자의 PC에 있는 이미지를 서버로 전송하지 않고, 브라우저 내에서 로컬 처리하므로 개인정보 유출 걱정 없이 안전하게 사용할 수 있습니다.

주요 기능

강력한 보안: 모든 파일은 사용자 컴퓨터(로컬)에서만 처리되며 서버에 업로드되지 않습니다.
폴더 구조 유지: 드래그 앤 드롭으로 폴더째 업로드하여 이미지를 연속으로 감상할 수 있습니다.
편리한 기능: 자동 재생(슬라이드쇼), 전체 화면 모드, 썸네일 그리드 뷰를 지원합니다.
최근 경로 기억: 크롬 브라우저 사용 시, 마지막으로 열었던 폴더 경로를 기억하여 빠르게 다시 열 수 있습니다.
썸네일 다운로드: 대량의 이미지 썸네일을 생성하여 ZIP 파일로 한 번에 다운로드할 수 있습니다.

사용 방법

1. PC에 저장된 이미지 폴더를 화면 중앙의 드롭 영역으로 드래그 앤 드롭하세요.
2. 또는 '폴더 열기' 버튼을 클릭하여 이미지가 포함된 폴더를 선택합니다.
3. 화살표 키(←, →)를 사용하여 이미지를 탐색하거나 스페이스바를 눌러 자동 재생을 시작하세요.
4. 이미지 확대가능.

자주 묻는 질문 (FAQ)

Q. 이미지가 서버에 저장되나요?
A. 아니요. hgall은 100% 클라이언트 사이드에서 작동합니다. 귀하의 사진은 인터넷을 통해 전송되지 않습니다.

Q. 지원하는 이미지 형식은 무엇인가요?
A. JPG, PNG, WEBP, GIF, AVIF, BMP, MP4, WEBM 등 최신 웹 브라우저가 지원하는 대부분의 이미지 및 동영상 형식을 지원합니다.

웹 이미지 포맷 완벽 가이드

디지털 이미지의 세계는 빠르게 진화하고 있습니다. H-GALLERY는 최신 웹 표준을 준수하며 다음과 같은 고효율 이미지 포맷을 완벽하게 지원합니다.

WebP (웹피): 구글이 개발한 차세대 이미지 포맷으로, 기존 JPG 대비 30% 이상 파일 크기가 작으면서도 동등한 화질을 제공합니다. 특히 투명도(Alpha Channel)를 지원하여 PNG를 대체할 수 있는 강력한 포맷입니다.
AVIF (AV1 Image File Format): 최신 압축 기술인 AV1 코덱을 기반으로 한 포맷입니다. WebP보다 더 높은 압축률을 자랑하며, HDR(High Dynamic Range) 색상을 지원하여 더욱 생생한 이미지를 표현할 수 있습니다.
JPG / PNG: 가장 범용적인 포맷들도 당연히 지원합니다. 특히 사진에는 JPG, 그래픽이나 로고에는 PNG가 적합합니다. H-GALLERY는 이러한 전통적인 포맷의 렌더링 속도도 최적화하였습니다.

웹 기반 뷰어의 보안 구조

많은 사용자들이 "내 사진이 서버에 올라가는 것은 아닐까?" 걱정합니다. H-GALLERY는 기술적으로 이를 원천 차단했습니다. 본 서비스는 FileSystem Access API라는 최신 웹 기술을 사용하여, 브라우저가 사용자 허락 하에 로컬 파일에 직접 접근하는 방식입니다.

즉, "업로드"라는 과정이 존재하지 않습니다. 파일 데이터는 인터넷 망을 타지 않고, 오직 귀하의 컴퓨터 메모리(RAM)와 그래픽 카드(GPU) 사이에서만 이동합니다. 인터넷 연결을 끊은 상태에서도 완벽하게 작동하는 것이 그 증거입니다.

문제 해결 가이드

Q. 폴더를 열었는데 이미지가 안 보여요.
A. 해당 폴더에 지원하지 않는 파일(예: raw, psd 등)만 있거나 빈 폴더일 수 있습니다. JPG, PNG, WEBP 등의 파일이 있는지 확인해주세요.

Q. "권한 요청" 팝업이 뜹니다.
A. 이는 브라우저의 보안 정책입니다. 웹사이트가 PC의 파일에 접근하려면 반드시 사용자의 승인이 필요합니다. '허용'을 누르시면 정상적으로 작동합니다.

📘 프로젝트 상세 정보 (README)

📝 소개 (Introduction)

hgall은 대용량 이미지 폴더를 웹 브라우저에서 간편하게 열람하고 관리할 수 있는 웹 기반 이미지 뷰어입니다.
사용자의 편의를 최우선으로 고려하여 드래그 앤 드롭, 키보드 탐색, 자동 재생 등 다양한 기능을 제공합니다.
특히, 서버 업로드 없이 브라우저 자체적으로 파일을 처리하여 속도가 빠르고 보안이 강력합니다.

✨ 주요 기능 (Features)

📁 폴더 단위 업로드: 폴더를 드래그하거나 선택하여 내부의 모든 이미지를 한 번에 불러옵니다.
💾 경로 기억 (History): IndexedDB 및 FileSystem Access API를 활용하여 최근 열었던 폴더 권한을 기억하고, 재방문 시 원클릭으로 다시 엽니다. (Chrome 권장)
⚡ 고성능 썸네일: 대량의 이미지도 끊김 없이 확인할 수 있도록 비동기 방식으로 썸네일을 생성하고 캐싱합니다.
📦 ZIP 다운로드: 생성된 썸네일들을 JSZip 라이브러리를 통해 하나의 압축 파일로 다운로드할 수 있습니다.
🎮 편리한 조작: 화살표 키로 이동, 스페이스바로 슬라이드쇼, 휠로 줌인/줌아웃을 지원합니다.
📱 반응형 디자인: PC, 태블릿, 모바일 등 다양한 해상도 환경을 지원합니다.

💬 의견 남기기 (Comments)

버그 제보, 기능 요청, 또는 응원의 한마디를 남겨주세요. (GitHub 계정 필요)