miteiru

Miteiru is an open source Electron video player to learn Japanese. It can play all Youtube and HTML 5 supported format (.mkv, .mp4, .mov, and many more) videos, and lots of supports on other subtitle formats (.srt, .ass, .vtt, and many more)

OTHER License

Stars
35
View Code on GitHub
Ecosystems: Electron, Next

Miteiru (見ている) / zai⁴kan⁴ (在看) / tai²gan² (睇緊)

Disclaimers

About the Developer

Hello! I'm Hocky Yudhiono, the developer behind Miteiru. I created this video player app with the goal of providing a reliable and user-friendly experience for watching your favorite videos.

Commitment to Security

I am dedicated to ensuring that Miteiru is secure and free from any malicious components. However, if you encounter any security issues or vulnerabilities, please reach out to me privately at [email protected] or just submit a GitHub issue, and I will do my best to address and resolve them promptly.

Liability Disclaimer

While I strive to maintain a safe and secure application, I cannot be held responsible for any unintended consequences or damages that may occur from using Miteiru. Use the app at your own risk.

Download ૮ ˶ᵔ ᵕ ᵔ˶ ა✩°｡ ⋆⸜

What can 見ている do?

  • Cross-platform! Available in Windows, MacOS, GNU/Linux.
  • Supports all videos that your chromium supports! In some
    OS's, it supports x265.
  • On-The-Fly Furigana generation! blazing-fast and no severe cache build needed.
  • Instant definition of any terms that uses LevelDB on first start only!
  • Instant definition of any word in the subtitles.
  • Instant definition on Kanji
  • Translation subtitles alongside the Japanese subtitles.
  • Word/Token spacing in the Japanese subtitles
  • Youtube Support

How to start immersing

For Casual Users: Installation Guide

Mac

Windows

  • Being such a good guy I am, I've provided both the portable one and the setup one, you can just
    pick any, install it.
  • There's this issue where some PC would recognize the setup as a virus... but you can try your own
    virus total test.

Ubuntu

  • I made the .deb and .AppImage, currently no other build is provided because I'm too lazy

How to integrate with Whisper

As per February 3rd, 2024 MacWhisper is a really good UI for Whisper in mac, anyway if you want to run whisper on other OS or for free:

put this in your ~/.bashrc or ~/.zshrc or any rc your os use

export WHISPERPATH=~/project/whisper.cpp

whisper() {
  local input="$1"
  shift

  # All remaining arguments will be treated as an array
  local -a extra_args=("$@")
  "$WHISPERPATH/main" -f "$input" -of "$input.w" --model "$WHISPERPATH/models/ggml-medium.bin" -l ja "${extra_args[@]}" -osrt
}

prepwhisper() {
  local input="$1"
  local output="${input%.\*}.wav"
  ffmpeg -i "$input" -ar 16000 -ac 1 -c:a pcm_s16le "$output"
}

Then run on your video

prepwhisper video.mp4
whisper video.wav
  • voila

For Developer: (Own Build) Installation Guide

You can run the followings on the cloned repository: (don't forget to download the LFS files as well)

npm install
npm run script:initrepo
npm run dev # This to run dev
npm run build:nsis # This to build for Windows
npm run build:portable # This to build for Windows Portable
npm run build:linux20 # This to build for Linux 20.04
npm run build:linux22 # This to build for Linux 22.04
npm run build # this is for mac

Mecab and Custom Dictionary Setup (Optional)

Mecab can be downloaded through brew by running:

brew install mecab

or in Ubuntu:

sudo apt install mecab

Then, you can run

which mecab

or in Windows, you can directly download the binary file from SourceForge

to show your default mecab binary file. Use it as the path when asked in Miteiru. Then, you can get JMDict Dictionary in https://github.com/scriptin/jmdict-simplified/releases. Use it as the path when asked in Miteiru as well. Miteiru will build a LevelDB cache locally. Then, you can enjoy the app!

MeCab Dictionary Customization

By default, you are using whatever your default Mecab Dictionary offers you, but you can further customize this by modifying the mecabrc file which is located in /opt/homebrew/etc/mecabrc in MacOS, C:\Program Files (x86)\MeCab\etc\mecabrc in Windows, and /etc/mecabrc in Ubuntu. For other OS's you gotta figure it our for yourself right now. Shunou, Miteiru's microlibrary can support Unidic, Jumandic, Ipadic, and it's variations. Specifically, if you check out the dicrc file of each dictionary, Shunou can support the output format chamame, chasen, and the classic Jumandic god knows what output format. You can get UniDic files here

Configuration file in mac:

;
; Configuration file of MeCab
;
; $Id: mecabrc.in,v 1.3 2006/05/29 15:36:08 taku-ku Exp $;
;
; dicdir =  /opt/homebrew/lib/mecab/dic/ipadic
; dicdir =  /opt/homebrew/lib/mecab/dic/jumandic
dicdir =  /opt/homebrew/lib/mecab/dic/unidic
; userdic = /home/foo/bar/user.dic

; output-format-type = wakati
; input-buffer-size = 8192

; node-format = %m\n
; bos-format = %S\n
; eos-format = EOS\n

Windows:

;
; Configuration file of MeCab
;
; $Id: mecabrc.in,v 1.3 2006/05/29 15:36:08 taku-ku Exp $;
;
dicdir =  $(rcpath)\..\dic\unidic

; userdic = /home/foo/bar/user.dic

; output-format-type = wakati
; input-buffer-size = 8192

; node-format = %m\n
; bos-format = %S\n
; eos-format = EOS\n

Future Enhancements

  • Verb inflections
  • Miteiru will be ported to a dedicated media player, like LibVLC or MPV.
  • Kanji explanation in the subtitles with animated diagrams.
  • Pronounciation audio
  • Customizable subtitle style.
  • Online hosted videos.
  • Will support Android.
  • Miteiru will have built-in Tokenizer and Dictionary, and supports French, German, Bahasa
    Indonesia, and many more.
  • Miteiru will support Korean too!

https://user-images.githubusercontent.com/19528709/236619520-076c863a-6c14-4f6e-8f9b-5d1e660fd646.mp4

Badges
Extracted from project README
Star History Chart License: CC BY-NC-SA 4.0