TverRecの使い方 (Version 2.7.2)

Atom | RSS

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

TVerRec（ティーバーレック）

TverRecは、TVerのHLSコンテンツをダウンロードするためのスクリプトで、PowerShell Coreというソフトウェアで動作するよう設計されています。スクリプト一式はGitHubで公開されています。

TverRecは3つのソフトウェアを必要としますが、Windowsユーザーはコマンドを実行するだけで必要なソフトウェアが自動的にインストールされる仕様になっています。

youtube-dl を同梱していないのは著作権絡みだと思われます。同じアプローチを取っているダウンローダーとしては、海外製の XDM があります。

PowerShell Core

PowerShell Core は、Windows、Linux、macOS、Arm に対応したクロスプラットフォーム対応のコマンドシェルです。マイクロソフトがWindows PowerShell をクロスプラットフォーム対応に改造したものなので、怪しいものではありません。

ソフトウェア情報

※記事とは異なるバージョンが表示される場合があります。

TverRec でできること

TverRecはHLSコンテンツをダウンロードすることができるスクリプトです。ダウンロードタスクは youtube-dl に渡されます。

[TverRec の機能]

1. TVerの番組をダウンロードして保存する。
2. 番組のジャンルを指定して一括ダウンロード。
3. 番組の出演タレントを指定してダウンロード。
4. 番組名を指定して一括ダウンロード。
5. CMカット。
6. 新しい番組が配信される度に一括ダウンロード。
7. TVer の全録が可能です。
8. TVer の番組サムネイルをダウンロードファイルに埋め込みます。
9. 字幕データが TVer にある場合は、字幕情報もダウンロードファイルに埋め込みます。
10. 並列ダウンロードによる高速ダウンロードが可能です。
11. また、ダウンロードした番組が破損していないかの検証も行います。
12. ダウンロードされたファイルは、最終移動先に自動的に整理。
13. 動作に必要な youtube-dl や ffmpeg などの必要コンポーネントは自動的に最新版をダウンロード。
14. Windows 環境ではトースト通知によりダウンロードの進捗状況などを通知します。
15. 日本国外からも VPN 不要で利用することができます。
16. TVerRec の安定版が更新されると自動アップデートされます。

３つのダウンロードモード

個別ダウンロード以外のコマンドを実行すると、予期せぬ番組が大量にダウンロードされる可能性があるのでご注意ください。

TverRec のダウンロードモード

	モード	説明
	一括ダウンロード	start_tverrec.cmd TVer のカテゴリ毎のページを指定、タレントや番組を指定、各放送局毎のページを指定
	リストダウンロード	x.generate_list.cmd/y.tverrec_list.cmd ダウンロード候補をリストファイルに出力し、リストファイルを編集した後にダウンロードする
	個別ダウンロード	z.download_single_video.cmd 番組を 1 本ずつ指定してダウンロードする

z.download_single_video.cmd（個別ダウンロード）

TverRec で利用頻度が高いのは「z.download_single_video.cmd」です。このスクリプトは、ダウンロードしたい番組のURLをコピペするだけで動作します。

[手順]

1. 初期設定を完了させる。（次項で詳細説明しています）
   → system_setting.ps1 を別名保存して user_setting.ps1 を作成する。
2. z.download_single_video.cmd をダブルクリックして実行する。
   → 初回起動時は youtube-dl などが自動的にダウンロードされる。
3. 番組のURLをコピーする。
4. z.download_single_video.cmd の実行画面にペーストする。
5. ダウンロードが始まるので終わるまで待つ。
   → ダウンロードの進捗状況はタスクマネージャーで確認してください。
6. 以上
   

インストール

Windowsの例
ダウンロード → 解凍 → 初期設定

[インストール]

1. GitHubから最新バージョンをダウンロードする。
2. 任意のフォルダに解凍する。
3. 初期設定、この手順は必須です。
   system_setting.ps1 をメモ帳などのテキストエディタで開いてフォルダを修正した後別名保存して user_setting.ps1 を作成する。
   個別ダウンロードはこのファイルを作成するだけで動作します。各種ディレクトリを指定しますが全て同じでもよい。（ダウンロード先、ダウンロード中の作業フォルダ、保存先）
4. 以上
   （フォルダ構成）
   

[必要なソフトウェア]

以下のソフトウェアはTverRecを起動した時に自動的にインストールされます。起動するたびにバージョンチェックを行い最新バージョンをインストールする仕様です。

• PowerShell Core (Windows のみ自動インストール)
• youtube-dl
• ffmpeg
• Python (Linux/Mac 環境のみ必要。Windows 環境では不要)

初期設定

Windowsの例
confフォルダに保存されたサンプルファイルを修正して別名で保存する。

[system_setting.ps1]

