After Effectsの不明なフッテージを一括で再リンクする方法【2026年版】自作スクリプトのコードつき

/* AE_リンクオート.jsx - safe missing-footage relinker, single or multiple roots. */
(function AE_LinkAuto(thisObj) {
    var SCRIPT_NAME = "リンクオート";
    function isMissing(item) {
        if (!(item instanceof FootageItem) || !item.mainSource) return false;
        try {
            return item.file && !item.file.exists;
        } catch (e) {
            return true;
        }
    }
    function key(s) {
        return String(s).toLowerCase();
    }
    function slash(s) {
        return String(s).replace(/\\/g, "/").toLowerCase();
    }
    function scorePath(oldPath, newPath) {
        var a = slash(oldPath).split("/"),
            b = slash(newPath).split("/"),
            score = 0,
            i,
            max = Math.min(a.length, b.length);
        for (i = 2; i <= max; i++) {
            if (a[a.length - i] === b[b.length - i]) score += 10;
            else break;
        }
        return score;
    }
    function addFile(file, index, seen, state) {
        var path = slash(file.fsName),
            k;
        if (seen[path]) return;
        seen[path] = true;
        k = key(file.name);
        if (!index[k]) index[k] = [];
        index[k].push(file);
        state.count++;
    }
    function scan(folder, index, seen, state) {
        var list, i, entry;
        try {
            list = folder.getFiles();
        } catch (e) {
            return;
        }
        for (i = 0; i < list.length; i++) {
            entry = list[i];
            if (entry instanceof Folder) {
                if (
                    entry.name !== "$RECYCLE.BIN" &&
                    entry.name !== "System Volume Information" &&
                    entry.name !== "__MACOSX" &&
                    entry.name !== "Adobe After Effects 自動保存"
                )
                    scan(entry, index, seen, state);
            } else if (entry.name.indexOf("._") !== 0 && entry.length > 0) addFile(entry, index, seen, state);
        }
    }
    function pick(candidates, oldPath) {
        var i,
            score,
            best = -1,
            second = -1,
            chosen = null;
        if (!candidates || candidates.length === 0) return null;
        if (candidates.length === 1) return { file: candidates[0], why: "同名候補が1件" };
        for (i = 0; i < candidates.length; i++) {
            score = scorePath(oldPath, candidates[i].fsName);
            if (score > best) {
                second = best;
                best = score;
                chosen = candidates[i];
            } else if (score > second) second = score;
        }
        if (best >= 10 && best > second) return { file: chosen, why: "フォルダ構成が最も一致" };
        return null;
    }
    function stamp() {
        var d = new Date();
        function p(n) {
            return n < 10 ? "0" + n : String(n);
        }
        return (
            d.getFullYear() +
            p(d.getMonth() + 1) +
            p(d.getDate()) +
            "_" +
            p(d.getHours()) +
            p(d.getMinutes()) +
            p(d.getSeconds())
        );
    }
    function reportFolder(roots) {
        try {
            if (app.project.file) return app.project.file.parent;
        } catch (e) {}
        return roots[0];
    }
    function run(roots, replace, output) {
        var index = {},
            seen = {},
            state = { count: 0 },
            missing = [],
            repaired = [],
            unresolved = [],
            i,
            j,
            item,
            oldPath,
            chosen,
            report,
            rootText = "";
        if (!app.project || app.project.numItems === 0) {
            alert("対象のAEプロジェクトを開いてから実行してください。");
            return;
        }
        output.text = "🔍 素材を検索中…";
        for (i = 0; i < roots.length; i++) {
            scan(roots[i], index, seen, state);
            rootText += roots[i].fsName + "\n";
        }
        for (i = 1; i <= app.project.numItems; i++)
            if (isMissing(app.project.item(i))) missing.push(app.project.item(i));
        if (missing.length === 0) {
            output.text = "✅ 不明なフッテージはありません。";
            alert(output.text);
            return;
        }
        if (replace) app.beginUndoGroup("リンクオート");
        for (i = 0; i < missing.length; i++) {
            item = missing[i];
            try {
                oldPath = item.file ? item.file.fsName : item.name;
            } catch (e1) {
                oldPath = item.name;
            }
            chosen = pick(index[key(item.name)], oldPath);
            if (chosen && replace) {
                try {
                    item.replace(chosen.file);
                    repaired.push(item.name + "\t" + chosen.why + "\t" + chosen.file.fsName);
                } catch (e2) {
                    unresolved.push(item.name + "\t置換エラー\t" + e2.toString() + "\t" + oldPath);
                }
            } else if (chosen)
                repaired.push(item.name + "\t接続可能: " + chosen.why + "\t" + chosen.file.fsName);
            else unresolved.push(item.name + "\t候補なし/候補が曖昧\t" + oldPath);
        }
        if (replace) app.endUndoGroup();
        report = new File(reportFolder(roots).fsName + "/AE_リンクオート_" + stamp() + ".txt");
        report.encoding = "UTF-8";
        if (report.open("w")) {
            report.writeln("検索フォルダ:");
            report.writeln(rootText);
            report.writeln("検索ファイル数\t" + state.count);
            report.writeln("不明フッテージ\t" + missing.length);
            report.writeln((replace ? "接続済み" : "接続可能") + "\t" + repaired.length);
            report.writeln("未解決\t" + unresolved.length);
            report.writeln("--- " + (replace ? "接続済み" : "接続可能") + " ---");
            for (j = 0; j < repaired.length; j++) report.writeln(repaired[j]);
            report.writeln("--- 未解決 ---");
            for (j = 0; j < unresolved.length; j++) report.writeln(unresolved[j]);
            report.close();
        }
        output.text =
            (replace ? "🔗 接続" : "✅ 接続可能") +
            " " +
            repaired.length +
            "件 / 未解決 " +
            unresolved.length +
            "件\nレポート: " +
            report.fsName;
        alert(
            output.text +
                "\n\n" +
                (replace
                    ? "内容を確認してCtrl+Sで保存してください。"
                    : "［安全チェック］はプロジェクトを変更しません。")
        );
    }
    function buildUI(thisObj) {
        var pal =
            thisObj instanceof Panel
                ? thisObj
                : new Window("palette", SCRIPT_NAME, undefined, { resizeable: true });
        pal.orientation = "column";
        pal.alignChildren = ["fill", "top"];
        pal.add("statictext", undefined, "🔍 リンクオート  ―  不明フッテージを安全に再接続");
        var mode = pal.add("checkbox", undefined, "🗂 複数フォルダモード（登録フォルダを一括検索）");
        var single = pal.add("group");
        single.add("statictext", undefined, "検索フォルダ:");
        var path = single.add("edittext", undefined, "");
        path.characters = 37;
        var choose = single.add("button", undefined, "📁 選択…");
        var multi = pal.add("panel", undefined, "候補の親フォルダ");
        multi.orientation = "column";
        multi.alignChildren = ["fill", "top"];
        var roots = multi.add("listbox", undefined, [], { multiselect: false });
        roots.preferredSize.height = 88;
        var rootButtons = multi.add("group");
        var add = rootButtons.add("button", undefined, "➕ 追加…");
        var remove = rootButtons.add("button", undefined, "➖ 選択を削除");
        var buttons = pal.add("group");
        var check = buttons.add("button", undefined, "✅ 安全チェック");
        var relink = buttons.add("button", undefined, "🔗 自動リンク");
        var out = pal.add("edittext", undefined, "検索フォルダを選択してください。", {
            multiline: true,
            readonly: true
        });
        out.preferredSize.height = 58;
        multi.visible = false;
        function addRoot(folder) {
            var i;
            if (!folder || !folder.exists) return;
            for (i = 0; i < roots.items.length; i++)
                if (slash(roots.items[i].text) === slash(folder.fsName)) return;
            roots.add("item", folder.fsName);
        }
        function chooseFolder() {
            return Folder.selectDialog("素材を探す親フォルダを選択");
        }
        function setMode() {
            single.visible = !mode.value;
            multi.visible = mode.value;
            pal.layout.layout(true);
        }
        mode.onClick = setMode;
        choose.onClick = function () {
            var f = chooseFolder();
            if (f) path.text = f.fsName;
        };
        add.onClick = function () {
            addRoot(chooseFolder());
        };
        remove.onClick = function () {
            if (roots.selection) roots.remove(roots.selection);
        };
        function selectedRoots() {
            var result = [],
                i,
                f;
            if (!mode.value) {
                f = new Folder(path.text);
                if (!path.text || !f.exists) {
                    alert("存在する検索フォルダを選択してください。");
                    return null;
                }
                result.push(f);
                return result;
            }
            for (i = 0; i < roots.items.length; i++) {
                f = new Folder(roots.items[i].text);
                if (f.exists) result.push(f);
            }
            if (result.length === 0) {
                alert("候補の親フォルダを1件以上追加してください。");
                return null;
            }
            return result;
        }
        check.onClick = function () {
            var r = selectedRoots();
            if (r) run(r, false, out);
        };
        relink.onClick = function () {
            var r = selectedRoots();
            if (r) run(r, true, out);
        };
        pal.onResizing = pal.onResize = function () {
            this.layout.resize();
        };
        return pal;
    }
    var panel = buildUI(thisObj);
    if (panel instanceof Window) {
        panel.center();
        panel.show();
    }
})(this);