FileSlider v1.0

FileSlider 是一款离线/在线幻灯片工具，可自动从文件夹中读取您的图片和音乐文件，并在浏览器中提供幻灯片放映。它以多种分辨率（包括 4K 和 FullHD）缩放图片，并生成缩略图和音乐播放列表。

---

下载：

下载 FileSlider v1.0

安装与使用

1. 下载项目

下载整个项目并将其解压到任意文件夹。
注意：如果您也想将其用于网络，建议使用小写且不含空格的文件夹名称。

2. 添加图片和音乐

• 将您的原始图片 (JPG, PNG) 放入 images/ 文件夹。
• 将您的音乐文件 (MP3, WAV) 放入 music/ 文件夹。

3. 创建幻灯片

• Windows：双击 start.bat。
• macOS/Linux：使 start.sh 可执行 (chmod +x start.sh)，然后双击或在终端中启动：

./start.sh

• macOS (FileSlider.app)：如果存在，只需双击
  FileSlider.app。您可能需要一次性在安全设置中允许其执行。

4. 处理图片和音乐

• 将打开一个终端窗口，其中图片将自动缩小（240px/1920px/3840px）。
• 所有图片还将生成一个 public/ 文件夹中的 imageList.js 文件；音乐文件将生成一个 musicList.js 文件。
• 脚本完成后，index.html 将在默认浏览器中打开。
• 您也可以随时通过打开 index.html 手动启动幻灯片。

5. 享受幻灯片

• 幻灯片将在浏览器中显示所有图片，无声音。
• 点击页面将启动音乐（如果存在）并同时切换到全屏模式。出于安全原因，大多数浏览器需要用户操作才能播放音乐。
• 图片按字母顺序排序。您可以使用相应的名称（例如“001_、002_...”）来控制顺序。

---

工作原理

• 离线：
  幻灯片完全离线运行（无需服务器）。生成的列表 (imageList.js, musicList.js) 由浏览器直接读取。
• 在线：
  如果工具检测到页面通过 HTTP/HTTPS 加载，将自动使用 1920px 图片以减少加载时间。下一张图片将被加载到缓存中，即使在连接较弱的情况下也能实现流畅播放。
• 图片画廊：
  在 slide_show.html 中有一个紧凑的概览画廊（240px）。点击图片即可从该位置开始幻灯片放映。由于图片较小，即使是包含 1000 多张图片的大型演示文稿也成为可能。
• 新内容：
  如果您添加了新的图片或音乐，只需重复步骤 3（运行启动脚本）。现有的缩略图和列表将得到更新。如果您想删除旧图片，请将其从 images/ 中删除，并删除 images-240、images-1920、images-3840 文件夹（如果需要）。然后再次运行脚本。

---

文件夹结构（示例）

FileSlider/
├─ start.bat             (Windows 启动脚本)
├─ start.sh              (macOS/Linux 启动脚本)
├─ FileSlider.app        (macOS: 可选，用于轻松启动)
├─ index.html            (主幻灯片)
├─ slide_show.html       (概览画廊)
├─ generateImageList.js  (用于图片/音乐列表的 Node.js 脚本)
├─ nodejs/               (便携式 Node.js，无需安装)
├─ node_modules/         (包含 'sharp' 等依赖项)
├─ images/               (原始图片)
├─ images-240/           (240px 缩略图)
├─ images-1920/          (1920px 缩略图)
├─ images-3840/          (3840px 缩略图)
├─ music/                (音乐文件)
└─ public/
   ├─ imageList.js       (所有图片列表)
   └─ musicList.js       (所有音乐文件列表)

---

提示与技巧

• 文件名中的文本：
  幻灯片会自动显示文件名（不含扩展名）作为标题/说明。
• 多种分辨率：
  将自动为不同设备创建 240px/1920px/3840px 版本。
• 终端窗口：
  根据系统不同，终端会保持打开状态以显示日志输出。按任意键或输入 exit 关闭它。
• 时间、CSS 和功能更改：
  整个幻灯片可以在 index.html 中修改。您可以在那里找到 CSS 以及每张图片的停留时间。在 slide_show.html 中，您可以找到概览页面的所有条目。您可以在此处添加自己的链接、图片等，例如向访问者提供提示或链接。

---

已知问题

• 文件未找到：
  注意大小写（尤其是在 Linux 下）。
• macOS 安全设置：
  首次运行 FileSlider.app 或 start.sh 时，可能会显示安全警告。请在“系统设置 → 安全与隐私”中手动允许其执行。
• 手机进入全屏模式时会有些不情愿，因此该工具主要用于在屏幕和投影仪上进行照片展示。
• og:image 和 og:url 在纯 HTML 文件中技术上不可行，但可以根据项目进行维护。集成将需要转换为 PHP，这将带来显著缺点，因为它只能在 Web 服务器上运行。

---

许可与鸣谢

• FileSlider 软件与脚本： © Johann Dirschl / DIRSCHL.com GmbH, 2025。
• 演示中的图片： 归 DIRSCHL.com GmbH 所有，可授权使用。
• 通过 nuonu.com 获取音乐：
  需要免版税音乐的用户也可以在我们的网站和 nuonu.com 上找到。那里有
  许多由 AI 创作的短片和器乐作品。但任何音乐文件都可以播放。在网络上，您应该保持文件较小（MP3）。离线时，您也可以使用 WAV 文件。
• 费用：
  我们的客户可免费使用。其他人可以免费下载和测试音乐、插件和应用程序。如果您想将其用于商业用途，可以在 nuonu.com → Connect 以 49 欧元购买一年期许可证（无有效期限制）。我们乐意根据需要扩展产品。
• Node.js： © Joyent Inc. / OpenJS Foundation (附带便携式 Node.js)。
• 依赖项： （例如 Sharp）在其各自的开源许可下。

使用 FileSlider 玩得开心！