Img2Html - HTML Gallery Generator
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
- Run
img2html-gui.exe. - Click the [Browse] button next to Source Directory and select the folder containing your images.
- The default settings work as-is. Change only what you need.
- Click the [Generate] button.
- When complete, the [Open HTML] button becomes active.
- Click [Open HTML] to view the gallery in your browser.
Settings Reference
| Setting | Default | Description |
|---|---|---|
| Source Directory | - | Select the folder that contains the images you want to include. |
| Output Filename | index |
Name of the HTML file to generate. .html is appended
automatically. |
| Image Extensions | - | File extensions to include, separated by commas. Example:
png, jpg, jpeg |
| Thumbnail Size | 100 px |
Size of the preview thumbnails shown in the gallery. Larger values show bigger previews. |
| Images per Page | 10 |
Number of images shown per page. Useful for browsing large collections quickly. |
| Page Title | Image Gallery |
Title 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) |
| Language | auto |
Interface 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
- Correct:
- Do not add
.htmlto 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.