ダウンロード、作業フォルダ、保存先の3つを指定する。既存または新規作成フォルダを指定する。

system_setting.ps1 を開いて修正、[名前を付けて保存：user_setting.ps1] を実行する。（上書きでもよいが別名保存が推奨されている）

conf\system_setting.ps1 の編集

	変更前	変更後
	#ダウンロード先のフルパス(絶対パス指定) を変更する $script:downloadBaseDir = 'W:'	$script:downloadBaseDir = 'C:\mp4'
	#ダウンロード中の作業フォルダのフルパス(絶対パス指定) $script:downloadWorkDir = $env:TMP #$env:TMP = C:\Users\<ユーザ名>\AppData\Local\Temp	$script:downloadWorkDir = 'C:\temp'
	#保存先のフルパス(絶対パス指定) $script:saveBaseDir = 'V:'	$script:saveBaseDir = 'C:\mp4'
	system_setting.ps1	user_setting.ps1 「名前を付けて保存」する。

[keyword_sample.conf]

keyword_sample.conf を変更後上書きでもよいが [名前を付けて保存: keyword.conf] が推奨されている。

conf\keyword_sample.conf の編集

	変更前	変更後
	全てのリスト	先頭に「#」を付加してコメントアウトする
	新規追加	ダウンロードしたい番組を追記する、書式はconfに説明あり
	keyword_sample.conf	keyword.conf 「名前を付けて保存」する。

TverRec フォルダ構成

*触る必要のないファイルは省略しています。

TverRec フォルダ構成

TVerRec\...	操作するファイル	説明
.devcontainer
.github
.vscode
bin
colab
conf	ignore.sample.conf	ダウンロード対象外番組を登録するファイル
	keyword.conf	番組のキーワードなどを登録するファイル
	system_setting.ps1	別名保存して user_setting.ps1 として新規作成する
db
docker
img
lib
list	list.csv	keyword.conf の条件に合致する番組のリスト。win/start_tverrec.cmd を実行する前に win/x.generate_list.cmd を実行してダウンロードされる番組を確認することができる。
src
unix
win	start_tverrec.cmd	バッチファイルの開始(keyword.conf が実行される)
	stop_tverrec.cmd	実行中のバッチファイルを停止する
	x.generate_list.cmd	ダウンロードリスト list.csv の作成
	y.tverrec_list.cmd	list.csv を参照して番組をダウンロードする
	z.download_single_video.cmd	ブラウザのURLをコピペして利用する(シングルモード)

コマンドファイルの使い方

Windowsの例
初期設定をしていない時は、コマンドを実行するとエラーを返します。

[start_tverrec.cmd の動作 / Windows]

keyword.conf を作成していない時は、ビックリするくらいの番組がダウンロードされるので注意ください。

