Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ci7lus/miraktest
Mirakurun 用映像視聴アプリ実装研究資料
https://github.com/ci7lus/miraktest
dtv isdb libvlc macos mirakc mirakurun vlc-libvlc webchimera
Last synced: about 2 months ago
JSON representation
Mirakurun 用映像視聴アプリ実装研究資料
- Host: GitHub
- URL: https://github.com/ci7lus/miraktest
- Owner: ci7lus
- License: mit
- Created: 2021-03-23T18:40:42.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-29T15:38:31.000Z (over 1 year ago)
- Last Synced: 2023-09-29T19:09:36.430Z (over 1 year ago)
- Topics: dtv, isdb, libvlc, macos, mirakc, mirakurun, vlc-libvlc, webchimera
- Language: TypeScript
- Homepage:
- Size: 5.72 MB
- Stars: 56
- Watchers: 5
- Forks: 5
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MirakTest
[](https://github.com/ci7lus/MirakTest/releases)
[](https://github.com/ci7lus/MirakTest/actions/workflows/ci.yml)
[Mirakurun](https://github.com/Chinachu/Mirakurun) 用映像視聴アプリ実装研究資料
## 概要
MirakTest は macOS / Windows / Linux 上で Mirakurun を利用しデジタル放送を視聴するアプリの実装を研究する目的で配布される研究資料です。本アプリに CAS 処理は含まれていないため、デコードされていない放送データを視聴することは出来ません。
macOS / Windows 版ビルドでは [aribb24.js](https://github.com/monyone/aribb24.js) による ARIB-STD-B24 形式の字幕表示に対応しています。
プラグインを導入して機能を拡張することが出来ます。
## 導入方法
### 安定版
各 OS 向けビルドを [Releases](https://github.com/ci7lus/MirakTest/releases) にて配布しています。
#### macOS での実行
```sh
brew install --cask ci7lus/miraktest/miraktest
```
Intel / Apple Silicon mac (aarch64) 上で動作する macOS Monterey / Ventura での動作を確認しています。
#### Windows での実行
exe のインストーラーをダウンロードして実行するか、zip を解凍して使用してください。
Windows 11 での動作を確認しています。
#### Linux での実行
実験的なサポートのため、環境によっては正しく動作しない可能性があります。
PRと発生した問題/解決方法を共有するための Issue は歓迎しますが、Issue は基本的に対応できません。
ハードウェア支援周りの不具合については[こちら](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)。
vlc の導入が必要です。debian の場合は以下のコマンドでインストールできます。
```bash
apt-get install vlc
```
AppImage に実行権限と `--no-sandbox` をつけて実行するか、アーカイブ版の `chrome-sandbox` を適切な権限に設定してください（[参考](https://github.com/Revolutionary-Games/Thrive/issues/749)）。
### 開発版
下記開発手順に沿ってビルドを行うか、CI にてコミット毎にビルドが行われているので、コミットメッセージ右の緑色チェック → Artifacts からダウンロードできます（ログインが必要です）。
## 機能
### プラグイン
プラグインを導入して機能を拡張することが出来ます。
利用できるプラグインの一覧は[こちら](https://github.com/ci7lus/MirakTest/wiki/Userland-Plugin)。
API 仕様は[plugin.ts](./src/types/plugin.ts)を参照してください。
型定義ファイル(`plugin.d.ts`)はリリースにてアプリイメージと一緒に配布しています。
### 操作
- [キーボードショートカット](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)
## 開発
### macOS
```bash
brew install vlc cmake
git clone [email protected]:ci7lus/MirakTest.git
cd MirakTest
yarn
./setup_libvlc_mac.sh
./setup_wcjs.sh
yarn build:tsc
yarn dev:webpack
yarn dev:electron
yarn build
```
[vlc-miraktest](https://github.com/vivid-lapin/vlc-miraktest) の [Releases](https://github.com/vivid-lapin/vlc-miraktest/releases) にある dmg から `VLC.app` を抽出し MirakTest ディレクトリに配置することで、ビルドが aribb24.js を用いるようになります。
### Windows
```powershell
choco install -y cmake powershell-core
git clone [email protected]:ci7lus/MirakTest.git
cd MirakTest
yarn
pwsh .\setup_wcjs.ps1
yarn build:tsc
yarn dev:webpack
yarn dev:electron
yarn build
```
### Linux (debian)
```bash
sudo apt-get install build-essential cmake libvlc-dev vlc
git clone [email protected]:ci7lus/MirakTest.git
cd MirakTest
yarn
./setup_wcjs.sh
yarn build:tsc
yarn dev:webpack
yarn dev:electron
yarn build
```
## 謝辞
MirakTest は次のプロジェクトを利用/参考にして実装しています。
- [Chinachu/Mirakurun](https://github.com/Chinachu/Mirakurun)
- [RSATom/WebChimera.js](https://github.com/RSATom/WebChimera.js)
- [search-future/miyou.tv](https://github.com/search-future/miyou.tv)
- [monyone/aribb24.js](https://github.com/monyone/aribb24.js)
- [tsukumijima/KonomiTV](https://github.com/tsukumijima/KonomiTV)
DTV コミュニティの皆さまに感謝します。
## ライセンス
MirakTest のソースコードは MIT ライセンスの下で提供されますが、ビルド済みパッケージは libVLC を含んでいる場合があり、その場合は LGPLv2.1 または GPLv2 でライセンスされます（[詳細](https://wiki.videolan.org/Frequently_Asked_Questions/)）。ビルド済みパッケージを Releases や Artifacts にて配布する場合は可能な限り周辺情報としてその旨を表示し、パッケージにはライセンス情報を同梱します。