Skip to content

Latest commit

 

History

History
204 lines (172 loc) · 20 KB

README.en.md

File metadata and controls

204 lines (172 loc) · 20 KB

🎞 TVerRec 📺 TVer Bulk download and Save

🇺🇸English | 🇯🇵日本語

Logo GitHub release License GitHub commit activity GitHub last commit GitHub Repo stars GitHub Sponsors CodeFactor Grade Codacy grade GitHub Actions Workflow Status GitHub Actions Workflow Status GitHub Actions Workflow Status Docker Pulls TVerRec Launched Video Searched Video Download Video Validate

Software to support downloading video programs from TVer, a TV program distribution site in Japan. TVerRec offers bulk downloading by specifying the program genre, talent, program name, etc. Since commercials will be automatically excluded, you can keep your favorite programs even after they are no longer available. Once launched, programs will be downloaded each time a new program is distributed.

  • TVerRec does not support Windows PowerShell, please use PowerShell Core.
  • TVerRec runs on Windows/Mac/Linux with PowerShell Core installed.
  • If PowerShell Core is not installed on Windows, TVerRec will automatically install PowerShell Core.
  • For information on how to manually install PowerShell Core on Windows, or on Mac or Linux, see this page on the Wiki.
  • Docker images are also available here.
  • Get the stable version from Release.

Prerequisites

  • OS

    • Windows
    • Mac
    • Linux
  • Required Software

    • PowerShell Core (will be automatically installed on Windows)
    • youtube-dl (will be automatically downloaded)
    • ffmpeg (will be automatically downloaded)
    • Python (required only for Linux/Mac, not required for Windows)

Alternatively, it can be run as a container using Docker. The container is created with an Ubuntu Linux image and starts with all necessary tools already configured. You can start using it immediately after preparing and modifying the configuration file and setting the disk mount bindings.

Operation image of Windows GUI version

GUIMain GUISetting

Operation image of Windows CUI version

CUI

Main Features

Refer to this page on the Wiki for more information on each feature.

  1. Specify keywords such as genre, talent, program name, etc. and bulk download them.
  2. Record all TVer programs. (Technically, it is not recording, but downloading.)
  3. Embed TVer's program thumbnails into the downloaded file
  4. Embed subtitle into the downloaded files when subtitle data is available in TVer.
  5. Ultra high speed download by parallel downloading is available. (In my environment, downloading at 1Gbps on a 1Gbps line.)
  6. Of course, individual downloading by specifying TVer program URL is also available.
  7. Verify the integrity of the the downloaded files.
  8. Automatically organize downloaded files into media labrary.
  9. Automatically download the latest required components (such as youtube-dl and ffmpeg).
  10. Toast notifications to keep you informed of the status.
  11. Able to use from outside of Japan without VPN.
  12. Update notification when stable version of TVerRec is updated.
  13. GUI is available for Windows.
  14. Specify whether or not downloading is available for each day of the week and time.

How to Use

Please refer to this page on the Wiki for instructions. For any other questions, please check Wiki.

Setting download targets

Please refer to this page on the Wiki for information on how to set up keyword file for download.

Configuration

Please refer to this page on the Wiki for information on how to complete initial setup.

Directory structure

Directory structure is as follows.

