AKARI Video / 使い方ガイド / ファイルの地図 GitHub ↗

HOW TO — 4 / 6

ファイルの地図

AKARI Video はあなたの作品を専用アプリの中に閉じ込めません。すべて普通のファイルとフォルダとして PC に置かれます。このページは「どこに何ができて、誰がそれを触るのか」の一枚地図です。バックアップと引っ越しの答えもここにあります。

最終更新 2026-08-03 AKARI Video v0.1.3 時点

1 — 3 つの場所

PC の中にできるのは、役割の違う 3 つだけ

🏭 本体

~/.akari/app/
/Applications/AKARI Video.app

エンジンと道具一式(CLI 版とアプリ版)。誰も中を触らない。アップデートで丸ごと新しくなる。消えて困るものは入っていない。

⚙️ マシン設定

~/.akari/
~/.config/akari-video/

自動配置された実行環境・更新キャッシュ・API キーなどの認証情報。アプリだけが触る隠しフォルダ。秘密情報はここに隔離され、作品側には絶対に混ざらない。

📦 あなたのデータ

~/AkariVideo/

作品と記憶のすべて。触るのはあなたと AI。アップデートで壊されない。バックアップはここだけで OK。フォルダ 1 個で自己完結。

ゲームで例えると——本体はゲーム機とソフト(買い替えても平気)、マシン設定は本体設定(Wi-Fi やアカウント)、データはセーブデータ(これだけが宝物)。

Windows の場合も同じ 3 分割です。データの既定は C:\Users\<名前>\AkariVideo\。「ドキュメント」ではなくホーム直下なのは、OneDrive の自動同期に動画素材が吸い込まれるのを避けるためです。

2 — 誰が書いてよいか

ファイルは「4 色」に分かれる

データの中のファイルは「誰が書いてよいか」で 4 色に分かれます。この色分けが AKARI Video の信頼の仕組みそのものです。

あなたのもの — AI は書き換えない 対話で作る — AI が起草・あなたが承認 AI が整える — 企画・レポート・索引 機械のもの — 見なくていい・手で触らない

🟢 いちばん大事なのは緑: あなたが撮った素材に、AI は一切書き込みません。🟣 紫は「AI がタイプして、あなたが OK を出す」共同執筆——設定ファイルを自分で書く必要はありません。

3 — データの中身

~/AkariVideo/ のツリー

データの置き場所は初回起動時にアプリが自動で作ります(あなたがフォルダを掘ることはありません)。中身はこうなっています:

~/AkariVideo/あなたのデータのルート
├─ akari.mdあなたの好み・ルール(対話で育つ)
├─ channels/チャンネルごとの部屋
│ └─ わたしのチャンネル/
│ ├─ design.mdチャンネル設計書(任意・あとからで OK)
│ └─ videos/動画プロジェクトが並ぶ
│ └─ 2026-08-03-はじめての動画/→ 中身は §4
├─ library/プロジェクト横断の素材置き場
├─ inbox/撮りっぱなし・思いつきメモの投げ込み口
└─ .akari/AI の記憶・スタイル学習・キャッシュ

アプリの画面でふだん目にする単位は「プロジェクト」と「チャンネル」だけです。この置き場所自体は、アプリの設定に「データの場所: ~/AkariVideo」として小さく表示されます。仕様の正式名は「作業場(creator-root)」——詳細は GitHub の契約文書へ。

4 — 動画 1 本の中身

プロジェクトは「自己完結の小箱」

動画 1 本 = フォルダ 1 個。必要なものが全部この中に入っているので、単体で移動・共有・削除できます

2026-08-03-はじめての動画/プロジェクトの箱
├─ edit.json編集の正本(セーブデータ)。ドラッグの直しもここに残る
├─ captions.json字幕データ
├─ assets/この動画の撮影素材(AI は書き換えない)
├─ planning/企画書・構成案
├─ exports/完成品の動画ファイル
└─ .akari/作業記録・レポート・キャッシュ

.akari/ の中でも reports/(あなたが承認した記録・検証の証跡)だけは消さずに残す設計です。それ以外のキャッシュ類は消えても再生成されます。

5 — 引っ越し・バックアップ・取り込み

フォルダ 1 個だから、ぜんぶ単純

🚚 まるごと引っ越し

~/AkariVideo/ を新しい PC や外付け SSD にそのままコピーすれば移住完了。アプリを入れ直して場所を教えるだけ。バックアップも同じで、このフォルダを丸ごと取ればよい。

📦 プロジェクト単体でも動く

お試し利用なら、どこか適当なフォルダにプロジェクトを作って使うこともできます(導入のターミナル手順がこれ)。ただしプロジェクト横断の機能(スタイル学習・一覧)は効きません。

🏠 あとから取り込める

外で作ったプロジェクトも、小箱ごと videos/ に移せばデータの仲間になります。移動だけ、変換なし。アプリの「チャンネルに入れる」からワンボタンでもできます。

🔒 秘密はデータに混ざらない

API キーなどの認証情報はマシン設定側(~/.config/akari-video/)にだけ置かれます。データのフォルダは丸ごと共有・バックアップしても秘密が漏れない設計です。

前のページ← 3. 開いて、直す