1. win\start_tverrec.cmd を実行する（ダブルクリック）
2. conf\user_setting.ps1 を呼び出す(バッチファイルが自動的にロードする）
3. user_setting.ps1 が存在しない時は、conf\system_setting.ps1 がロードされる
4. conf\keyword.conf を参照してダウンロードする番組を検索する
5. keyword.conf が存在しない時は、conf\keyword.sample.conf を参照する。
6. ダウンロード開始、バックグラウンドで動作するため進捗は確認できません。
7. keyword.conf で指定した番組が全てダウンロードされたら終了
   ※ビックリするくらいのファイル数
8. 以上

[start_tverrec.cmd をダブルクリックで起動できない場合]

1. Windows PowerShell またはコマンドプロンプト起動
2. start_tverrec.cmd をフルパスで指定する
   例: C:\TverRec\win\start_tverrec.cmd
3. リターン
4. 以上

   Windows ターミナル(cmd)

   C:\> C:\TverRec\win\start_tverrec.cmd

   Windows PowerShell

   PS C:\> C:\TverRec\win\start_tverrec.cmd

TverRec を実行する

コマンドを実行する前に環境設定を終えておくことが必要です。使い勝手がいいのは z.download_single_video.cmd(シングルダウンロード)です。

[win/start_tverrec.cmd] / 自動実行

1. 環境設定を終えておくこと。
2. start_tverrec.cmd をダブルクリックする。
3. 初回に限り PowerShell Core, youtube-dl, ffmpeg がインストールされる。
   
4. 再度 C:\TVerRec\win\start_tverrec.cmd をダブルクリックする。
5. 停止する時は、stop_tverrec.cmd をダブルクリックする。
6. ダウンロードが終了するまで待つ。
7. 以上

[z.download_single_video.cmd] / URLを指定してダウンロード

1. z.download_single_video.cmd をダブルクリックする。
2. URLを聞かれるのでコピペする。
3. 以上
   

[win/x.generate_list.cmd, win/y.tverrec_list.cmd] / csvリスト作成、実行

1. x.generate_list.cmd をダブルクリックして list.csv を作成する。
2. list.csv を開いて番組名を確認する。必要に応じて修正する。
3. y.tverrec_list.cmd をダブルクリックしてダウンロードを開始する。(start_tverrec.cmd でもよい)
4. ダウンロードが終了するまで待つ。
5. 以上

PowerShell Core

PowerShell Coreは、マイクロソフトが開発したクロスプラットフォームのコマンドラインシェルおよびスクリプト言語です。

Windows、macOS、Linuxなど、様々なオペレーティングシステムで動作します。

PowerShell Coreは、Windows PowerShellという従来のバージョンとは異なり、オープンソースであり、より広範なプラットフォームで使用することができます。

PowerShell Coreは、システム管理者や開発者が自動化されたタスクを実行するために使用することができ、.NET CoreやAzure Cloud Shellなど、様々なプラットフォームで利用されています。

HLS /HTTP Live Streaming

TVerはコンテンツをHLS方式で配信しているため、通常の方法ではファイル一式を取得することはできません。加えて、コンテンツを保護するために HLS-Encryption 技術が使われています。

HLS（HTTP Live Streaming）とは、動画ストリーミング技術の一種で、動画を小さなファイル（セグメント）に分割して、それらを順次ダウンロードしながら再生する方式です。

具体的には、動画ファイルを複数のセグメントに分割し、それらをHTTPで配信します。クライアント側（再生する側）は、最初のセグメントをダウンロードして再生を開始し、その後次々と次のセグメントをダウンロードして再生を続けます。このようにすることで、ネットワーク環境の変化に応じて、セグメントのサイズやビットレートを変更することができ、スムーズな再生を実現できます。

また、HLSはストリーミングの遅延を減らすために、再生中に次のセグメントを予めダウンロードするプリロード機能や、再生位置を指定して特定のセグメントから再生を開始する機能なども備えています。

HLSは、Appleが開発したプロトコルで、iPhoneやiPadなどのiOSデバイスでの再生に特化していますが、現在では様々なプラットフォームやデバイスでサポートされています。

著作権と HLS-Encryption

インターネット上での音楽利用にはJASRACの許諾が必要であることや、放送番組のインターネット同時配信等に係る権利処理の円滑化に関するワーキングチームが設置されていることなどから、TVerの著作権については尊重しなくてはなりません。

HLS-Encryption

TverRec は「ストリームレコーダー」が削除した機能 HLS-Encryption に対応しています。

HLS-Encryption は、HTTP Live Streaming (HLS) というプロトコルで動画を暗号化する技術です。HLS は、Apple Inc. が開発した適応型ビットレートストリーミングのプロトコルで、メディアプレーヤーやウェブブラウザ、モバイルデバイスなどで広くサポートされています。

HLS-Encryption では、動画ファイルを AES-128 という暗号化アルゴリズムで暗号化し、マニフェストファイルに復号化に必要なキーへのリンクを含めます。

著作権

ストリームレコーダーや TverRec などのスクリプトを使用して、HLS-Encryption コンテンツをダウンロードする場合、著作権法に違反する可能性があります。特に、HLSコンテンツがAES暗号化などで保護されている場合、コンテンツをダウンロードするためには著作権者の許可が必要です。著作権者の許可を得ずにHLSコンテンツをダウンロードすることは、違法行為となり、法的な問題を引き起こす可能性があります。

TverRecは、youtube-dlにダウンロードタスクを渡すことにより著作権問題を回避しているという解釈もありますが、これが正当な方法であるかどうかは不明です。また、TverRecの作者は、このソフトウェアを使用して発生したいかなる損害にも責任を負わないと免責事項を記載しています。

結論としては、

TverRecを使用する場合は、自己責任です。

Scrap 2nd.

ストリームレコーダーの記事一覧。

kzstock.blogspot.com

まとめ

• TverRec はライブストリーミングに対応したスクリプト。
• PowerShell Core で動作するよう設計されている。
• Tver専用のため汎用性はない。
• 本体はダウンロード機能を搭載せず、youtube-dl にダウンロードタスクを渡すことにより著作権問題を回避している。（らしい）
• .conf, .ps1 を自分用に書き換えることで正しく動作するようになる。
• 設定のハードルが高いので、脱落者多数。（たぶん）
• hls | SC2

ストリーミング動画のダウンロード支援ガイド【2024年最新版】

HLS形式の動画ダウンロードには、専用ソフトやアプリが必要。著作権侵害や悪意のあるソフトには注意。サービスによっては専用アプリでダウンロード可能。

kzstock.blogspot.com

 External link

• dongaba/tverrec - Docker Image | Docker Hub
• Home · dongaba/TVerRec Wiki · GitHub

：SC2

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