KonomiTV  by tsukumijima

Web media server for TV and recordings

created 3 years ago
776 stars

Top 45.9% on sourcepulse

GitHubView on GitHub
Project Summary

KonomiTV is a modern, web-based TV media server designed for comfortable viewing of live TV and recordings across various devices. It aims to provide a seamless, "Netflix-like" user experience for Japanese TV broadcasting, abstracting away the complexities of traditional TV viewing setups.

How It Works

KonomiTV acts as a unified interface, connecting to backend TV tuner software like EDCB or Mirakurun/mirakc. It leverages hardware-accelerated encoding (QSVEncC, NVEncC, VCEEncC, rkmppenc) for efficient streaming, offering features like real-time viewing with comments, recorded program playback with a polished UI, watchlists, and viewing history. The architecture prioritizes user experience by hiding underlying technical details, such as tuner sharing and on-the-fly quality adjustments.

Quick Start & Requirements

  • Installation: A CLI-based installer (KonomiTV-Installer.elf for Linux, KonomiTV-Installer.exe for Windows) is provided.
  • Prerequisites:
    • Backend: EDCB (v220122+) or Mirakurun/mirakc (v3.9.0+ recommended).
    • OS: Windows 10/11 (64-bit) or Linux (Ubuntu 20.04 LTS / Debian 11 Bullseye+).
    • GPU Drivers: Required for hardware encoding (Intel Media Driver for QSVEncC on Linux, NVIDIA drivers for NVEncC, AMDGPU-PRO for VCEEncC).
    • Remote Access: Tailscale is recommended and officially supported for out-of-home viewing.
    • Browser: Google Chrome is highly recommended for client access.
  • Setup: Requires configuration of the chosen backend (EDCB/Mirakurun) and potentially GPU drivers. Detailed setup guides are available.

Highlighted Details

  • Offers a "Netflix-like" UI for recorded TV programs, including playback history and watchlists.
  • Supports real-time TV viewing with integrated social media comments (Nico Nico Douga, Twitter).
  • Leverages hardware encoding for efficient streaming, reducing CPU load.
  • Provides remote access via Tailscale for seamless viewing outside the home network.

Maintenance & Community

  • Actively developed, with frequent updates and a focus on user feedback.
  • Community support channels are not explicitly mentioned, but feedback is encouraged via Google Forms.
  • The project acknowledges significant contributions from several individuals.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: Generally compatible with commercial use due to the MIT license. However, specific dependencies or bundled software might have different terms.

Limitations & Caveats

  • The project is still in beta, with potential for breaking changes in configuration and features.
  • Support for older OS versions or non-Ubuntu/Debian Linux distributions is limited or non-existent.
  • Some client features (like Picture-in-Picture on iOS Safari) may be affected by browser bugs.
  • Specific hardware configurations (e.g., older Intel CPUs for QSVEncC on Linux) may not be supported.
Health Check
Last commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
2
Issues (30d)
0
Star History
38 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.