【バグ】TVerRec 3.4.2 のリネーム処理不具合とその原因を考察

Atom | RSS

このサイトを検索 | Search this site

2025-04-01: TVerRec 3.4.4 Latest、3.4.3の不具合を修正
2025-04-01: TVerRec 3.4.3 起動不可問題あり

TVerRec 3.4.2 / Latest

TVerRecは、TVerのコンテンツをダウンロードできるスクリプトです。Windows PowerShellのクロスプラットフォーム版 PowerShell Core上で動作します。

2025年3月29日にリリースされた TVerRec 3.4.2（Latest/安定板）においてリネーム処理の不具合が確認されたので、状況をメモしておきます。

禁則文字

ダウンロード完了後のリネーム処理でエラーが発生しているため、番組名にファイル名として使用できない文字（禁則文字）が含まれている可能性があります。

または、パス名の最大長をオーバーしている可能性があります。

TVerRec側で禁則文字のチェックを実施している場合、その他の問題が関係している可能性も考えられます。（例：TVerRecの処理ロジックのバグや環境依存の問題）

TVerRec 3.4.2 暫定バージョンからの復帰

暫定から通常（Latest）に戻ったが...

2025年3月16日未明に行われたTVerの仕様変更の影響により、TVerRecのダウンロード機能に一部支障が出ていましたが、緊急リリースされたTVerRec 3.3.9（暫定版）によって、機能制限はほぼ解除され、3月31日時点で TVerRec 3.4.2 (Latest) がリリースされています。

TVerの仕様変更が影響しているかはわかりませんが、特定の番組においてリネーム処理に失敗するようになりました。

ダウンロードはできている

TVerRec 処理スタート：start_tverrec.cmd を実行
TVerRec ダウンロード開始
TVerRec ダウンロード終了
TVerRec リネーム処理 ← ここで失敗！
ログウィンドウに赤文字が表示され処理が中断、その後整合性チェックによりリネーム前のファイルが削除され、ダウンロード未終了フラグが付与されリトライが無限ループ

リネーム失敗の原因を考える

TVerRecは指定した書式に基づく番組名をファイル名に変換しているので、番組名にファイル名では使用できない禁則文字が含まれる場合、OS（今回はWindows）側でエラーが通知されている可能性がある。

Windowsにおいて、ファイル名に使えない文字（禁則文字）は以下の通り。

ファイル名に使えない文字（全て半角）

¥（円マーク）
/（斜線、スラッシュ）
: （コロン)
*（アスタリスク）
?（疑問符、クエスチョンマーク）
"（ダブルクォーテーション）
<> （不等号）
|（縦線、パイプライン）
AUX
CON
COMn（nは1～9の数字）
LPTn（nは1～9の数字）
PRN
NUL
CLOCK$

文字数制限

Windowsファイルシステムは、ファイル名とパス名の最大長が決められている。

ファイル名は制限をクリアしていても、TVerRecが生成するフォルダ名が長い場合、パス名で弾かれる可能性がある。

ファイル名の制限：最大255文字
パス名の制限：最大259文字

具体例

[']（シングルクォーテーション）は禁則文字ではないので使えるはずだが、以下の番組はダウンロード後のファイル名変換で弾かれた。


URL	https://tver.jp/episodes/epy8rwnwcg
番組名	オールスター後夜祭オールスター後夜祭’25春 2025年03月29日放送 Ep01 オールスター後夜祭’25春