Skip to content

Commit e027aae

Browse files
authored
restructure
1 parent 2159987 commit e027aae

File tree

1 file changed

+29
-27
lines changed

1 file changed

+29
-27
lines changed

README.md

Lines changed: 29 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6,26 +6,13 @@ All you need to [spend time](overboot.asm) on a [desert island](#play-offline).
66

77
#### Online
88

9-
Try [**jVGS**](https://reefactor.github.io/zx-spectrum-instapack/emul/jVGS/jvgs-offline.html) ZX-Spectrum emulator
10-
or [**Qaop** v1.4](https://reefactor.github.io/zx-spectrum-instapack/emul/QAOP/qaop.html#ay#128) online
11-
12-
13-
#### ZXBOX VM
14-
Download [ZXBOX](https://app.vagrantup.com/reefactor/boxes/ZXBOX) VM from vagrant cloud.
15-
ZXBOX is [based on](build_zxbox.sh) Ubuntu20.04 + zx-spectrum instapack. You can [build your own version from sources](build_zxbox.sh)
16-
17-
##### ZXBOX VM structure
18-
##### Nested emulation layers madness
19-
| Emu layer #3 - `ZX Spectrum` | USP, Fuse | Unreal Speccy | x128, r80, Shalaev |
20-
|---| :---: |---|:---:|
21-
| Layer #2 - `Crossplatform` | | [wine](https://www.winehq.org/) (Windows on Linux) | [dosbox](https://www.dosbox.com/) (MSDOS on Linux) |
22-
| Layer #1 - `common VM OS` | -//- | Ubuntu 20.04 Desktop | -//- |
23-
| HOST OS - `VirtualBox` | -//- | any [OS capable of running VirtualBox](https://www.virtualbox.org/manual/ch01.html#hostossupport) | -//- |
24-
9+
Try [jVGS](https://reefactor.github.io/zx-spectrum-instapack/emul/jVGS/jvgs-offline.html)
10+
or [Qaop](https://reefactor.github.io/zx-spectrum-instapack/emul/QAOP/qaop.html#ay#128)
11+
emulators online.
2512

2613
### Top ZX-SPECTRUM emulators
2714

28-
| Host OS | Emulator | Source code | Last updated | Author | Supported formats |
15+
| Host OS | Emulator | Source code | Last updated | Author | Supported file formats |
2916
|:---:|:---:|:---:|:---:|---|---|
3017
|Crossplatform|[**USP** - **Unreal Speccy Portable** fork](emul/USP)| C++ [git](https://github.com/djdron/UnrealSpeccyP) [snapshot v0.0.86.12](emul/src/UnrealSpeccyP-v0.0.86.12.tgz)|2020| djdron, scor | TRD, FDI, TD0, SCL, UDI, SP, SNA, Z80, TAP, TZX, CSW, SZX, RZX |
3118
|Windows|[**Unreal Speccy** v0.39](emul/US0.39.0/)| C++ [git v0.37](https://github.com/mkoloberdin/unrealspeccy) [snapshot v0.39](http://dlcorp.nedopc.com/viewforum.php?f=27)|2019| SMT, Dexus, Alone Coder, Deathsoft | TRD, FDI, TD0, SCL, UDI, SP, SNA, Z80, TAP, TZX, CSW |
@@ -37,35 +24,50 @@ ZXBOX is [based on](build_zxbox.sh) Ubuntu20.04 + zx-spectrum instapack. You can
3724
|DOS| [**Spectrum 128K** v3.05](emul/SHAL305) | C++ [snapshot](emul/src/SHAL305)| 1999 | Nikolay Shalaev | TRD, FDI, TD0 TAP, TZX |
3825

3926

40-
### Play offline
27+
### ZXBOX VM
28+
Download [ZXBOX](https://app.vagrantup.com/reefactor/boxes/ZXBOX) VM from vagrant cloud.
29+
ZXBOX is [based on](build_zxbox.sh) Ubuntu20.04 + zx-spectrum instapack. You can [build your own version from sources](build_zxbox.sh)
30+
31+
##### ZXBOX VM structure
32+
##### Nested emulation layers madness
33+
| Layer #3 - Z80 Emulation | USP, Fuse | Unreal Speccy | x128, r80, Shalaev |
34+
|:---| :---: |---|:---:|
35+
| Layer #2 - Crossplatform | | [wine](https://www.winehq.org/) (Windows on Linux) | [dosbox](https://www.dosbox.com/) (MSDOS on Linux) |
36+
| Layer #1 - Common VM OS | -//- | Ubuntu 20.04 Desktop | -//- |
37+
| HOST OS - VirtualBox | -//- | any [OS capable of running VirtualBox](https://www.virtualbox.org/manual/ch01.html#hostossupport) | -//- |
38+
39+
40+
41+
### HOWTO Start
4142

4243
#### Any platform
4344

44-
Just open [**jVGS** local](emul/jVGS/jvgs-offline.html) or use command line [jvgs.sh](jvgs.sh)) or [**Qaop** local](emul/QAOP/qaop.html#ay#128)
45+
Open in web browser [jVGS](emul/jVGS/jvgs-offline.html) or use command line [jvgs.sh](jvgs.sh)) or [Qaop](emul/QAOP/qaop.html#ay#128).
4546

46-
Then open .tap snaphost or betadisk image from your local file system.
47+
Then open image from your local file system.
4748
(with Google Chrome use `google-chrome --allow-file-access-from-files`)
4849

4950

50-
5151
#### Linux
5252

53-
Build and start Unreal Speccy Portable
53+
Build from sources and start Unreal Speccy Portable
5454
```bash
5555
linux-usp.sh
5656
```
5757

58-
Install and start Fuse
58+
Install from packages and start Fuse
5959
```bash
6060
linux-fuse.sh
6161
```
6262

63-
Start unrealspeccy via wine
63+
Start UnrealSpeccy with wine
6464
```bash
6565
wine-unrealspeccy.sh
6666
```
6767

6868
#### Windows
69+
70+
Start UnrealSpeccy
6971
```
7072
win-unrealspeccy.bat
7173
```
@@ -77,7 +79,7 @@ Start r80 via dosbox
7779
dosbox-r80.sh
7880
```
7981

80-
Start shalaev via dosbox
82+
Start Shalaev via dosbox
8183
```
8284
dosbox-shalaev.sh
8385
```
@@ -114,8 +116,7 @@ cp -r ../../../res .
114116
./unreal_speccy_portable
115117
```
116118

117-
Checkout `BROWSE WEB` option in Main Menu.
118-
Huge online catalog is maintained by [vtrd.in](https://vtrd.in) community.
119+
Checkout `BROWSE WEB` option in Main Menu for huge online software catalog maintained by [vtrd.in](https://vtrd.in) community.
119120

120121
UX NOTE: change `JOYSTICK` option from `KEMPSTON` to `CURSOR` in order to TRDOS menu to work
121122

@@ -125,3 +126,4 @@ UX NOTE: change `JOYSTICK` option from `KEMPSTON` to `CURSOR` in order to TRDOS
125126
* http://dlcorp.nedopc.com
126127
* http://www.zxspectrum.net
127128
* https://www.worldofspectrum.org
129+
* https://viva-games.ru/

0 commit comments

Comments
 (0)