FileSlider v1.0

FileSliderは、フォルダから画像や音楽ファイルを自動的に読み込み、ブラウザでスライドショーを提供するオフライン/オンラインのスライドショーツールです。複数の解像度（4KやフルHDなど）で画像をスケーリングし、サムネイルと音楽のプレイリストを作成します。

---

ダウンロード:

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をお楽しみください！