image

OneFile Album

Bundle local images and a responsive viewer into one portable, self-contained HTML album.

Local processing

About your filesFiles and content selected in this tool are processed in your browser and are not uploaded to a Browser Kitty backend.

Operation demo See the basic workflow in a short video.

About this tool

OneFile Album combines multiple JPEG, PNG, or WebP images with a responsive viewer in one self-contained HTML file. The finished file opens directly without a server or dedicated app, so an entire photo set can be stored or shared as a single file that already includes its browsing interface.

Images can be embedded as their original bytes or converted to WebP to reduce file size. The editor includes sorting by capture time or filename, drag reordering, chapters, comments, final preview, and the ability to reopen a previously generated OneFile Album for further editing. Selected images are not uploaded to an external server.

Good for

Keep travel, event, project, or inspection photos in one easy-to-open file
Share a photo collection without distributing a separate image folder and viewer
Organize photos with chapters and comments while including slideshow and search
Create a portable photo album locally without uploading the source images to a cloud service

What it can do

Key capabilities available in this tool.

Bundle JPEG, PNG, and WebP images with a viewer into a single HTML file
Choose between preserving original image bytes or reducing size with WebP
Auto-sort by capture time or filename and reorder images by drag and drop
Organize albums with chapter breaks, per-image comments, and collapsible chapters
Reopen a previously generated OneFile Album and continue editing it
Use an included viewer with swipe, zoom, full-screen, slideshow, and search

How to use

Open the tool and add JPEG, PNG, or WebP images with the file picker or drag and drop.
If needed, choose whether to keep the original image bytes or reduce size with WebP and review the before/after size estimate.
Auto-sort by capture time or filename, drag cards into order, and add chapter breaks or comments when useful.
Adjust the album title and viewer settings, then inspect the finished layout in the final preview.
Review the estimated size and generate the HTML file. To edit later, reopen the generated OneFile Album from the first step of the editor.

Supported

Inputs can be JPEG, PNG, or WebP, and the output is a single HTML file containing both image data and the viewer.
Original mode embeds the full image bytes without re-encoding, while WebP reduction uses the browser's image decoder and Canvas API.
The generated viewer includes thumbnails, previous/next navigation, swipe, zoom, full-screen, slideshow, search, display settings, and saving of the currently embedded image.
Generated OneFile Album files contain compatible editing data so images, chapters, comments, and settings can be restored for later editing.

Limitations and notes

Because image data is embedded inside the HTML file, the generated file grows with image count, resolution, and source size.
There is no universal hard limit, but the app recommends splitting albums when the estimated output exceeds about 250 MB.
Generating, reopening, or viewing very large albums can become heavy depending on device memory and browser implementation.
WebP reduction re-encodes images, so preservation of source metadata such as EXIF or GPS is not guaranteed.
Original-byte mode preserves source bytes and therefore can also preserve embedded metadata, so review location or other private metadata before sharing.

Frequently asked questions

Are photos uploaded to a server?

No. Loading images, WebP conversion, reordering, chapter and comment editing, previewing, and HTML generation are handled locally on the device.

Can the generated HTML be opened without OneFile Album?

Yes. The generated HTML contains the images and viewer, so the single file can be opened directly in a modern browser.

Can I edit a generated album later?

Yes. A compatible OneFile Album HTML can be reopened to restore its images, chapters, comments, title, favicon, viewer settings, and related editing state.

How many images can I include?

There is no fixed image-count limit; practical capacity depends on device memory, image resolution, and output size. Use WebP reduction or split the collection when the estimate becomes large.

Offline version and source code

Both the editor and generated albums are self-contained HTML files with no runtime network communication. A generated album can be viewed directly from file:// without a local web server.

View source on GitHub