Home

NHK-TS Wiki

Welcome to the official wiki for NHK-TS – a specialised command-line tool for managing NHK World Japan TVHeadEnd satellite recordings. This wiki provides detailed documentation, guides, and resources for archivists, enthusiasts, and developers.

Table of Contents

• Overview
• Getting Started
• Usage Examples
• Docker Usage
• TVHeadEnd Setup
• Configuration
• Development Guide
• FAQ
• Roadmap
• Sponsoring

---

Overview

NHK-TS automates the identification of programme boundaries, manages metadata, and optimises recordings for modern media servers. It is designed for use with TVHeadEnd .ts recordings and integrates with TheTVDB for rich metadata.

Key Features:

• Precise Programme Detection: Identifies exact programme start and end times using black frame analysis and silence detection during the first and last few minutes of recordings
• TVDB Integration: Automatically retrieves and parses programme names, years, and episode information from TheTVDB
• Intelligent Caching: Minimises TVDB API requests by caching programme metadata locally
• Format Optimisation: Transcodes 1080i interlaced content into 1080p progressive format with configurable quality presets
• Hardware Acceleration: Supports NVIDIA NVENC, Intel QSV, and AMD VA-API for faster transcoding
• Flexible Output: Supports both MKV and MP4 containers for compatibility with:
  • Plex
  • Jellyfin
  • Emby
  • VLC
  • Kodi
  • MPV
  • Other modern media players

Additional Capabilities:

• Automatic hardware encoder detection and optimal settings selection with the --best flag
• Blacklist support for skipping unwanted programmes
• Parallel frame processing for improved performance
• Comprehensive logging and debugging options

For detailed instructions, please refer to the sections in the Table of Contents above.