# Tsumanne Downloader オールインワン版 取扱説明書

## 概要

このツールは「超かぐや姫」のログをローカルへ保存し、管理しやすい状態へ自動整理するためのツールです。

実行すると以下を自動で行います。

1. サイトから新規ログ・更新ログを取得
2. update日時順にフォルダ番号を整理
3. フォルダサムネイルを設定

以後は同じコマンドを実行するだけで最新状態へ更新できます。

---

# 配布ファイル構成

以下のファイルを同じフォルダへ配置してください。

```text
tsumanne_all_in_one.py
tsumanne_log_aware_update_check_ordered.py
tsumanne_rename_by_update_datetime_execute.py
tsumanne_set_folder_thumbnails_pair_s_any_ext_fix_permission_v2.py
README.txt（本書）
```

初回実行時に保存フォルダ

```text
超かぐや姫
```

が自動作成されます。

---

# 動作環境

推奨環境

* Windows 10
* Windows 11
* Python 3.10以上

---

# 初回セットアップ

## Pythonの確認

コマンドプロンプトを開きます。

以下を入力してください。

```bat
python --version
```

表示例

```text
Python 3.14.0
```

と表示されれば利用可能です。

---

# フォルダ配置例

例

```text
D:\tsumanne

├─ tsumanne_all_in_one.py
├─ tsumanne_log_aware_update_check_ordered.py
├─ tsumanne_rename_by_update_datetime_execute.py
├─ tsumanne_set_folder_thumbnails_pair_s_any_ext_fix_permission_v2.py
└─ 超かぐや姫
```

※「超かぐや姫」フォルダは初回実行時に自動作成されます。

---

# 実行方法

## 方法1（推奨）

エクスプローラーでツールフォルダを開く

アドレスバーへ

```text
cmd
```

と入力して Enter

コマンドプロンプトが開きます。

そのまま

```bat
python tsumanne_all_in_one.py
```

を実行してください。

---

## 方法2

コマンドプロンプトを開いて

```bat
cd /d D:\tsumanne
```

実行後

```bat
python tsumanne_all_in_one.py
```

を実行してください。

---

# 初回取得

保存フォルダが空の場合

```bat
python tsumanne_all_in_one.py
```

を実行すると全スレッド取得を開始します。

初回は件数によって数時間かかる場合があります。

---

# 日常更新

以後は同じコマンドを実行するだけです。

```bat
python tsumanne_all_in_one.py
```

ツールが過去ログを確認し、

* 新規スレッド
* 更新されたスレッド

のみ取得します。

---

# 保存先

取得データは

```text
超かぐや姫
```

フォルダ内へ保存されます。

フォルダ名例

```text
000001_2026-01-22_1394818888
000002_2026-01-22_1394853251
000003_2026-01-22_1394898020
```

形式

```text
連番_update日付_スレッドID
```

---

# update日時順への整理

取得完了後、

自動的に update日時順で並び替えます。

番号が変更されることがありますが正常動作です。

---

# フォルダサムネイル

各スレッドフォルダに代表画像を設定します。

優先順位

1. 本体画像とペアになった「s付き画像」
2. 条件に一致しない場合は代替画像

例

```text
1777124032798.png
1777124032798s.jpg
```

の場合

```text
1777124032798s.jpg
```

が代表画像になります。

---

# 保存容量について

画像を含むため容量は大きくなります。

目安

```text
100スレッド   約500MB前後
1000スレッド  数GB
3000スレッド以上 10GB超
```

十分な空き容量を確保してください。

---

# フォルダ移動

スクリプトと保存フォルダをまとめて移動してください。

例

```text
D:\tsumanne
↓
E:\Archive\tsumanne
```

へ移動しても問題ありません。

---

# 途中で停止した場合

再度

```bat
python tsumanne_all_in_one.py
```

を実行してください。

ログを参照して続きから処理します。

---

# 完全に最初から取得したい場合

「超かぐや姫」フォルダを別名へ変更するか退避してください。

その後

```bat
python tsumanne_all_in_one.py
```

を実行すると新規取得を開始します。

---

# よく使うコマンド

実行

```bat
python tsumanne_all_in_one.py
```

フォルダ移動

```bat
cd /d D:\tsumanne
```

Python確認

```bat
python --version
```

---

# 通常運用

普段は以下だけ覚えておけば問題ありません。

```bat
cd /d D:\tsumanne
python tsumanne_all_in_one.py
```

これだけで

1. 更新取得
2. リネーム
3. サムネイル更新

まで自動実行されます。

# 処理の中断方法

処理を途中で停止したい場合は、実行中のコマンドプロンプトで

```text
Ctrl + C
```

を押してください。

確認メッセージが表示された場合は

```text
Y
```

を入力して Enter を押してください。

---

# 中断後の再開

途中で停止しても取得済みのデータは保持されます。

再度以下を実行してください。

```bat
cd /d D:\tsumanne
python tsumanne_all_in_one.py
```

ログを参照して処理を再開します。

---

# 中断した場合の影響

## ログ取得中

```text
tsumanne_log_aware_update_check_ordered.py
```

実行中に停止した場合

* 取得済みデータは保持されます
* 次回実行時に未取得分を続きから取得します

---

## リネーム中

```text
tsumanne_rename_by_update_datetime_execute.py
```

実行中に停止した場合

* 一部のフォルダ番号だけ変更されている可能性があります

再度

```bat
python tsumanne_all_in_one.py
```

を実行してください。

リネーム処理が再実行され、整合性が回復します。

---

## サムネイル設定中

```text
tsumanne_set_folder_thumbnails_pair_s_any_ext_fix_permission_v2.py
```

実行中に停止した場合

* 一部のフォルダのみサムネイル設定済みになります

再度実行すると未処理フォルダを処理します。

---

# 非推奨の停止方法

コマンドプロンプト右上の

```text
×
```

で強制終了することも可能ですが、

推奨されません。

可能な限り

```text
Ctrl + C
```

を使用してください。
