{"id":15198692,"url":"https://github.com/hockyy/miteiru","last_synced_at":"2025-04-07T15:08:00.546Z","repository":{"id":92261339,"uuid":"574530896","full_name":"hockyy/miteiru","owner":"hockyy","description":"Miteiru is an open source Electron video player to learn Chinese, Cantonese, and 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)","archived":false,"fork":false,"pushed_at":"2024-12-29T07:43:15.000Z","size":5551,"stargazers_count":88,"open_issues_count":14,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-06T05:56:15.899Z","etag":null,"topics":["anime","cantonese","chinese","electron","hanzi","hiragana","japanese","jieba","jmdict","jyutping","kanji","katakana","kuromoji","mecab","player","subtitle","video","video-player"],"latest_commit_sha":null,"homepage":"https://miteiru.hocky.id","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hockyy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"hockyy"}},"created_at":"2022-12-05T14:12:52.000Z","updated_at":"2025-03-15T04:38:02.000Z","dependencies_parsed_at":"2025-01-01T00:09:27.439Z","dependency_job_id":"de310593-442d-4a1a-9116-7cc9a1e4e737","html_url":"https://github.com/hockyy/miteiru","commit_stats":{"total_commits":546,"total_committers":2,"mean_commits":273.0,"dds":"0.012820512820512775","last_synced_commit":"800ed1ab861b1124c702ef55b76f63413a0669bf"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hockyy%2Fmiteiru","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hockyy%2Fmiteiru/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hockyy%2Fmiteiru/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hockyy%2Fmiteiru/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hockyy","download_url":"https://codeload.github.com/hockyy/miteiru/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675597,"owners_count":20977376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anime","cantonese","chinese","electron","hanzi","hiragana","japanese","jieba","jmdict","jyutping","kanji","katakana","kuromoji","mecab","player","subtitle","video","video-player"],"created_at":"2024-09-28T01:24:26.808Z","updated_at":"2025-04-07T15:08:00.524Z","avatar_url":"https://github.com/hockyy.png","language":"TypeScript","funding_links":["https://github.com/sponsors/hockyy"],"categories":["Video","Open Source"],"sub_categories":["Other textbooks","Categories"],"readme":"# Miteiru (見ている) / zai⁴kan⁴ (在看) / tai²gan² (睇緊)\n\n![Stargazers repo roster for @hocky/miteiru](https://bytecrank.com/nastyox/reporoster/php/stargazersSVG.php?user=hockyy\u0026repo=miteiru)\n[![Star History Chart](https://api.star-history.com/svg?repos=hockyy/miteiru\u0026type=Date)](https://star-history.com/#hockyy/miteiru\u0026Date)\n[![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-blue.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)\n![GitHub release](https://img.shields.io/github/release/hockyy/miteiru.svg?color=purple)\n![Open Issues](https://img.shields.io/github/issues/hockyy/miteiru?color=green)\n![Contributors](https://img.shields.io/github/contributors/hockyy/miteiru)\n![Last Commit](https://img.shields.io/github/last-commit/hockyy/miteiru)\n![GitHub Stars](https://img.shields.io/github/stars/hockyy/miteiru.svg?color=yellow)\n![GitHub Forks](https://img.shields.io/github/forks/hockyy/miteiru.svg)\n\n## Disclaimers\n### About the Developer\nHello! 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.\n\n### Commitment to Security\n\nI 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 [miteiru@hocky.id](mailto:miteiru@hocky.id) or just submit a GitHub issue, and I will do my best to address and resolve them promptly.\n\n### Liability Disclaimer\nWhile 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**.\n\n## Download ૮ ˶ᵔ ᵕ ᵔ˶ ა✩°｡ ⋆⸜\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/hockyy/miteiru/releases/latest\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"\"\u003e\n\u003cimg width=\"9%\" src=\"./renderer/public/images/kiwi.png\" alt=\"kiwi\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hockyy/miteiru/releases/latest\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"\"\u003e\n\u003cimg width=\"60%\" src=\"./renderer/public/images/downloadBanner.gif\" alt=\"banner\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/hockyy/miteiru/releases/latest\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"\"\u003e\n\u003cimg width=\"7%\" src=\"./renderer/public/images/pome.png\" alt=\"pomegranate\"/\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n\u003ctable style=\"border: none;\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"renderer/public/images/logo.png\" alt=\"Miteiru Logo\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e Miteiru is an open source Electron video player to learn Chinese, Japanese, and Cantonese. It has modular main language dictionary and tokenizer (morphological analyzer), heavily based on External software \u003ca href=\"https://taku910.github.io/mecab/\"\u003eMeCab\u003c/a\u003e, and optinally needs \u003ca href=\"https://github.com/scriptin/jmdict-simplified\"\u003eJMDict\u003c/a\u003e to give language info box. This software is heavily inspired by \u003ca href=\"https://ookii-tsuki.github.io/Anisubber/\"\u003eAnisubber\u003c/a\u003e. \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## What can 見ている do?\n\n- Cross-platform! Available in Windows, MacOS, GNU/Linux.\n- Supports all videos that your [chromium](https://www.chromium.org/audio-video/) supports! In some\n  OS's, it supports **x265**.\n- On-The-Fly Furigana generation! blazing-fast and no severe cache build needed.\n- Instant definition of any terms that uses LevelDB on first start only!\n- Instant definition of any word in the subtitles.\n- Instant definition on Kanji\n- Translation subtitles alongside the Japanese subtitles.\n- Word/Token spacing in the Japanese subtitles\n- Youtube Support\n\n## How to start immersing\n\n- For the first run, you can press this button, and wait for about 2 minutes because it is caching\n  the japanese dictionary..\n- ![image](https://github.com/hockyy/miteiru/assets/19528709/6d8bcf4f-73dd-4cfb-8a6f-4bbf7e10a25a)\n- You can start by dragging:\n    - Any videos (Anime is good) you can get subtitle at https://kitsunekko.net/\n    - Any youtube URL\n        - Or you can just literally paste any youtube watch video into the miteiru (just ctrl + v\n          into the player)\n        - But youtube japanese will only show for videos that have japanese CC or auto-generated\n          japanese CC.\n        - Try this:\n            - https://www.youtube.com/results?search_query=onomappu\n            - https://www.youtube.com/results?search_query=nihongo+no+mori+kenshi+yonezu\n            - https://www.youtube.com/@funtv8964\n            - https://www.youtube.com/@mm.millmilk\n            - ![image](https://github.com/hockyy/miteiru/assets/19528709/b97c3ef1-18ee-40d4-a0ab-ff7d9de81d66)\n            - ![image](https://github.com/hockyy/miteiru/assets/19528709/c5e21a69-6cdb-47c9-a842-ad97b81125be)\n\n- Press `X` and `Z` for the configs\n- Just read the front page's keyboard shortcut, you can press `Q` to go back to the front page.\n- ![image](https://github.com/hockyy/miteiru/assets/19528709/46cd3065-29cf-4d0a-957b-62ef28386693)\n- ![image](https://github.com/hockyy/miteiru/assets/19528709/2b54c704-019d-47c1-b183-55ad350c4b18)\n- Profit 💰\n\n## For Casual Users: Installation Guide\n\n- Checkout releases here: https://github.com/hockyy/miteiru/releases\n\n### Mac\n\n- Download the .pkg file\n- Because I'm too poor to afford the so called 99 USD apple developer program annual fee, you will\n  encounter the unidentified developer warning.\n    - No worry, all codes are open source and I have no intend to harm your Mac... You can even\n      build your own app by following the developer guide below\n- Run it this\n  way: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac\n- ![image](https://github.com/hockyy/miteiru/assets/19528709/a440a119-49cf-45f1-8c42-93289d20e01e)\n\n### Windows\n\n- Being such a good guy I am, I've provided both the portable one and the setup one, you can just\n  pick any, install it.\n- There's this issue where some PC would recognize the setup as a virus... but you can try your own\n  virus total test.\n\n### Ubuntu\n\n- I made the .deb and .AppImage, currently no other build is provided because I'm too lazy\n\n## How to integrate with Whisper\n\u003e As per February 3rd, 2024 [MacWhisper](https://goodsnooze.gumroad.com/l/macwhisper) is a really good UI for Whisper in mac, anyway if you want to run whisper on other OS or for free:\n\n- clone this\n  repo [git@github.com:ggerganov/whisper.cpp.git](https://github.com/ggerganov/whisper.cpp)\n- install ffmpeg\n- `cd whisper.cpp \u0026\u0026 bash ./models/download-ggml-model.sh large`\n\nput this in your ~/.bashrc or ~/.zshrc or any rc your os use\n\n```  \nexport WHISPERPATH=~/project/whisper.cpp\n\nwhisper() {\n  local input=\"$1\"\n  shift\n\n  # All remaining arguments will be treated as an array\n  local -a extra_args=(\"$@\")\n  \"$WHISPERPATH/main\" -f \"$input\" -of \"$input.w\" --model \"$WHISPERPATH/models/ggml-medium.bin\" -l ja \"${extra_args[@]}\" -osrt\n}\n\nprepwhisper() {\n  local input=\"$1\"\n  local output=\"${input%.\\*}.wav\"\n  ffmpeg -i \"$input\" -ar 16000 -ac 1 -c:a pcm_s16le \"$output\"\n}\n```\n\nThen run on your video\n\n```\nprepwhisper video.mp4\nwhisper video.wav\n```\n\n- voila\n\n## For Developer: (Own Build) Installation Guide\n\nYou can run the followings on the cloned repository: (don't forget to download the LFS files as\nwell)\n\n```bash\nnpm install\nnpm run script:initrepo\nnpm run dev # This to run dev\nnpm run build:nsis # This to build for Windows\nnpm run build:portable # This to build for Windows Portable\nnpm run build:linux20 # This to build for Linux 20.04\nnpm run build:linux22 # This to build for Linux 22.04\nnpm run build # this is for mac\n```\n\n## Mecab and Custom Dictionary Setup (Optional)\n\nMecab can be downloaded through [brew](https://brew.sh/) by running:\n\n```bash\nbrew install mecab\n```\n\nor in Ubuntu:\n\n```bash\nsudo apt install mecab\n```\n\nThen, you can run\n\n```bash\nwhich mecab\n```\n\nor in Windows, you can directly download the binary file\nfrom [SourceForge](https://sourceforge.net/projects/mecab/)\n\nto show your default mecab binary file. Use it as the path when asked in Miteiru. Then, you can get\nJMDict Dictionary\nin [https://github.com/scriptin/jmdict-simplified/releases](https://github.com/scriptin/jmdict-simplified/releases).\nUse it as the path when asked in Miteiru as well. Miteiru will build a LevelDB cache locally. Then,\nyou can enjoy the app!\n\n## MeCab Dictionary Customization\n\nBy default, you are using whatever your default Mecab Dictionary offers you, but you can further\ncustomize this by modifying the `mecabrc` file which is located in `/opt/homebrew/etc/mecabrc` in\nMacOS, `C:\\Program Files (x86)\\MeCab\\etc\\mecabrc` in Windows, and `/etc/mecabrc` in Ubuntu. For\nother OS's you gotta figure it our for yourself right now. Shunou, Miteiru's microlibrary can\nsupport Unidic, Jumandic, Ipadic, and it's variations. Specifically, if you check out the `dicrc`\nfile of each dictionary, Shunou can support the output format `chamame`, `chasen`, and the classic\nJumandic god knows what output format. You can\nget [UniDic files here](https://clrd.ninjal.ac.jp/unidic/en/)\n\nConfiguration file in mac:\n\n```\n;\n; Configuration file of MeCab\n;\n; $Id: mecabrc.in,v 1.3 2006/05/29 15:36:08 taku-ku Exp $;\n;\n; dicdir =  /opt/homebrew/lib/mecab/dic/ipadic\n; dicdir =  /opt/homebrew/lib/mecab/dic/jumandic\ndicdir =  /opt/homebrew/lib/mecab/dic/unidic\n; userdic = /home/foo/bar/user.dic\n\n; output-format-type = wakati\n; input-buffer-size = 8192\n\n; node-format = %m\\n\n; bos-format = %S\\n\n; eos-format = EOS\\n\n```\n\nWindows:\n\n```\n;\n; Configuration file of MeCab\n;\n; $Id: mecabrc.in,v 1.3 2006/05/29 15:36:08 taku-ku Exp $;\n;\ndicdir =  $(rcpath)\\..\\dic\\unidic\n\n; userdic = /home/foo/bar/user.dic\n\n; output-format-type = wakati\n; input-buffer-size = 8192\n\n; node-format = %m\\n\n; bos-format = %S\\n\n; eos-format = EOS\\n\n```\n\n## Future Enhancements\n\n- Verb inflections\n- Miteiru will be ported to a dedicated media player, like LibVLC or MPV.\n- Kanji explanation in the subtitles with animated diagrams.\n- Pronounciation audio\n- Customizable subtitle style.\n- Online hosted videos.\n- Will support Android.\n- Miteiru will have built-in Tokenizer and Dictionary, and supports French, German, Bahasa\n  Indonesia, and many more.\n- Miteiru will support Korean too!\n\nhttps://user-images.githubusercontent.com/19528709/236619520-076c863a-6c14-4f6e-8f9b-5d1e660fd646.mp4\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhockyy%2Fmiteiru","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhockyy%2Fmiteiru","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhockyy%2Fmiteiru/lists"}