홈 Home
홈Home/프로그램Programs/Img2HtmlImg2Html

Img2Html v0.145

이미지 폴더를 웹뷰 이미지 갤러리로 볼 수 있습니다.

Turns an image folder into an HTML gallery you can browse directly in a web browser

버전Version0.145
업데이트Updated2025-04-22
크기Size418 KB
요구 사항RequiresWindows 10 이상 · 브라우저(Chrome/Edge) 필요Windows 10 or later · a browser (Chrome/Edge) is required
다운로드Download · Img2Html_v0.145.zip 압축 비밀번호Password: techbard

릴리스 노트Release notes

v0.145 2025-04-22 공개 릴리스 Public release 다운로드Download

콘솔 화면Console

Img2Html0.145
Img2Html v0.145 - 이미지 폴더를 HTML 갤러리로 변환
빌드: 2026-09-26  techbard@naver.com

감지된 언어: ko

활성 설정:
  --src: C:\Data\Photos
  --out: index
  --ext: png, jpg, jpeg
  --per-page: 10
  --report-theme: dark
  --title: 이미지 갤러리

[00:00:01] 하위 디렉토리 이미지 파일 검색을 시작합니다...
[00:00:01] 스캔: C:\Data\Photos
[00:00:01] 스캔: C:\Data\Photos\2024
[00:00:02] 스캔: C:\Data\Photos\2025
[00:00:02] 검색 완료. 총 발견된 파일 수: 128
[00:00:02] 확장자 통계: .jpg 96, .png 32
[00:00:02] 페이지네이션: 13 페이지 생성 (페이지당 10 개 이미지)
[00:00:02] HTML 파일 생성을 시작합니다...
[00:00:03] [성공] HTML 갤러리가 성공적으로 생성되었습니다: C:\Data\Photos\index.html

종료하려면 [Enter] 키를 누르세요...

화면 구성Screen layout

Img2Html - HTML 갤러리 생성기 소스 디렉토리 C:\Data\Photos ... 출력 파일명 index .html 이미지 확장자 png, jpg, jpeg 썸네일 크기 100 px 100 이미지 개수 10 개 10 페이지 제목 이미지 갤러리 테마/배경 테마 light 배경 코드 #FFFFFF 언어 (Lang.) auto 도움말 HTML 열기 생성
01 / 1
1 / 1

사용법Guide

이미지 폴더를 고르면 그 폴더 이미지를 호출하는 HTML 갤러리가 만들어집니다. 만든 파일은 브라우저로 열립니다.


주요 기능

  • 이미지를 누르면 원본 크기로 봅니다.
  • 페이지 단위로 나눠서 봅니다.
  • 파일 이름으로 검색합니다.

별도 프로그램은 필요 없고 Chrome이나 Edge 같은 브라우저만 있으면 됩니다.


CLI 버전

프로그램이 실행된 하위 폴더 전체의 이미지 파일을 탐색해 html 생성 합니다.


GUI 버전

폴더를 직접 고르고 설정을 바꿔서 만듭니다.

  1. img2html-gui.exe를 실행합니다.
  2. 소스 디렉토리 옆의 ... 버튼을 누르고 이미지가 있는 폴더를 고릅니다.
  3. 기본 설정을 그대로 사용하거나 설정을 변경 합니다.
  4. 생성을 누릅니다.
    • 끝나면 HTML 열기가 켜집니다.
  5. HTML 열기로 브라우저에서 갤러리를 봅니다.

설정 항목

설정기본값설명
소스 디렉토리-이미지가 있는 폴더를 고릅니다.
출력 파일명index만들 HTML 파일 이름입니다. .html은 자동으로 붙습니다.
이미지 확장자-넣을 확장자를 쉼표로 구분합니다. 예: png, jpg, jpeg
썸네일 크기100 px갤러리에 보이는 썸네일 크기입니다. 크면 미리보기도 커집니다.
페이지당 이미지 수10한 페이지에 보여 주는 이미지 수입니다.
페이지 제목Image Gallery브라우저 탭에 나오는 제목입니다.
테마-배경 스타일입니다. light는 밝은 배경, dark는 어두운 배경, none은 BG 코드 색을 그대로 씁니다.
BG 코드-none 테마에서 쓰는 배경색입니다. #RRGGBB 형식입니다. 예: #FFFFFF
언어auto인터페이스 언어입니다. auto는 시스템 언어, ko는 한국어, en는 영어입니다.

자주 하는 실수

확장자는 쉼표로만 구분합니다. 앞의 점(.)은 넣지 않습니다.

  • 예: jpg, png
  • 틀림: .jpg, .png