TVerRec/
├─ CHANGELOG.md ...................... Change Log
├─ LICENSE ........................... License
├─ README.md ......................... This file
├─ TODO.md ........................... ToDo file
├─ VERSION ........................... Version File
│
├─ bin/ .............................. Directory to store executable files
│
├─ conf/ ............................. Confgurations
│  ├─ ignore.conf ...................... Exclusion list file (automatically created)
│  ├─ keyword.conf ..................... Keyword list file (automatically created)
│  ├─ system_setting.ps1 ............... Default system setting file
│  └─ user_setting.ps1 ................. User setting file
│
├─ db/ ............................... Database
│  ├─ history.csv ...................... Download history file (automatically created)
│  └─ list.csv ......................... Download list file (automatically created)
│
├─ log/ .............................. Log
│  └─ ffmpeg_error_*.log ............... ffmpeg error log file (Automatically created during processing and deleted after a certain period of time)
│
├─ resources/ ........................ Various Resources
│  ├─ b64/ ........................... Images for GUI
│  ├─ colab/ ......................... Sample file for Gooble Colab
│  ├─ crx/ ........................... Gooble Chrome extension
│  │  └─ TVerRecAssistant/ ............. TVerRec Assistant
│  ├─ docker/ ........................ Sample for Docker
│  │  ├─ docker-compose.yaml ........... docker-compose file
│  │  └─ Dockerfile .................... Docker file
│  ├─ img/ ........................... Images
│  ├─ lib/ ........................... Library
│  ├─ lock/ .......................... Lock management files
│  ├─ sample/ ........................ Sample file
│  │  ├─ history.sample.csv ............ Empty download history file
│  │  ├─ ignore.sample.conf ............ Empty exclusion list file
│  │  ├─ keyword.sample.conf ........... Empty keyword list file with examples
│  │  └─ list.sample.csv ............... Empty download list file
│  ├─ wsb/ ........................... Sample of Windows SandBox
│  └─ xaml/ .......................... XAML definition for GUI
│
├─ src/ .............................. Source Files
│  ├─ delete_trash.ps1 ................. Tool to delete junk
│  ├─ download_bulk.ps1 ................ Tool to bulk downlod
│  ├─ download_list.ps1 ................ Tool to list download
│  ├─ download_single.ps1 .............. Tool to individual download
│  ├─ generate_list.ps1 ................ Tool to create download list
│  ├─ generate_list_child.ps1 .......... Tool to support create download list
│  ├─ loop.ps1 ......................... Tool to loop process
│  ├─ move_vide.ps1 .................... Tool to move videos
│  ├─ validate_video.ps1 ............... Tool to integrity check
│  ├─ functions/ ....................... Common Functions
│  │  ├─ common_functions.ps1 ............ Common function
│  │  ├─ initialize.ps1 .................. Initializer
│  │  ├─ initialize_child.ps1 ............ Initializer for child process
│  │  ├─ tver_functions.ps1 .............. TVer function
│  │  ├─ tverrec_functions.ps1 ........... TVerRec function
│  │  ├─ update_ffmpeg.ps1 ............... ffmpeg auto update tool
│  │  ├─ update_tverrec.ps1 .............. TVerRec auto update tool
│  │  └─ update_youtube-dl.ps1 ........... youtube-dl auto update tool
│  └─ gui/ ............................. GUI
│     ├─ gui_main.ps1 .................... GUI version of TVerRec
│     └─ gui_setting.ps1 ................. GUI version of setting tool
│
├─ test/ ............................... Test scripts
│
├─ unix/ ............................. Shellscript for Linux/Mac
│  ├─ a.download_bulk.sh ............... Script to launch bulk download
│  ├─ b.delete_trash.sh ................ Script to launch delete junk
│  ├─ c.validate_video.sh .............. Script to launch integrity check
│  ├─ d.move_video.sh .................. Script to launch move video
│  ├─ start_tverrec.sh ................. Script to launch loop processing
│  ├─ stop_tverrec.sh .................. Script to stop loop processing
│  ├─ update_tverrec.sh ................ Script to update TVerRec
│  ├─ x.generate_list.sh ............... Script to update download list
│  ├─ y.download_list.sh ............... Script to launch list download
│  └─ z.download_single.sh ............. Script to launch induvidual download
│
└─ win/ .............................. CMD files for Windows
   ├─ a.download_bulk.cmd .............. Script to launch bulk download
   ├─ b.delete_trash.cmd ............... Script to launch delete junk
   ├─ c.validate_video.cmd ............. Script to launch integrity check
   ├─ d.move_video.cmd ................. Script to launch move video
   ├─ Setting.cmd ...................... Script to launch GUI version of setting tool
   ├─ start_tverrec.cmd ................ Script to launch loop processing
   ├─ stop_tverrec.cmd ................. Script to stop loop processing
   ├─ TVerRec.cmd ...................... Script to launch GUI version of TVerRec
   ├─ update_tverrec.cmd ............... Script to update TVerRec
   ├─ x.generate_list.cmd .............. Script to update download list
   ├─ y.download_list.cmd .............. Script to launch list download
   └─ z.download_single.cmd ............ Script to launch induvidual download

Precautions

  • Copyright

    • This program is copyrighted by dongaba.
  • Disclaimer

    • The author assumes no responsibility for any damage caused by the use of this software. Use at your own risk.

License

  • TVerRec may be copied, redistributed and/or modified under The MIT License.

Copyright (c) dongaba. All rights reserved.