{"id":20865035,"url":"https://github.com/ci7lus/miraktest","last_synced_at":"2025-05-12T10:32:14.052Z","repository":{"id":37905151,"uuid":"350820063","full_name":"ci7lus/MirakTest","owner":"ci7lus","description":"Mirakurun 用映像視聴アプリ実装研究資料","archived":false,"fork":false,"pushed_at":"2023-09-29T15:38:31.000Z","size":6001,"stargazers_count":63,"open_issues_count":14,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-01T05:41:31.505Z","etag":null,"topics":["dtv","isdb","libvlc","macos","mirakc","mirakurun","vlc-libvlc","webchimera"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ci7lus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-03-23T18:40:42.000Z","updated_at":"2024-10-20T05:19:52.000Z","dependencies_parsed_at":"2023-02-17T23:01:21.653Z","dependency_job_id":"837f2a5f-e777-4f4c-be25-ac3bda611e45","html_url":"https://github.com/ci7lus/MirakTest","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":"vivid-lapin/ts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ci7lus%2FMirakTest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ci7lus%2FMirakTest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ci7lus%2FMirakTest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ci7lus%2FMirakTest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ci7lus","download_url":"https://codeload.github.com/ci7lus/MirakTest/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253720062,"owners_count":21952954,"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":["dtv","isdb","libvlc","macos","mirakc","mirakurun","vlc-libvlc","webchimera"],"created_at":"2024-11-18T05:46:33.739Z","updated_at":"2025-05-12T10:32:12.284Z","avatar_url":"https://github.com/ci7lus.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MirakTest\n\n[![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/ci7lus/MirakTest?include_prereleases)](https://github.com/ci7lus/MirakTest/releases)\n[![CI](https://github.com/ci7lus/MirakTest/actions/workflows/ci.yml/badge.svg)](https://github.com/ci7lus/MirakTest/actions/workflows/ci.yml)\n\n[Mirakurun](https://github.com/Chinachu/Mirakurun) 用映像視聴アプリ実装研究資料\u003cbr /\u003e\n\n## 概要\n\nMirakTest は macOS / Windows / Linux 上で Mirakurun を利用しデジタル放送を視聴するアプリの実装を研究する目的で配布される研究資料です。本アプリに CAS 処理は含まれていないため、デコードされていない放送データを視聴することは出来ません。\u003cbr /\u003e\nmacOS / Windows 版ビルドでは [aribb24.js](https://github.com/monyone/aribb24.js) による ARIB-STD-B24 形式の字幕表示に対応しています。\u003cbr /\u003e\nプラグインを導入して機能を拡張することが出来ます。\n\n## 導入方法\n\n### 安定版\n\n各 OS 向けビルドを [Releases](https://github.com/ci7lus/MirakTest/releases) にて配布しています。\n\n#### macOS での実行\n\n```sh\nbrew install --cask ci7lus/miraktest/miraktest\n```\n\nIntel / Apple Silicon mac (aarch64) 上で動作する macOS Monterey / Ventura での動作を確認しています。\u003cbr /\u003e\n\n#### Windows での実行\n\nexe のインストーラーをダウンロードして実行するか、zip を解凍して使用してください。\u003cbr /\u003e\nWindows 11 での動作を確認しています。\n\n#### Linux での実行\n\n実験的なサポートのため、環境によっては正しく動作しない可能性があります。\u003cbr\u003e\nPRと発生した問題/解決方法を共有するための Issue は歓迎しますが、Issue は基本的に対応できません。\u003cbr\u003e\nハードウェア支援周りの不具合については[こちら](https://github.com/ci7lus/MirakTest/wiki/Linux-%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B-libVLC-%E3%81%AE%E3%83%8F%E3%83%BC%E3%83%89%E3%82%A6%E3%82%A7%E3%82%A2%E6%94%AF%E6%8F%B4%E5%91%A8%E3%82%8A%E3%81%AE%E4%B8%8D%E5%85%B7%E5%90%88%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)。\u003cbr /\u003e\nvlc の導入が必要です。debian の場合は以下のコマンドでインストールできます。\n\n```bash\napt-get install vlc\n```\n\nAppImage に実行権限と `--no-sandbox` をつけて実行するか、アーカイブ版の `chrome-sandbox` を適切な権限に設定してください（[参考](https://github.com/Revolutionary-Games/Thrive/issues/749)）。\n\n### 開発版\n\n下記開発手順に沿ってビルドを行うか、CI にてコミット毎にビルドが行われているので、コミットメッセージ右の緑色チェック → Artifacts からダウンロードできます（ログインが必要です）。\n\n## 機能\n\n### プラグイン\n\nプラグインを導入して機能を拡張することが出来ます。\u003cbr /\u003e\n利用できるプラグインの一覧は[こちら](https://github.com/ci7lus/MirakTest/wiki/Userland-Plugin)。\u003cbr /\u003e\nAPI 仕様は[plugin.ts](./src/types/plugin.ts)を参照してください。\u003cbr /\u003e\n型定義ファイル(`plugin.d.ts`)はリリースにてアプリイメージと一緒に配布しています。\n\n### 操作\n\n- [キーボードショートカット](https://github.com/ci7lus/MirakTest/wiki/%E3%82%AD%E3%83%BC%E3%83%9C%E3%83%BC%E3%83%89%E3%82%B7%E3%83%A7%E3%83%BC%E3%83%88%E3%82%AB%E3%83%83%E3%83%88)\n\n## 開発\n\n### macOS\n\n```bash\nbrew install vlc cmake\ngit clone git@github.com:ci7lus/MirakTest.git\ncd MirakTest\nyarn\n./setup_libvlc_mac.sh\n./setup_wcjs.sh\nyarn build:tsc\nyarn dev:webpack\nyarn dev:electron\nyarn build\n```\n\n[vlc-miraktest](https://github.com/vivid-lapin/vlc-miraktest) の [Releases](https://github.com/vivid-lapin/vlc-miraktest/releases) にある dmg から `VLC.app` を抽出し MirakTest ディレクトリに配置することで、ビルドが aribb24.js を用いるようになります。\n\n### Windows\n\n```powershell\nchoco install -y cmake powershell-core\ngit clone git@github.com:ci7lus/MirakTest.git\ncd MirakTest\nyarn\npwsh .\\setup_wcjs.ps1\nyarn build:tsc\nyarn dev:webpack\nyarn dev:electron\nyarn build\n```\n\n### Linux (debian)\n\n```bash\nsudo apt-get install build-essential cmake libvlc-dev vlc\ngit clone git@github.com:ci7lus/MirakTest.git\ncd MirakTest\nyarn\n./setup_wcjs.sh\nyarn build:tsc\nyarn dev:webpack\nyarn dev:electron\nyarn build\n```\n\n## 謝辞\n\nMirakTest は次のプロジェクトを利用/参考にして実装しています。\n\n- [Chinachu/Mirakurun](https://github.com/Chinachu/Mirakurun)\n- [RSATom/WebChimera.js](https://github.com/RSATom/WebChimera.js)\n- [search-future/miyou.tv](https://github.com/search-future/miyou.tv)\n- [monyone/aribb24.js](https://github.com/monyone/aribb24.js)\n- [tsukumijima/KonomiTV](https://github.com/tsukumijima/KonomiTV)\n\nDTV コミュニティの皆さまに感謝します。\n\n## ライセンス\n\nMirakTest のソースコードは MIT ライセンスの下で提供されますが、ビルド済みパッケージは libVLC を含んでいる場合があり、その場合は LGPLv2.1 または GPLv2 でライセンスされます（[詳細](https://wiki.videolan.org/Frequently_Asked_Questions/)）。ビルド済みパッケージを Releases や Artifacts にて配布する場合は可能な限り周辺情報としてその旨を表示し、パッケージにはライセンス情報を同梱します。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fci7lus%2Fmiraktest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fci7lus%2Fmiraktest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fci7lus%2Fmiraktest/lists"}