No description
Find a file
2026-05-19 19:04:25 +00:00
src Update config.toml 2025-12-02 08:16:47 -05:00
.gitattributes Initial commit 2025-04-25 19:39:46 -04:00
.gitignore Move some files around, Fix releases pipeline 2025-10-30 20:28:31 -04:00
LICENSE Release 0.3.0 2025-09-28 07:15:14 -04:00
make.bat Move some files around, Fix releases pipeline 2025-10-30 20:28:31 -04:00
Makefile Move some files around, Fix releases pipeline 2025-10-30 20:28:31 -04:00
poetry.lock Release 0.5.0 2026-01-06 09:01:14 -05:00
pyproject.toml Release 0.5.0 2026-01-06 09:01:14 -05:00
README.md Update README.md 2026-05-19 19:04:25 +00:00

DeepL翻訳 日本語

KK Scene Timeline Info

KKSceneTimelineInfo is a console executable designed to add timeline information to a scene's file name. It provides configurable options to customize how file names are updated, including adding author names, replacing tags, and handling subfolders.

Features

  • Add timeline information to file names.
  • Add SFX tag to the file name of scenes that include sounds (experimental).
  • Add custom tags to the file name.
  • Optional: Prepend the file name with [author name].
  • Optional: Handle subfolders as scene collections with aggregated information.

Limitations

  • I haven't found a way to detect when preset Studio animations are used, so if a scene does not animate in Timeline and only uses presets, it will be treated as static.

Installation

  • Download KKSceneTimelineInfo.xxx.zip from the release page
  • Extract wherever you want, but keep all the files together.

Usage

  • Drag and drop a scene file or folder on KKSceneTimelineInfo.bat A scene will be designated as:
  • (static) if the Timeline is not used at all (see limitation with preset animations).
  • (dynamic;MmSS) if the Timeline is used, but not to move characters (ex. camera, SFX, VFX) .
  • (MMmSS) if the Timeline is used to animate characters.

Configuration

The script behaviour can be customized using the config.toml file. Below are the available options:

  • display_only:
    If true, the script will only display the changes without applying them.
    Default: false

  • author:
    Specify an author name to add to file names.
    If left empty, it will not add an author name.
    If removed completely or commented out, it will use the parent folder's name.
    Default: ""

  • replace_author:
    If false, the script will not update the author in file names.
    Default: false

  • replace_tags:
    If true, all tags (except SFX) will be replaced (instead of updated) with the content of add_tags.
    To force remove the SFX tag, add NoSFX to add_tags.
    Default: false

  • add_tags:
    A list of tags to add or replace. Example: add_tags=["animation", "creampie"].
    Default: []

  • no_subfolder:
    If false, subfolders will also be processed. They are treated as scene collections and each subfolder will be assigned the total duration of its content. Individual scenes will still have their own information.
    Default: true

    .

    .

    .

    .

コイカツシーン[Timeline]情報

KKSceneTimelineInfo は、シーンのファイル名にタイムライン情報を追加するために設計されたコンソール実行ファイルです。作者名の追加、タグの置き換え、サブフォルダの扱いなど、ファイル名の更新方法をカスタマイズするための設定可能なオプションを提供します。

機能

  • ファイル名にタイムライン情報を追加
  • サウンドを含むシーンのファイル名にSFXタグを追加(実験的)。
  • ファイル名にカスタムタグを追加。
  • オプション: ファイル名の前に[作者名]を付ける。
  • オプション:情報を集約したシーンコレクションとしてサブフォルダーを扱う。

制限事項

  • プリセットスタジオのアニメーションが使用されていることを検出する方法が見つかりませんでした。そのため、シーンがタイムラインでアニメーションせず、プリセットだけが使用されている場合、静的なものとして扱われます。

インストール

  • リリースページから KKSceneTimelineInfo.xxx.zip をダウンロードしてください。
  • 好きな場所に解凍してください。

使用方法

  • シーンファイルまたはフォルダを KKSceneTimelineInfo.bat にドラッグ&ドロップする シーンとして指定されます:
  • (static)タイムラインが全く使用されていない場合(プリセットアニメーションによる制限を参照)。
  • (dynamic;MmSS)タイムラインが使用されるが、キャラクターを動かさない場合カメラ、SFX、VFX
  • (MMmSS) タイムラインがキャラクターのアニメーションに使用される場合。

設定

スクリプトの動作は config.toml ファイルを使ってカスタマイズすることができます。以下に利用可能なオプションを示します:

  • display_only
    trueの場合、スクリプトは変更を適用せずに表示のみを行う。 デフォルト: false

  • author
    ファイル名に追加する作者名を指定する。 空の場合、作者名は追加されません。 完全に削除するかコメントアウトすると、親フォルダの名前を使用します。 デフォルト: ""

  • replace_author
    falseの場合、スクリプトはファイル名の作者を更新しません。 デフォルト: false`

  • replace_tags
    もし true なら、全てのタグ(SFX を除く)を add_tags の内容に置き換える(更新するのではなく)。 SFXタグを強制的に削除するには、add_tagsNoSFXを追加する。 デフォルト:false`

  • add_tags
    追加または置換するタグのリスト。例: add_tags=["animation", "creampie"].
    デフォルト: [].

  • no_subfolder
    falseの場合、サブフォルダはシーンコレクションとして扱われ、各サブフォルダには作者名と合計時間が割り当てられます。 個々のシーンはそれぞれの情報を持ちます。 デフォルト: true`