はじめに
ミラーレスカメラを使う際、JPG+RAWみたいな形式で撮影している方は多いと思いますが、帰ってきてSDカードを開くとそこに広がるのは大量のファイル達。
同じ名前で拡張子だけ違うファイルが2つ生成されるし、表面上はいつ撮ったものなのかわからんし…
そこで、これらを良い感じに整理できるようなツールを作れないかということで、コードを書いてみました。
この記事では、ツールの概要、コードの解説、リリースの自動化を紹介します。
概要
まずは、具体的に整理とはどのようなことをするのかを定義します。
例えば、このようなファイル群があるとします。
日付は撮影日とします。
/photos
├── IMG_0001.JPG //2024-08-30
├── IMG_0001.DNG //2024-08-30
├── IMG_0002.JPG //2024-08-30
├── IMG_0002.DNG //2024-08-30
├── IMG_0003.JPG //2024-09-01
├── IMG_0003.DNG //2024-09-01
├── DSC_1234.DNG //2024-08-31
└── vacation_2024.JPG //2024-08-30
これをこのように、拡張子ごとのディレクトリ、その中に日付のディレクトリがあり、そこに画像ファイルが置かれる形にします。
/photos
├── JPG
│ ├── 2024-08-30
│ │ ├── IMG_0001.JPG
│ │ ├── IMG_0002.JPG
│ │ └── vacation_2024.JPG
│ └── 2024-09-01
│ └── IMG_0003.JPG
└── DNG
├── 2024-08-30
│ ├── IMG_0001.DNG
│ └── IMG_0002.DNG
├── 2024-08-31
│ └── DSC_1234.DNG
└── 2024-09-01
└── IMG_0003.DNG
また、柔軟性を持たせる仕様にもしたいと思います。
今回は、CLIツールを作るので、オプションで以下の2つを指定できるようにします。
- 操作対象のディレクトリ
- 扱う画像ファイルの拡張子
前者はまあ一般的だと思います。デフォルトではカレントディレクトリとします。
後者は、JPGだけを対象としたい場合や、カメラメーカーによって独自のRAWファイルの形式を採用しているケースもあります。そうした状況にも対応できるようにするため、実装します。デフォルトではJPGとDNGを対象とします。
作る
大体の仕様は決まったので作っていきます。
今回はGolangで作ります。
撮影日を取得する
まずは、画像ファイルの撮影日が取得できなければ何も始まりません。
画像ファイルにはExifというメタデータがくっついています。撮影日や撮影機材、設定など、いろいろな情報が入っているものです。
そこで、ここから撮影日を取得する関数を作ります。
func extractDate(filename string) (string, error) {
file, err := os.Open(filename)
if err != nil {
return "", err
}
defer file.Close()
exifData, err := exif.Decode(file)
if err != nil {
return "", err
}
dateTime, err := exifData.Get(exif.DateTimeOriginal)
if err != nil {
return "", err
}
dateStr := strings.Trim(dateTime.String(), "\"")
parsedTime, err := time.Parse("2006:01:02 15:04:05", dateStr)
if err != nil {
return "", err
}
return parsedTime.Format("2006-01-02"), nil
}
goexifというパッケージを用いて、Exifから撮影日を取得します。
また、このデータはYYYY:MM:DD hh:mm:ssという形式で入っており、今回はYYYY-MM-DDという形式で使いたいので、よしなにフォーマットします。
timeパッケージのParse関数を使っていますが、2006:01:02 15:04:05の部分は仕様です。
これで、画像ファイルの撮影日を取得できました。
ファイルを移動する
次に、ファイルを移動させる関数を作ります。
これは純粋に、mvコマンドのようなものを置くだけです。
func moveFile(src, dst string) error {
return os.Rename(src, dst)
}
移動元のファイルパスと、移動先のファイルパスを引数とし、移動を行います。
もろもろの処理をする
ここまできたら、あとはファイルを読み込んで、上二つの関数を呼び出して、ファイルの操作を行います。
func processFiles(baseDir, pattern, dir string) {
//いろんな処理
}
設定している3つの引数ですが、これは
- 操作対象のディレクトリ
-
*.[拡張子]な形 -
[拡張子]な形
としています。
これはmain関数から与えます。
まずは、*.[拡張子]にマッチするようなファイルをピックアップして、filesに入れます。例えば、*.JPGなら、JPGファイルだけがピックアップされます。
files, err := filepath.Glob(filepath.Join(baseDir, pattern))
if err != nil {
log.Fatal(err)
}
if len(files) == 0 {
log.Printf("No files found for pattern %s in %s", pattern, baseDir)
return
}
もしファイルが無ければ、メッセージを出して終わらせます。
次に、出力先の拡張子名なディレクトリを作成します。
outputDir := filepath.Join(baseDir, dir)
if err := os.Mkdir(outputDir, 0755); err != nil && !os.IsExist(err) {
log.Fatal(err)
}
ここから、ファイルごとに撮影日の取得や、ファイルの移動が始まります。
このままいくと、正常に動作している場合は何も表示されず、精神衛生上よろしくないので、プログレスバーを実装します。
まずは、長さがファイルの数分なプログレスバーを定義します。
bar := progressbar.NewOptions(
len(files),
progressbar.OptionSetDescription("Processing "+dir),
)
その後、ファイルの数分のfor文を書くのですが、その中で
bar.Add(1)
このようなものを書くと、バーが1つ進みます。
また、プログレスバーを進めるfor文が終わったら改行を挟みます。
なぜなら、2本目のプログレスバーが現れたとき、これがないと上書きされてしまうためです。
残しておきたかったので、for文の後に改行を挟むことで、上書きを防ぐようにしました。
println()
これで、プログレスバーを実装することができました。
で、そのfor文はこんな感じです。
前述した撮影日を取得する関数から撮影日を取得し、撮影日のディレクトリが無ければ作成、ファイルを移動して、プログレスバーを一つ進める。といった処理になっています。
for _, file := range files {
date, err := extractDate(file)
if err != nil {
log.Printf("Error processing %s: %v", file, err)
bar.Add(1)
continue
}
destDir := filepath.Join(outputDir, date)
if err := os.Mkdir(destDir, 0755); err != nil && !os.IsExist(err) {
log.Fatal(err)
}
if err := moveFile(file, filepath.Join(destDir, filepath.Base(file))); err != nil {
log.Printf("Failed to move %s: %v", file, err)
}
bar.Add(1)
}
これで、この部分の関数は完成です。このようになりました。
func processFiles(baseDir, pattern, dir string) {
files, err := filepath.Glob(filepath.Join(baseDir, pattern))
if err != nil {
log.Fatal(err)
}
if len(files) == 0 {
log.Printf("No files found for pattern %s in %s", pattern, baseDir)
return
}
outputDir := filepath.Join(baseDir, dir)
if err := os.Mkdir(outputDir, 0755); err != nil && !os.IsExist(err) {
log.Fatal(err)
}
bar := progressbar.NewOptions(
len(files),
progressbar.OptionSetDescription("Processing "+dir),
)
for _, file := range files {
date, err := extractDate(file)
if err != nil {
log.Printf("Error processing %s: %v", file, err)
bar.Add(1)
continue
}
destDir := filepath.Join(outputDir, date)
if err := os.Mkdir(destDir, 0755); err != nil && !os.IsExist(err) {
log.Fatal(err)
}
if err := moveFile(file, filepath.Join(destDir, filepath.Base(file))); err != nil {
log.Printf("Failed to move %s: %v", file, err)
}
bar.Add(1)
}
println()
}
メイン関数
最後にメイン関数を書きます。
ここでは、主にオプションの定義と取得、それを元にした処理関数の呼び出しを行います。
func main() {
extFlag := flag.String("ext", "JPG,DNG", "Comma-separated list of file extensions to process (e.g., JPG,DNG,PNG)")
dirFlag := flag.String("dir", ".", "Directory to process (default is current directory)")
flag.Parse()
extensions := strings.Split(*extFlag, ",")
for _, ext := range extensions {
processFiles(*dirFlag, "*."+strings.ToUpper(ext), strings.ToUpper(ext))
}
}
今回は、-ext=JPG,DNGのような形で拡張子を取得、-dir=/path/to/photoのような形でディレクトリを取得するようにしました。
拡張子をコンマ区切りにして、その拡張子分処理関数を実行することにしています。
これで、すべて書き終わりました。
動かす
さて、動かしてみましょう。
/Users/soli/Desktop/DCIM/100SIGMAの中に、2024/08/29と2024/08/30に撮影したJPGファイルと、DNGファイルを置きました。
ホームディレクトリで以下のようなコマンドを実行します。
picture-arrange -dir=/Users/soli/Desktop/DCIM/100SIGMA -ext=JPG,DNG
しっかりとプログレスバーも表示されて…
見事整理することができました！
リリース
さて、うまく動くことがわかったので、最後にリリースを行います。
GolangはOS, アーキテクチャごとにクロスコンパイルが可能ですが、それを手作業で用意してアップロードするのは非常に大変です。
そこで、GoReleaserとGithub Actionsを用いて、自動的にクロスコンパイルとリリースを行います。
GoReleaserのセットアップ
まずは、Goreleaserのセットアップを行います。公式サイトの言うとおりにインストールします。
次に、プロジェクトのディレクトリで初期化します。
goreleaser init
すると、.goreleaser.yamlというファイルが生成されます。これがGoReleaserのコンフィグファイルになりますが、今回はなにもいじらず使います。
次に、手元でうまくクロスコンパイルしてくれるか試しましょう。
goreleaser release --snapshot --clean
--snapshotとすることで、手元で確認をすることができます。また、--cleanを付けると、成果物のディレクトリ/distをまっさらにしてからビルドしてくれます。
うまくいくと、このような感じで成果物が出てきます。
Github Actionsで自動リリース
手元でうまくいくことがわかったので、Github Actionsを用いて自動リリースしましょう。
GoReleaserのActionのリポジトリに、サンプルワークフローがあるので、これを使いましょう。
name: goreleaser
on:
pull_request:
push:
permissions:
contents: write
jobs:
goreleaser:
runs-on: ubuntu-latest
steps:
-
name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0
-
name: Set up Go
uses: actions/setup-go@v5
-
name: Run GoReleaser
uses: goreleaser/goreleaser-action@v6
with:
# either 'goreleaser' (default) or 'goreleaser-pro'
distribution: goreleaser
# 'latest', 'nightly', or a semver
version: '~> v2'
args: release --clean
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Your GoReleaser Pro key, if you are using the 'goreleaser-pro' distribution
# GORELEASER_KEY: ${{ secrets.GORELEASER_KEY }}
今回は、プルリク時ではなく、バージョンのタグが付けられたときにしたいので、以下のように変更します。
name: goreleaser
on:
push:
tags:
- "v*"
permissions:
contents: write
jobs:
goreleaser:
runs-on: ubuntu-latest
steps:
-
name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0
-
name: Set up Go
uses: actions/setup-go@v5
-
name: Run GoReleaser
uses: goreleaser/goreleaser-action@v6
with:
# either 'goreleaser' (default) or 'goreleaser-pro'
distribution: goreleaser
# 'latest', 'nightly', or a semver
version: '~> v2'
args: release --clean
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
これで、タグが付けられたときに、Goreleaserが動いてくれます。
リリースタグのページに行くと
うまく行っていることがわかります。
終わりに
今回は、撮影した画像を整理するためのツールをGolangで作成し、自動的に整理できる方法を紹介しました。写真の整理はなかなか手間がかかる作業ですが、このツールを使うことで、簡単に日付ごとにファイルを整理することができます。
また、ツールを開発する過程でのポイントや、リリースの自動化についても解説しました。GoReleaserとGitHub Actionsを活用することで、クロスコンパイルやリリースの手間を大幅に削減できる点も重要です。
写真整理が必要な方にとって、このツールが少しでも役立てば幸いです。ぜひ使ってみてください！
フィードバックやリクエストがあれば、コメントやIssue, PRなどお待ちしています！