Repolode
Submit
BeerEgg2001

BeerEgg2001/Komorebi

An Android TV and Fire TV client for watching and recording DTV programs through KonomiTV, EDCB, EPGStation, or Mirakurun backends.

View on GitHub
Stars
169
Forks
14
Open issues
6
Last commit
10 days ago

What is it?

Komorebi is an Android TV client for watching live Japanese digital TV and playing back recordings from a home recording server. It connects to KonomiTV, EDCB, EPGStation (a fork by stuayu), or Mirakurun, and lets users browse the EPG, make recording reservations, and manage their recorded library from the TV remote.

The app is built with Kotlin and Jetpack Compose for TV, using Media3 (ExoPlayer) for playback and libVLC for SMB file library playback. It supports ARIB subtitles through a native libaribcaption integration, automatic CM chapter skipping, and a picture-in-picture mode. Because it is not distributed through the Google Play store, it is installed from APK files on the GitHub Releases page, using Downloader or adb.

The project requires a configured backend and, for EDCB, extra Lua scripts and a configurator tool. It is aimed at users who already run one of the supported recording systems and want a remote-friendly viewer on Fire TV or Android TV.

Key features

  • 01Browse and play live channels, the EPG, and recordings from KonomiTV, EDCB, EPGStation, or Mirakurun.
  • 02Make recording reservations from the EPG, including keyword rules, duplicate handling, and priorities.
  • 03Skip commercial breaks automatically using TvtPlay, Amatsukaze, or KonomiTV chapter data.
  • 04Play video files from SMB network shares with libVLC, including external chapter files.
  • 05Render ARIB subtitles natively and support picture-in-picture while watching.

Use cases

  • Watching live Japanese TV on a Fire TV Stick or Android TV with a home recording server.
  • Browsing and reserving programs from the couch using only the TV remote.
  • Playing back recorded programs or NAS video files with CM skipping.

Quick start

  1. 1

    Allow apps from unknown sources on your TV (Fire TV or Android TV settings)

  2. 2

    Download the Universal APK from the GitHub Releases page or via Downloader, then install it

  3. 3

    On first launch, enter the IP address and port of your backend (KonomiTV, EDCB, EPGStation, or Mirakurun)

Things to know

  • Not distributed through Google Play or other app stores; it must be sideloaded as an APK.
  • Requires an existing KonomiTV, EDCB, EPGStation, or Mirakurun backend to be useful.
  • EPGStation login authentication is not supported, and only the stuayu fork has been verified.

In collections

Android apps & phone tools

Topics

#dtv#android-tv#fire-tv#kotlin#jetpack-compose#media-player#video-streaming#epg#edcb#exoplayer

FAQ

What is Komorebi?
An Android TV and Fire TV client for watching and recording DTV programs through KonomiTV, EDCB, EPGStation, or Mirakurun backends. Komorebi is an Android TV client for watching live Japanese digital TV and playing back recordings from a home recording server. It connects to KonomiTV, EDCB, EPGStation (a fork by stuayu), or Mirakurun, and lets users browse the EPG, make recording reservations, and manage their recorded library from the TV remote.
Is Komorebi free to use? What license does it have?
Komorebi is open source under the MIT license. Check the license terms before using it in commercial products.
Is Komorebi still maintained?
Actively maintained. The last commit to Komorebi was on Oct 28, 2026.
What can I use Komorebi for?
Watching live Japanese TV on a Fire TV Stick or Android TV with a home recording server. Browsing and reserving programs from the couch using only the TV remote. Playing back recorded programs or NAS video files with CM skipping.
How do I install Komorebi?
Allow apps from unknown sources on your TV (Fire TV or Android TV settings) Download the Universal APK from the GitHub Releases page or via Downloader, then install it On first launch, enter the IP address and port of your backend (KonomiTV, EDCB, EPGStation, or Mirakurun)
Where can I get Komorebi?
The source code and installation instructions are on GitHub: https://github.com/BeerEgg2001/Komorebi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

Chinachu / Mirakurun

A TypeScript API server that manages Japanese digital TV tuner devices on Linux and Docker, exposing streams, EPG and IPTV playlists.

Backend & APIs#dvb#isdb#tv-tuner
789+2 this week134TypeScriptApache-2.0Updated 24 hours ago