https://github.com/bubio/xm8mac
PC-8801 emulator for macOS and other platforms
https://github.com/bubio/xm8mac
android emulator linux mac macos pc-88 pc-8801 pc88 pc8801 raspberry-pi raspberrypi windows
Last synced: 4 months ago
JSON representation
PC-8801 emulator for macOS and other platforms
- Host: GitHub
- URL: https://github.com/bubio/xm8mac
- Owner: bubio
- License: gpl-2.0
- Created: 2023-02-20T12:15:45.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-09-03T12:56:41.000Z (9 months ago)
- Last Synced: 2025-09-03T14:39:30.935Z (9 months ago)
- Topics: android, emulator, linux, mac, macos, pc-88, pc-8801, pc88, pc8801, raspberry-pi, raspberrypi, windows
- Language: C++
- Homepage:
- Size: 1.4 MB
- Stars: 19
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# XM8 for macOS
---
[](https://github.com/bubio/xm8mac/releases/latest)
## XM8 for macOSとは
---
XM8は、ＰＩ．さんが開発したマルチプラットフォーム（Windows/Linux/Android）に対応したPC-8801MA(PC-8801mkIISR上位互換)のエミュレータをmacOS用に改変したものです。
このリポジトリは ＰＩ．さんから許可をいただき作成しています。
公式では配布されていないmacOS版の開発を主に行なっていきますが、Windows/Linux/Android版もできる限り配布します。
公式はこちらです。
http://retropc.net/pi/xm8/index.html
## インストール方法
---
[リリース](https://github.com/bubio/xm8mac/releases)からお手持ちの環境にあった実行ファイルをダウンロードしてください。
`XM8.app`を`アプリケーション`フォルダに移動するなどして実行してください。
### 動作環境
| CPU | 最小OSバージョン | 実行ファイル |
| ------------- | ------------------- | ------------------------------------------------------------ |
| x86_64 | macOS 10.13 High Sierra | [x86_64版](https://github.com/bubio/xm8mac/releases/download/1.7.6/XM8_macOS_Universal.dmg) |
| Apple Silicon | macOS 11 Big Sur | [Apple Silicon版](https://github.com/bubio/xm8mac/releases/download/1.7.6/XM8_macOS_Universal.dmg) |
その他のOSはリリースを見てください。
## ROMファイル
---
使用できるROMファイルについては、[README-XM8.txt](Documents/README-XM8.txt)の[ROMファイル]を参照してください。
### 配置場所
ROMファイルの配置場所は、設定ファイルと同じ以下になります（一度、アプリケーションを起動するとフォルダが作成されます）。
```shell
"~/Library/Application Support/retro_pc_pi/xm8"
```
## 使用方法
---
[README-XM8.txt](Documents/README-XM8.txt)の[使い方]を参照してください。
## ビルド方法
---
### ビルド環境
ビルドするには以下のインストールが必要です。
- Xcode
使うのはコマンドラインツールだけですが、Xcodeをインストールしてしまうのが手っ取り早いと思います。
- Homebrew
[Homebrew](https://brew.sh/)のインストールが必要です。
cmakeなどビルドに必要なツールの取得に使用します。
### ビルド手順
プロジェクトのルートをターミナルで開き、以下のコマンドを実行します。
```shell
cd Builder/macOS
./dist_app.sh
```
これでbuildフォルダに実行ファイル(.app)が作成されているはずです。
## 謝辞
---
ソースコードの改変を快諾してくださったＰＩ．氏にお礼申し上げます。
## その他のOS
---
### Windows版
----
Builder/WindowsフォルダにVisual Studio 2022用のソリューションが入っています。
Builder/Windowsフォルダにあるsetup_sdl2.ps1を実行すると、ビルドに必要なSDL2をダウンロードして適切な場所に配置します。
以下のようになります。
- Builder\Windows\SDL\include（インクルードファイル）
- Builder\Windows\SDL\lib\x86（x86向けライブラリ）
- Builder\Windows\SDL\lib\x64（x64向けライブラリ）
- Builder\Windows\SDL\lib\arm64（arm64向けライブラリ）
Builder/Windows/XM8.sln をVisual Studioでビルドします。
Builder/Windows/x64、Builder/Windows/Win32、Builder/Windows/ARM64に出力されます。実行に必要なのは、XM8.exeとSDL2.dllです。
BIOS ROMファイルの置き場所は以下になります。
```shell
%appdata%\retro_pc_pi\xm8
```
### Linux版
----
Builder/Linuxフォルダにdeb, rpm, appimageパッケージを作成するスクリプトが入っています。
ビルドに必要なライブラリは、dist_app.shを参照してください。
### deb or rpm
```shell
cd Builder/Linux
./dist_app.sh
```
これでbuildフォルダにdebファイル、またはrpmファイルが作成されます。
### appimage
```shell
cd Builder/Linux
./appimage.sh
```
これでBuilder/Linuxフォルダに、appimageファイルが作成されます。
BIOS ROMファイルの置き場所は以下になります。
```shell
~/.local/share/retro_pc_pi/xm8/
```
### Android版
----
Builder/AndroidフォルダにAndroid Studio用のプロジェクトが入っています。
Builder/Androioフォルダにあるsetup_sdl2.shを実行すると、ビルドに必要なSDL2をダウンロードして適切な場所に配置します。
以下のようになります。
- Builder/Android/app/jni/SDL\include（インクルードファイル）
- Builder/Android/app/jni/SDL\src（ソースファイル）
- Builder/Android/app/src/java/org/libsdl/app（Javaソースファイル）
Builder/AndroidをAndroid Studioで開いてビルドします。
BIOS ROMファイルの置き場所は以下になります。
```shell
Android/data/retro_pc_pi/files/
```
Android 11以上の場合、端末内のファイルに自由にアクセスすることができません。
ゲームのディスクイメージも同じ場所に入れることを推奨します。
## 使用しているOSSのライセンス
- xBRZ
https://sourceforge.net/projects/xbrz/
GNU General Public License version 3.0 (GPLv3)