クイックスタート

このセクションでは、lightfile-shotの基本的な使い方を説明します。

コマンド構文

lightfile-shot [ソースディレクトリまたはファイル] [出力先ディレクトリまたはファイル] [オプション]

最もシンプルな使い方

カレントディレクトリ内の画像を最適化

lightfile-shot .

このコマンドは、カレントディレクトリ内のすべての画像ファイルを最適化して上書き保存します。

指定ディレクトリの画像を最適化

lightfile-shot /path/to/images

指定したディレクトリ内のすべての画像ファイルを最適化します。

単一ファイルの最適化

lightfile-shot /path/to/image.jpg

指定した1つの画像ファイルのみを最適化します。

複製モード（別ディレクトリに保存）

元のファイルを残したまま、最適化した画像を別の場所に保存します。

ディレクトリ全体を複製

lightfile-shot /path/to/source /path/to/destination

ソースディレクトリの画像を最適化して、宛先ディレクトリに保存します。

単一ファイルを複製

lightfile-shot /path/to/source.jpg /path/to/optimized.jpg

1つの画像ファイルを最適化して、別のファイルとして保存します。

ドライランモード（プレビュー）

実際の処理を行わず、どのファイルが処理されるかを確認できます。

lightfile-shot /path/to/images --dry-run

または短縮形:

lightfile-shot /path/to/images -n

ドライランモードの出力例

2024-03-10 12:00:00.123 INFO DryRunモード: 実際の処理は行いません
2024-03-10 12:00:00.456 INFO [images/city.jpg] ファイルを最適化しました
2024-03-10 12:00:00.789 INFO [images/logo.png] スキップ: already optimized
2024-03-10 12:00:05.001 INFO ✅ 完了: 2ファイル (成功: 1 | スキップ: 1 | エラー: 0) | ⏳ 所要時間: 5s

注意: ドライランモードでも最適化ロジックは実行され、削減量は実測値です。ファイルの書き込みだけが抑止されます。

品質設定

画像の品質を3段階で調整できます。

# 低品質（最大圧縮）
lightfile-shot /path/to/images --quality low

# 中品質（バランス型、デフォルト）
lightfile-shot /path/to/images --quality medium

# 高品質（高画質優先）
lightfile-shot /path/to/images --quality high

詳細は品質設定を参照してください。

よく使うオプション

並列処理

複数のファイルを同時に処理して高速化します。

# 4ファイルを並列処理
lightfile-shot /path/to/images --concurrency 4

# 短縮形
lightfile-shot /path/to/images -j 4

ファイルサイズで絞り込む

# 100KB以上のファイルのみ処理
lightfile-shot /path/to/images --min-size 100kb

# 5MB以下のファイルのみ処理
lightfile-shot /path/to/images --max-size 5mb

詳細はファイルフィルタリングを参照してください。

処理結果の記録

処理結果を詳細にNDJSON形式で記録できます。

lightfile-shot /path/to/images --journal /path/to/journal.ndjson

詳細はジャーナル機能を参照してください。

実行例

例1: シンプルな最適化

lightfile-shot ~/Pictures

例2: 高品質設定で並列処理

lightfile-shot /var/www/images \
  --quality high \
  --concurrency 4

例3: ドライランでプレビュー後、実行

# まずドライランで確認
lightfile-shot /path/to/images --dry-run --verbose

# 問題なければ実行
lightfile-shot /path/to/images

例4: 複製モードで安全に処理

# 別ディレクトリに最適化版を作成
lightfile-shot /path/to/original /path/to/optimized --quality high

次のステップ

動作モード - 上書きモードと複製モードの詳細
ファイルフィルタリング - サイズ、拡張子、パターンマッチング
品質設定 - JPEG・PNGの品質調整
コマンドラインオプション - すべてのオプションのリファレンス

目次