출력 파일명에는 .html을 넣지 않습니다. 자동으로 붙습니다.

갤러리에 이미지가 보이지 않으면 이미지 확장자 항목에 그 확장자가 있는지 봅니다.

설정은 자동으로 저장되고 다음 실행 때 복원됩니다.


Windows 보안 경고

img2html-gui.exe는 코드 서명이 없어서 처음 실행할 때 Windows가 "알 수 없는 앱" 경고를 표시합니다.

방법 1 - 실행 전에 차단 해제 (권장)

  1. img2html-gui.exe를 마우스 오른쪽 클릭하고 속성을 누릅니다.
  2. 아래쪽 보안 항목에서 "차단 해제"를 체크합니다.
  3. 확인을 누른 뒤 다시 실행합니다.

방법 2 - 경고 화면에서 계속 진행

  1. "Windows가 PC를 보호했습니다" 화면에서 "더 보기"를 누릅니다.
  2. 나타나는 "실행 Anyway" 버튼을 누릅니다.

콘솔 프로그램인 img2html.exe는 이 경고가 나오지 않습니다.


문의

JAEMUN, SHIN 제작
문의: techbard@naver.com

문의, 버그 리포트, 개선 아이디어는 위 이메일로 보내 주세요. 모든 권리 보유. 무단 복제나 재배포를 금지합니다. 이 프로그램은 MIT 라이선스 오픈소스 구성 요소를 포함합니다. 자세한 내용은 LICENSE 파일을 확인하세요.

Turns an image folder into an HTML gallery you can browse directly in a web browser. No installation required - just select a folder.


What You Get

Run img2html-gui.exe, select your image folder, and an index.html file is created inside that folder. Open it in any web browser and a thumbnail gallery appears.

  • Click an image to view it full size.
  • Navigate through pages.
  • Search by filename.

No heavy software to install - any browser such as Chrome or Edge is all you need.


CLI Version

Run from command line and it automatically generates an HTML file in the current directory.

  • Automatically generates HTML where you run the command
  • Web pages include file search functionality
  • Slideshow available (press Space to start/stop)

Get Started in 5 Minutes

  1. Run img2html-gui.exe.
  2. Click the [Browse] button next to Source Directory and select the folder containing your images.
  3. The default settings work as-is. Change only what you need.
  4. Click the [Generate] button.
    • When complete, the [Open HTML] button becomes active.
  5. Click [Open HTML] to view the gallery in your browser.

Settings Reference

SettingDefaultDescription
Source Directory-Select the folder that contains the images you want to include.
Output FilenameindexName of the HTML file to generate. .html is appended automatically.
Image Extensions-File extensions to include, separated by commas. Example: png, jpg, jpeg
Thumbnail Size100 pxSize of the preview thumbnails shown in the gallery. Larger values show bigger previews.
Images per Page10Number of images shown per page. Useful for browsing large collections quickly.
Page TitleImage GalleryTitle displayed in the browser tab.
Theme-Background style. light = light background, dark = dark background, none = no theme preset; uses the color entered in the BG Code field instead
BG Code-Custom background color when not using a theme preset. Format: #RRGGBB (e.g. #FFFFFF)
LanguageautoInterface language. auto = detect system language, ko = Korean, en = English

Common Mistakes

  • Do not include a dot (.) when entering extensions.
    • Correct: jpg, png
    • Incorrect: .jpg, .png
  • Do not add .html to the output filename. It is added automatically.
  • If images do not appear in the gallery, check that their extension is listed in the Image Extensions field.
  • Settings are saved automatically. Your configuration is restored the next time you run the program.

Why does Windows show a security warning when I run the program?

img2html-gui.exe is not code-signed, which means Windows may display an "Unknown app" warning the first time you run it.

Option 1 - Unblock the file before running (recommended)

  1. Right-click img2html-gui.exe and select Properties.
  2. At the bottom, check "Unblock" under the Security section.
  3. Click OK, then run the program normally.

Option 2 - Proceed from the warning screen

  1. On the "Windows protected your PC" screen, click "More info".
  2. Click the "Run anyway" button that appears.

img2html.exe (the console program) runs without this warning.


Contact

Created by JAEMUN, SHIN Contact: techbard@naver.com

For questions, bug reports, or improvement suggestions, please reach out to the email above. All rights reserved. Unauthorized copying or redistribution is prohibited. This program includes open-source components licensed under the MIT License. See the LICENSE file for details.

다운로드Download

Img2Html_v0.145.zip 압축 비밀번호Password: techbard ← 프로그램Programs