create-photo-flipbook-ui README

The project's README from github.com/HaichaoLihc/create-photo-flipbook-ui. As one markdown file: README.md.

Create Photo Flipbook UI

A Codex skill for turning photographs into expressive photobooks using the bundled 2D Book runtime (formerly v1) in assets/html/.

3D Book 2 demo

Templates

These templates live in examples/, outside the skill folder, and are optional resources for people to copy and customize. They are not installed with the skill. The skill uses its own bundled 2D runtime; Library and the 3D templates are separate alternatives.

Library 2D Book
Library with three mock books 2D Book with a sample photo spread
Reorderable shelf with three empty mock books. Reference example of the skill’s bundled 2D runtime.
3D Book 1 3D Book 2
3D Book 1 on a dark background 3D Book 2 on a light background
React and WebGL reader with curved pages and a dark stage. Three.js and Quick FlipBook reader with a light stage and soft shadows.

Install

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo HaichaoLihc/create-photo-flipbook-ui \
  --path skills/create-photo-flipbook-ui \
  --ref main

Use

Use $create-photo-flipbook-ui to turn these photographs into photobooks.

One workflow, three stages:

  1. Understand the photos: their form, content, and themes. Semantic search and contact sheets are available.
  2. Define the style and design: fulfill the user's request with a coherent, high-quality book. Pinterest, the photo-skill catalogue, and image generation are available. Without a preferred style, preserve the original photos and use the bundled default photobook style.
  3. Build the UI: present the book with the built-in 2D HTML runtime and deliver a working local URL.

The skill defines outcomes and provides tools. The agent chooses the process.

The default photobook style provides concise text guidance, Source Serif 4, paper and cloth textures, and reusable page styles in the bundled runtime. The starter contains no sample photographs.

Photo search and reusable code

The skill declares the existing photo-search MCP dependency for library search, ranked contact sheets, and larger previews. The MCP itself is read-only. The bundled scripts/photo_library.py adapter adds folder-specific cached indexes and semantic searches by reusing an installed photo-search engine's index.py and PhotoSearchEngine; it does not replace the connected MCP's global index.

Install the engine and its Python requirements separately, set PHOTO_SEARCH_ENGINE_DIR to its location, and use its Python interpreter. See Photo library setup and commands. Index caches remain outside the skill and source folders. New and changed images are embedded incrementally; unchanged images are reused. Search output includes a contact sheet and manifest, and selections retain stable IDs and original paths.

Reusable resources shipped with the skill include the photo-library adapter, ordered contact-sheet renderer, Pinterest helper, and 2D book runtime. Art direction and sequencing remain in workflow instructions. Model weights and photo libraries are not part of the skill package.

See each template’s README for local preview instructions.

Negative Sleeves is a separate, photo-free film archive UI with page-corner previews and draggable film strips. Import a local photo folder with its Python builder; generated books and photographs stay Git-ignored.

Validate

python3 tests/validate_repo.py

Evaluation guide.

License

Original project code and the installable skill are MIT licensed. Third-party components retain their own licenses. The adapted code in examples/3d-book-1/ and all photographs, videos, and other media are excluded unless expressly stated otherwise.

create-photo-flipbook-ui (HaichaoLihc/create-photo-flipbook-ui)

Searching Database…

530 ·GitHub
Create-photo-flipbook-ui
这是什么？这是一个 Codex 技能，能把一个用户照片文件夹变成一个可用的照片书网站，使用内置的 2D HTML 翻页书运行时，外加可选的 3D Three.js/WebGL 模板示例。
这是独立应用，还是由 AI 智能体替我运行的东西？它是 Codex 智能体技能，不是独立应用：Codex 把它当作一套工具来分析你的照片并生成本地翻页书网站，在内置的 2D 运行时和独立的 3D React/Three.js 示例模板之间做选择。
怎么让它跑起来？把技能包安装到你的 Codex skills 目录，让智能体能够调用它；examples/ 下的模板是可选的，需要单独复制，因为它们不随技能一起安装。
要让照片搜索可用，还需要额外装什么吗？语义搜索和缩略图索引依赖已有的 photo-search MCP；自带的 scripts/photolibrary.py 适配器还需要单独安装的 photo-search 引擎，并把 PHOTOSEARCHENGINEDIR 指向它。
它附带可以试用的示例照片吗？没有。初始技能不带任何示例图片，你需要提供自己的照片文件夹才能制作照片书。
我的照片或生成的照片书会被上传到别处吗？不会，一切都留在本地：照片从本地文件夹导入，生成的照片书和照片文件被加入 Git 忽略清单，不会被提交或分享。
2D Book 和 3D Book 模板有什么区别？2D Book 是技能自带的默认 HTML 运行时。3D Book 1 和 3D Book 2 示例则是技能文件夹之外的独立可选模板，分别用 React+WebGL 和 Three.js+Quick FlipBook 构建。
Negative Sleeves 是什么？它是示例中一个独立的、不含照片的模板：一个胶片档案界面，带页角预览和可拖动的胶片条，与主照片书工作流无关。
这个技能实际是怎么决定我的照片书样子的？它遵循三段式工作流：先理解照片（通过搜索/缩略图索引），再与用户一起确定风格（或回退到默认照片书风格），最后用内置的 2D 运行时构建最终的照片书，并在本地 URL 上提供服务。
What are similar projects?Skills, img2threejs, RuiC-card-skill, aetherviz-master, holo-card-studio, threejs-architecture-effects, dream-loop, floorplan-3d
Which topics is it in?threejs, image, webgl, semantic-search, 3d, design, animation, html, ui, agent-skills, openai, codex
Creator
HaichaoLihc
Size
70.5 MB
Stars
530
Updated
CommitOct 16Releasev0.3.0Sep 08
Age
1mo
Commits · 90 Days