portmaster/portmaster-legacy-releases
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated Home (markdown)

christianhaitian 2023-05-07 19:26:31 -04:00
parent 7d7099834e
commit 039d8437bd
1 changed files with 475 additions and 169 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

644
Home.md

@ -1,157 +1,275 @@
# Ports
### 2048 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### 2048
Instructions: 2048 files are already included and ready to go. Just start 2048 from Ports in the emulationstation menu. \
Notes: Thanks to [Gabriel Cirulli](http://gabrielecirulli.github.io/2048/) for creating this game and thanks to [Libretro](https://github.com/libretro/libretro-2048) for porting this as a retroarch core.
### Abuse (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Abe's Amazing Adventure!!
Instructions: Abe's Adventure files are already included and ready to go. Just start Abe's Adventure from Ports in the Emulationstation menu. \
Notes: Thanks to [Gabor Torok/Pedro Izecksohn](https://abe.sourceforge.net/) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Abu Simbel Profanation Deluxe
Instructions: The game files are already included and ready to go. Just start Profanattion Deluxe from Ports in the Emulationstation menu. \
Notes: Thanks to [dmitrysmagin](https://github.com/dmitrysmagin/profadeluxe) and the Team of MA Software for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Abuse
Instructions: The game is public domain so the files are already included and ready to go. Just start Abuse from Ports in the emulationstation menu. \
Notes: Thanks to Jonathan Clark, Dave Taylor and the rest of the Crack Dot Com team for making this 2D game and releasing it as public domain. Thanks to [Xenoveritas](https://github.com/Xenoveritas/abuse) for porting it so that it's easier to build. Also thanks to [romadu](https://github.com/romadu/abuse) for the porting work for the rk3326 platform.
Notes: Thanks to Jonathan Clark, Dave Taylor and the rest of the Crack Dot Com team for making this 2D game and releasing it as public domain. Thanks to [Xenoveritas](https://github.com/Xenoveritas/abuse) for porting it so that it's easier to build. Also thanks to [romadu](https://github.com/romadu/abuse) for the porting work for portmaster.
### Aleph-One (Marathon/Marathon 2/Marathon Infinity) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Aleph-One (Marathon/Marathon 2/Marathon Infinity)
Instructions: Data files are already included and ready to go. Just start Marathon, Marathon 2 or Marathon Infinity from Ports in the emulationstation menu. \
Notes: Thanks to the [Aleph-One-Marathon Team](https://github.com/Aleph-One-Marathon/alephone) for creating this opensource engine. Also thanks to romadu for the porting work for the rk3326 platform.
Notes: Thanks to the [Aleph-One-Marathon Team](https://github.com/Aleph-One-Marathon/alephone) for creating this opensource engine. Also thanks to romadu for the porting work for portmaster.
### AM2R (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: AM2R files are already included and ready to go. Just start AM2R from Ports in the emulationstation menu. \
Note: **For the PortMaster version, it's using an updated version that requires the android apk. You'll need to source your own am2r android apk and place it into the ports/am2r/gamedata folder. Make sure it is named am2r.apk. If need be, just rename the am2r apk you source to am2r.apk. The name is case sensitive!** \
### Alien Vs. Predator
Instructions: You will need the original files of the PC release copied to the ports/avp folder. \
Notes: The following files are needed:
- avp_huds directory
- avp_rifs directory
- fastfile directory
- language.txt file
#### ALL FILES AND FOLDERS NEED TO BE LOWERCASE ####
Includes 2 saves, 100% all missions and all cheats & a default profile with nothing unlocked. \
(both have the controls setup for each species) \
- Thanks to [sirlemonhead](https://github.com/neuromancer/avp) and other contributors for this engine. Also thanks to Kreal for the porting work and Rocky5 and Cebion for the packaging for portmaster.
### AM2R
Instructions: You'll need to source your own am2r android apk and place it into the ports/am2r/gamedata folder. Make sure it is named am2r.apk. If need be, just rename the am2r apk you source to am2r.apk. **The name is case sensitive!** \
Notes: Thanks to JohnnyonFlame for the [droidports](https://github.com/JohnnyonFlame/droidports) loader that makes this possible. \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Bermuda Syndrome (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Anarch
Instructions: Anarch files are already included and ready to go. Just start Anarch from Ports in the emulationstation menu. \
Notes: Thanks to [Miloslav Číž/drummyfish](https://drummyfish.itch.io/anarch) for creating the open source game. Also thanks to christopher-roelofs for the porting and packaging for portmaster.
### Augustus (Caeser III)
Instructions: You can buy a digital copy from GOG or Steam, or you can use an original CD-ROM version. Install the game files into `ports/augustus/data`, here are some excellent instructions [from the Julius project](https://github.com/bvschaik/julius/wiki/Running-Julius) (which Augustus is a fork of). If installing from the CD's you'll need to get the [latest patches](https://github.com/bvschaik/julius/wiki/Patches). \
Notes: Thanks to [Keriew](https://github.com/Keriew/augustus) for this modified version of the open source julius port from [Bianca van Schaik](https://github.com/bvschaik/julius) and other contributors. Also thanks to [Kloptops](https://github.com/kloptops/Portmaster-misc/tree/main/Augustus) for the packaging for portmaster and Cebion for the controls work.
### Axiom Verge
Instructions: You will need to add your own files to the ports/axiom-verge/gamedata folder. YOU HAVE TO USE THE DRM FREE EPIC GAMES VERSION. Also make sure you have the mono-6.12.0.122-aarch64.squashfs file in your Portmaster/libs folder. All instructions are in the ports/axiom-verge/gamedata folder. \
Notes: Thanks to the [FNA-XNA](https://github.com/FNA-XNA/FNA) project for the runtime that's used to make this possible. \
Also thanks to JohnnyonFlame, Overflask and Nuxx for the porting work for portmaster.
### Bermuda Syndrome
Instructions: You will need the original files of the PC release or PC demo copied to the ports/bermuda/DATA folder. Then just start Bermuda Syndrome.sh from Ports in the Emulationstation. \
Notes: Thanks to [cyxx](https://github.com/cyxx/bermuda) for the Bermuda Syndrome engine reimplementation that makes this possible. Also thanks to [jetup](https://github.com/Jetup13/bermuda-oga) for the porting work for the rk3326 platform.
Notes: Thanks to [cyxx](https://github.com/cyxx/bermuda) for the Bermuda Syndrome engine reimplementation that makes this possible. Also thanks to [jetup](https://github.com/Jetup13/bermuda-oga) for the porting work for portmaster.
### Blake Stone Aliens of Gold (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Billy Frontier (RG552 JelOS Only!)
Instructions: Billy Frontier files are already included and ready to go. Just start Billy Frontier from Ports in the emulationstation menu. Use the touchscreen to navigate the U and some gameplay. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/BillyFrontier) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Blake Stone Aliens of Gold
Instructions: Includes the shareware files. You can also add your own full version Blake Stone Aliens of Gold files to the ports/bstone-aog/gamedata/alien_of_gold folder. Just start Blake Stone - Aliens of Gold from Ports in the emulationstation menu. \
Notes: Thanks to [Boris I. Bendovsky](https://github.com/bibendovsky/bstone) for creating this unofficial source port. Also thanks to Cebion and romadu for the porting work for the rk3326 platform.
Notes: Thanks to [Boris I. Bendovsky](https://github.com/bibendovsky/bstone) for creating this unofficial source port. Also thanks to Cebion and romadu for the porting work for portmaster.
### Blake Stone Planet Strike (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Blake Stone Planet Strike
Instructions: You'll need to add your own full version Blake Stone Planet Strike files to the ports/bstone-ps/gamedata/planet_strike folder. Just start Blake Stone - Planet Strike from Ports in the emulationstation menu. \
Notes: Thanks to [Boris I. Bendovsky](https://github.com/bibendovsky/bstone) for creating this unofficial source port. Also thanks to Cebion and romadu for the porting work for the rk3326 platform.
Notes: Thanks to [Boris I. Bendovsky](https://github.com/bibendovsky/bstone) for creating this unofficial source port. Also thanks to Cebion and romadu for the porting work for portmaster.
### Blobby Volley 2 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Blob Wars: Metal Blob Solid
Instructions: Blobwars files are already included and ready to go. Just start Blobwars from Ports in the Emulationstation menu. \
Notes: Thanks to [Stephen Sweeney](https://github.com/perpendicular-dimensions/blobwars) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Blobby Volley 2
Instructions: Blobby Volley 2 files are already included and ready to go. Just start Blobby Volley 2 from Ports in the emulationstation menu. \
Notes: Thanks to [Daniel Knobe, Jonathan Sieber, Sven Rech, Erik Schultheis, Silvio Mummert, New beach image and other contributors](https://github.com/danielknobe/blobbyvolley2) for creating this game and making available for free. Also thanks to [Cebion and romadu](https://github.com/romadu/blobbyvolley2) for the porting work for the rk3326 platform.
Notes: Thanks to [Daniel Knobe, Jonathan Sieber, Sven Rech, Erik Schultheis, Silvio Mummert, New beach image and other contributors](https://github.com/danielknobe/blobbyvolley2) for creating this game and making available for free. Also thanks to [Cebion and romadu](https://github.com/romadu/blobbyvolley2) for the porting work for portmaster.
### Block Attack (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Block Attack
Instructions: Block Attack files are already included and ready to go. Just start Block Attack from Ports in the emulationstation menu. \
Notes: Thanks to [Poul Sander and contributors](https://github.com/blockattack/blockattack-game) for creating this game and making it available for free. Also, thanks to Cebion for the porting work for the rk3326 platform.
Notes: Thanks to [Poul Sander and contributors](https://github.com/blockattack/blockattack-game) for creating this game and making it available for free. Also, thanks to Cebion for the porting work for portmaster.
### Blood (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### BlockOut II
Instructions: BlockOut II files are already included and ready to go. Just start BlockOut II from Ports in the Emulationstation menu. \
Notes: Thanks to [Jean-Luc Pons](http://www.blockout.net/blockout2/). and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Blood
Instructions: You'll need to add your own full version Blood 1.21 files to the ports/Blood folder. Then just start Blood from Ports in the Emulationstation. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the NBlood engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the NBlood engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Blues Brothers (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Blues Brothers
Instructions: Includes the demo files. You can add your own full game Amiga or Dos files to the ports/bluesbrothers/gamedata folder.. Then just start Blues Brothers from Ports in the Emulationstation menu. \
Notes: Thanks to [cyxx](https://github.com/cyxx/blues) for the Blues Brothers engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/blues-oga) for the porting work for the rk3326 platform.
Notes: Thanks to [cyxx](https://github.com/cyxx/blues) for the Blues Brothers engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/blues-oga) for the porting work for portmaster.
### Cannonball (OutRun) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Bugdom (RG552 JelOS Only!)
Instructions: Bugdom files are already included and ready to go. Just start Bugdom from Ports in the emulationstation menu. Use the touchscreen to navigate the UI. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/Bugdom) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Cannonball (OutRun)
Instructions: Add the OutRun Revision B ROMs into /roms/ports/cannonball/gamedata folder then start Cannonball from Ports in the emulationstation menu. For exact naming of roms, view this [link](https://github.com/djyt/cannonball/blob/master/roms/roms.txt) \
Notes: Thanks to [djyt](https://github.com/djyt/cannonball) for creating the engine for this OutRun arcade game and thanks to [Libretro](https://github.com/libretro/cannonball) for adding this as a retroarch core.
### Cave Story (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Cave Story
Instructions: Cave Story files are already included and ready to go. Just start Cave Story from Ports in the emulationstation menu. \
Notes: Thanks to [Libretro](https://github.com/libretro/nxengine-libretro) for porting this as a retroarch core.
### Cave Story (evo) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Cave Story (evo)
Instructions: Install through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster) and start Cave Story-Evo from Ports in the emulationstation menu. \
Notes: Thanks to the [NXEngine](https://github.com/nxengine/nxengine-evo) team for the NXEngine Evo engine that makes this possible.
### C-Dogs (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### C-Dogs
Instructions: C-Dogs files are already included and ready to go. Just start C-Dogs from Ports in the emulationstation menu. \
Notes: Thanks to [cxong](https://github.com/cxong/cdogs-sdl) for this SDL build of the game that makes this possible.
### Commander Genius (Commander Keen) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Commander Genius (Commander Keen)
Instructions: Load your keen folders into the /roms/ports/cgenius/games folder. As an example, the shareware version of Commander Keen 1 is included and is named Keen. Then just start Commander Genius from Ports in the emulationstation menu. \
Notes: Thanks to [Gerhard Stein](https://github.com/gerstrong/Commander-Genius) and others related for the development of this port that makes this possible.
### CorsixTH (Theme Hospital) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### CorsixTH (Theme Hospital)
Instructions: Load your Theme Hospital files into the ports/corsixth/HOSP folder. As an example, the demo files of Theme Hospital is already included. If you plan to use a full GOG version of the assets,there's a file `HOSP/DATAM/DEMO.DAT` that needs to be deleted when full game files are added or the port will be confused about whether what version is played, and erroneously checks the GOG files as invalid file sizes. See this [issue](https://github.com/CorsixTH/CorsixTH/issues/2092) for more information. Then start CorsixTH from Ports in the emulationstation menu. \
Notes: Thanks to [CorsixTH](https://github.com/CorsixTH/CorsixTH) team for creating this clone of Theme Hospital. Also thanks to jetup and romadu for the porting work for the rk3326 platform.
Notes: Thanks to [CorsixTH](https://github.com/CorsixTH/CorsixTH) team for creating this clone of Theme Hospital. Also thanks to jetup and romadu for the porting work for portmaster.
### DevilutionX (Diablo 1) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Copy diabdat.mpq from your CD or GoG installation (or extract it from the GoG installer) into /roms/ports/devilution folder. **Make sure diabdat.mpq is all lowercase!**. **Do not delete the gamecontrollerdb.txt file in the /roms/ports/devilution folder or there will be no controller support in the game!** For controls, see [here](https://github.com/diasurgical/devilutionX#controller-support) \
### Cosmo-Engine
Instructions: The first episode is shareware and included. You can add episode 2 & 3 (STN,VOL, and CFG files) to the ports/cosmo-engine/data folder. Then start Cosmos Cosmic Adventure from Ports in the emulationstation station menu. \
Notes: Thanks to [Eric Fry](https://github.com/yuv422/cosmo-engine) and other contributors for this open source engine. Also thanks to Bamboozler for the porting work for portmaster.
### Cro-MagRally (RG552 JelOS Only!)
Instructions: Cro-MagRally files are already included and ready to go. Just start Cro-MagRally from Ports in the emulationstation menu. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/CroMagRally) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Dave Gnukem
Instructions: Dave Gnukem files are already included and ready to go. Just start Dave Gnukem from Ports in the emulationstation menu. \
Notes: Thanks to [David Joffe](https://github.com/davidjoffe) developers and contributors for the open source game. Also thanks to Bamboozler for the porting work for portmaster.
### Der Clou!
Instructions: Der Clou!'s files are already included and ready to go. Optionally you can replace them with other versions as well. Just start Der Clou! from Ports in the Emulationstation menu. \
Notes: Thanks to the [neo Software Produktions team](https://www.mobygames.com/game/2568/the-clue/) for creating the game and [Vasco Alexandre da Silva Costa](https://github.com/vcosta/derclou) for this open source port. Also thanks to Cebion for the packaging for portmaster.
### DevilutionX (Diablo 1)
Instructions: Copy diabdat.mpq from your CD or GoG installation (or extract it from the GoG installer) into /roms/ports/devilution folder. **Do not delete the gamecontrollerdb.txt file in the /roms/ports/devilution folder or there will be no controller support in the game!** For controls, see [here](https://github.com/diasurgical/devilutionX#controller-support) \
Important Note: It’s been reported that you must make sure you use the GOG version of diabdat.mpq with the newest patch_rt.mpq or you may experience a freeze of the game around level 20. \
Notes: Thanks to the [diasurgical](https://github.com/diasurgical/devilutionX) team for the source port that makes this possible.
### Dinothawr (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Dinothawr
Instructions: Dinothawr files are already included and ready to go. Just start Dinothawr from Ports in the emulationstation menu. \
Notes: Thanks to [Themaister](https://github.com/Themaister/Dinothawr) for creating this game and thanks to [Libretro](https://github.com/libretro/Dinothawr) for adding this as a retroarch core.
### Doom 3 (RG552 Only) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Doom 3 (RG552 Only)
Instructions: You need to add your own full game pak files to the ports/doom3/base folder. Then you should be able to launch Doom3 from Ports in the emulationStation menu.
Notes: Thanks to [Gabriel Cuvillier](https://github.com/gabrielcuvillier/d3wasm) for the d3wasm engine. Also thanks to brooksytech for the porting and packaging for portmaster.
### Duke Nukem 3D (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Diver Down
Instructions: DiverDown files are already included and ready to go. Just start DiverDown from Ports in the Emulationstation menu. \
Notes: Thanks to the team of [Escada Games](https://github.com/Escada-Games/diver-down) for creating this game and making available for free and [efornara](https://github.com/efornara/frt) for creating the FRT platform. Also thanks to Cebion for the packaging for portmaster.
### Duke Nukem 3D
Instructions: You'll need to add your own full version DUKE3D.GRP and DUKE.RTS Duke Nukem 3D Atomic files to the ports/rednukem/gamedata folder. Then just start Duke Nukem 3D from Ports in the Emulationstation. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Exhumed (aka PowerSlave) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Dungeon Rush
Instructions: Dungeon Rush files are already included and ready to go. Just start DungeonRush from Ports in the emulationstation menu. \
Notes: Thanks to [Yujia Qiao/rapiz1](https://github.com/Rapiz1/DungeonRush) for creating the open source game. Also thanks to christopher-roelofs for the porting and packaging for portmaster.
### Eity
Instructions: Eity files are already included and ready to go. Just start the game from Ports in the Emulationstation menu. \
Notes: Thanks to [Eemeli Mark](https://github.com/TheJeme/Eity) for creating this game and making it available for free. Also thanks to Cebion for the packaging for portmaster.
### Enigma
Instructions: Enigma files are already included and ready to go. Just start Enigma from Ports in the emulationstation menu. \
Notes: Thanks to [Enigma-Game](https://github.com/Enigma-Game/Enigma) developers and contributors for the open source puzzle game. Also thanks to Bamboozler for the porting work for portmaster.
### Exhumed (aka PowerSlave)
Instructions: You'll need to add your own full version STUFF.DAT, DEMO.VCR and BOOK.MOV files to the ports/Exhumed folder. Then just start Exhumed from Ports in the Emulationstation. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the PCExhumed engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the PCExhumed engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Exult (aka Ultima 7) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Exult (aka Ultima 7)
Instructions: You'll need A copy of the black gate and/or serpent isle added to ports/exult/data/blackgate and/or ports/exult/data/serpentisle. If done correctly there will be a ports/exult/data/blackgate/static and ports/exult/data/serpentisle/static folder. You’ll also need a copy of an existing saved game or you won’t be able to start a game session. Then just start Exult-keyring or Exult-nokeyring from Ports in the Emulationstation. \
Notes: Thanks to the [Exult Team](https://github.com/exult/exult) for the Exult engine that makes this possible. Also thanks to nl255 for the porting work for the rk3326 platform.
Notes: Thanks to the [Exult Team](https://github.com/exult/exult) for the Exult engine that makes this possible. Also thanks to nl255 for the porting work for portmaster.
### F2bgl (Fade to Black) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### F2bgl (Fade to Black)
Instructions: You will need the original files of the PC release or PC demo copied to the ports/f2bgl folder. Then just start F2bgl.sh from Ports in the Emulationstation. \
Notes: Thanks to [cyxx](https://github.com/cyxx/f2bgl) for the Fade to Black engine reimplementation that makes this possible. Also thanks to romadu for the porting work for the rk3326 platform.
Notes: It’s been reported that only the US based CD version of Fade to Black works with this port.
(Europe and downsized US DOSBox versions are not compatible even when all files are present). Thanks to waeggy123 for reporting this. \
Thanks to [cyxx](https://github.com/cyxx/f2bgl) for the Fade to Black engine reimplementation that makes this possible. Also thanks to romadu for the porting work for portmaster.
### Free Heroes of Might and Magic II (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Falling Time
Instructions: Falling Time files are already included and ready to go. Just start Falling Time from Ports in the emulationstation menu. \
Notes: Thanks to [Nebuleon Fumika/Cong Xu](https://github.com/cxong/FallingTime) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Fallout 1
Instructions: You need to copy critter.dat, master.dat and the data folder from the original game to ports/fallout1 folder. Make sure these file names and the data folder name is in lower case! \
Notes: Thanks to [Alex Batalov](https://github.com/alexbatalov/fallout1-ce) and other contributors for creating this community edition. Also thanks to Kloptops for the packaging for portmaster.
### Fallout 2
Instructions: You need to copy critter.dat, master.dat, patch000.dat and data from the original game to ports/fallout2 folder. Make sure these file names and the data folder name is in lower case! \
Notes: Thanks to [Alex Batalov](https://github.com/alexbatalov/fallout2-ce) and other contributors for creating this community edition. Also thanks to Orson for the packaging for portmaster.
### Flare Engine
Instructions: The game files are already included and ready to go. More games can be downloaded from https://flarerpg.org/mods and placed in the ports/flare/mods folder. Just start Flare from Ports in the Emulationstation menu. \
Notes: Thanks to the [Flare team](https://github.com/flareteam/flare-engine) for creating the game. Also thanks to Cebion for the packaging for portmaster.
### Free Heroes of Might and Magic II
Instructions: Just add the data and maps folders from your full version GOG Heroes of Might and Magic II directory or download the demo files from [here](https://archive.org/download/HeroesofMightandMagicIITheSuccessionWars_1020/h2demo.zip) to the ports/fheroes2 folder or just launch Fheroes2 from the ports menu in Emulationstation and it will download the demo files and install them automatically. Make sure to have wifi on for this to work! \
Notes: Thanks to [Ihar Hubchyk](https://github.com/ihhub/fheroes2) for the Free Heroes of Might and Magic II engine that makes this possible. Also thanks to romadu for the porting work for the rk3326 platform.
Notes: Thanks to [Ihar Hubchyk](https://github.com/ihhub/fheroes2) for the Free Heroes of Might and Magic II engine that makes this possible. Also thanks to romadu for the porting work for portmaster.
### Freedom Planet (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Freedom Planet
Instructions: You must have a copy of Freedom Planet for Linux. You'll need the contents of the Freedom.Planet/game folder to be copied into the freedomplanet/gamedata folder of your sd card. Be sure the freedomplanet/gamedata folder on you sd card contains subfolders named bin32, bin64 and Data. The runtime folder and the run.sh file is not needed and should be left out or it will cause a double entry for Freedom Planet in the ports section of Emulationstation. There should also be a filed named Assets.dat in freedomplanet/gamedata as well. Then run Freedom Planet from the Emulationstation ports menu. \
Note: This game can take a minute or two to initially load. \
Thanks to ptitSeb for box86 (https://github.com/ptitSeb/box86) \
Thanks to JohnnyonFlame for gl4es and the the necessary packaging to allow this game to run on ArkOS. (https://github.com/JohnnyonFlame/gl4es/tree/sk_hacks) \
Thanks to JohnnyonFlame for gl4es and the the necessary packaging to allow this game to run on supported linux distros. (https://github.com/JohnnyonFlame/gl4es/tree/sk_hacks) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Half-Life 1 (ArkOS Final on RG351P/M Only. Not available via PortMaster due to technical issues with this port.)
Instructions: Only works with the full version of Half life 1.
### FreedroidRPG
Instructions: FreedroidRPG files are already included and ready to go. Just start FreedroidRPG from Ports in the emulationstation menu. \
Notes: Thanks to the [FreedroidRPG Team](https://www.freedroid.org/) for creating this game. Also thanks to Cebion for the porting and packaging for portmaster.
1. Copy the valve folder from your steam game folder or other source into /roms/ports/Half-Life.
2. Then unzip the contents of the **Copy Contents into valve folder.zip** into your valve folder.
3. Now launch Half-Life from the ports menu in emulationstation.
4. The first launch of the game may take up to 2 minutes to complete. Subsequent launches will be quicker.
### Freegemas
Instructions: Freegemas files are already included and ready to go. Just start Freegemas from Ports in the emulationstation menu. \
Notes: Thanks to [José Tomás Tocino](https://github.com/JoseTomasTocino/freegemas) for the open source recreation of Bejeweled. Also thanks to Bamboozler for the porting work for portmaster.
Note: The analog controls are reversed in menu only. Just use the Dpad to navigate the menu. Once in game, they work correctly.
### FreeSurf
Instructions: Copy the data file(s) from the original game into the `ports/freeserf`. You may use data file(s) from DOS or Amiga game version. Then just start FreeSurf from Ports in the emulationstation menu.
Default keys while in games: \
L2: Quick save \
L1: Quick load \
Select: Exit \
Start: Pause \
Dpad and left control stick: move \
Right control stick: look around \
R1: shoot \
Y: Bend down \
B: Jump
- DOS data file is called `SPAE.PA`, `SPAD.PA`, `SPAF.PA` or `SPAU.PA`, depending on the language of the game.
- Amiga files `gfxheader`, `gfxfast`, `gfxchip`, `gfxpics`, `sounds`, `music`.
Thanks to a community member by the name of fonzo, an alternative to these controls that some like is to copy these 2 files into the valve folder:
[autoexec.cfg](https://github.com/christianhaitian/arkos/raw/main/devices/autoexec.cfg)
[keyboard.cfg](https://github.com/christianhaitian/arkos/raw/main/devices/keyboard.cfg)
Notes: Thanks to the [freeserf Team](https://github.com/freeserf/freeserf) and contributors for creating this game. Also thanks to [kloptops](https://github.com/kloptops/Portmaster-misc/tree/main/FreeSerf) for the porting and packaging for portmaster.
and you're controls will be as shown in the image below: \
![fonzo mapping](https://github.com/christianhaitian/arkos/raw/main/devices/rg351p_halflife_fonzo.png) \
Note: Thanks to [Xash3D-FWGS](https://github.com/FWGS/xash3d-fwgs) for the engine used for this port.
### GemRB
Instructions: To play various GemRB compatible games you need to copy over the game files into ports/gemrb/games into their own directory. For example you would install the Baldur's Gate game files into ports/gemrb/games/bg1 directory. Currently EE versions are not 100% compatible. \
Notes: Thanks to the [GemRB](https://github.com/gemrb/gemrb) team for creating this open source engine. Also thanks to [kloptops](https://github.com/kloptops/gemrb) for the porting and packaging for portmaster.
### Heart of Darkness (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Gigalomania
Instructions: Gigalomania files are already included and ready to go. Just start Gigalomania from Ports in the Emulationstation menu. \
Notes: Thanks to [Mark Harman](https://gigalomania.sourceforge.net/) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Half-Life
Instructions: To play Half-Life you need to copy over the contents of the valve directory from your steam install of [Half-Life](https://store.steampowered.com/app/70/HalfLife/) into ports/Half-Life/valve, on first run it will override the required files to run.
To play Half-Life: Blue Shift you need to have Half-Life installed, then copy over the contents of the bshift directory from your steam install of [Half-Life: Blue Shift](https://store.steampowered.com/app/130/HalfLife_Blue_Shift/) into ports/Half-Life/bshift, on first run it will override the required files to run, and create a Half-Life Blue Shift.sh in your ports directory.
To play Half-Life: Opposing Forces you need to have Half-Life installed, then copy over the contents of the gearbox directory from your steam install of [Half-Life: Opposing Forces](https://store.steampowered.com/app/50/HalfLife_Opposing_Force/) into ports/Half-Life/gearbox, on first run it will override the required files to run, and create a Half-Life Opposing Fores.sh in your ports directory.
Notes: Thanks to the [Flying With Gauss](https://github.com/FWGS/xash3d-fwgs) team and contributors for the Xash3D Engine fork of Unkle Mike's original work that makes this possible. Also thanks to [kloptops](https://github.com/kloptops/Portmaster-HalfLife) for the porting work for portmaster.
### Heart of Darkness
Instructions: Just add your own Heart of Darkness game files to the ports/hode/gamedata folder. Then Just start Heart of Darkness from Ports in the emulationstation menu. \
Notes: Thanks to [usineur](https://github.com/usineur/hode) for the hode engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/hode-vs-oga) for the porting work for the rk3326 platform.
Notes: Thanks to [usineur](https://github.com/usineur/hode) for the hode engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/hode-vs-oga) for the porting work for portmaster.
### Hurrican (Turrican) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Hex-A-Hop
Instructions: Hex-a-Hop files are already included and ready to go. Just start Hex-a-Hop from Ports in the emulationstation menu. \
Notes: Thanks to [amuzen/pabs3](https://hexahop.sourceforge.net/) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Hexen 2/Hexen 2 - Portal of Praevus
Instructions: The Hexen II pak0.pak and pak1.pak data files are required for Hexen 2 and additionally, pak3.pak is required to play the Portal of Praevus expansion. Once loaded, just start Hexen 2.sh or Hexen 2 - Portal of Praevus from Ports in the emulationstation menu. \
Notes: Thanks to Slayer366 for the packaging for portmaster.
### Hijinx
Instructions: Hijinx files are already included and ready to go. Just start the game from Ports in the Emulationstation menu. \
Notes: Thanks to [John Gabriel](https://bitbucket.org/JohnGabrielUK/hijinx/) for creating this game and making it available for free. Also thanks to Cebion for the packaging for portmaster.
### Hocoslamfy
Instructions: Hocoslamfy files are already included and ready to go. Just start Hocoslamfy from Ports in the emulationstation menu. \
Notes: Thanks to [Nebuleon](https://github.com/Nebuleon/hocoslamfy) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Hurrican (Turrican)
Instructions: Just add the data and lang folders from [here](https://github.com/drfiemost/Hurrican/archive/refs/heads/master.zip) to the ports/hurrican folder or just launch Hurrican from the ports menu in Emulationstation and it will download the files and install them automatically. Make sure to have wifi on for this to work! \
Notes: Thanks to [thrimbor](https://github.com/thrimbor/Hurrican) for the Hurrican engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/Hurrican) for the porting work for the rk3326 platform.
Notes: Thanks to [thrimbor](https://github.com/thrimbor/Hurrican) for the Hurrican engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/Hurrican) for the porting work for portmaster.
### Hydra Castle Labyrinth (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Hydra Castle Labyrinth
Instructions: Hydra Castle Labyrinth files are already included and ready to go. Just start Hydra Castle Labyrinth from Ports in the emulationstation menu. \
Notes: Thanks to [ptitSeb](https://github.com/ptitSeb/hydracastlelabyrinth) for the SDL port of this game that makes this possible on this platform.
### Iconoclasts (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Iconoclasts
Instructions: You must have a copy of Iconoclasts for Linux.
- For **Steam** or **Preinstalled GOG**:
- Copy data into the ports/iconoclasts/gamedata folder
@ -162,25 +280,41 @@ Instructions: You must have a copy of Iconoclasts for Linux.
Then just start Iconoclast from Ports in the emulationstation menu. \
Notes: **This game is best played on devices with a 640x480 screen resolution or higher!** \
Thanks to JohnnyonFlame for [gl4es](https://github.com/ptitSeb/gl4es/pull/362) and the [necessary packaging](https://github.com/JohnnyonFlame/BoxofPatches) to allow this game to run on the rk3326 platform. \
Thanks to JohnnyonFlame for [gl4es](https://github.com/ptitSeb/gl4es/pull/362) and the [necessary packaging](https://github.com/JohnnyonFlame/BoxofPatches) to allow this game to run on portmaster. \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Invaders (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You need to provide 4 roms (invaders.e, invaders.f, invaders.g, invaders.h) from a MAME 0.78 invaders.zip romset to the invaders/inv1 folder. The MAME2003 version should work as well. Then start Invaders from Ports in the emulationstation menu. \
Notes: Thanks to [loadzero](https://github.com/loadzero/si78c) for the memory accurate reimplementation of this game. Also thanks to [romadu](https://github.com/romadu/si78c) for the porting work for the rk3326 platform and packaging for portmaster.
### iiChantra P.E.A.R
Instructions: iiChantra files are already included and ready to go. Just start IIChantra P.E.A.R from Ports in the Emulationstation menu. \
Notes: Thanks to the [Anonymous developers](https://iichantra.ru/) and other contributors for creating this game and making available for free. Also thanks to Cebion and kloptops for the packaging for portmaster.
### Maldita Castilla (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Invaders
Instructions: You need to provide 4 roms (invaders.e, invaders.f, invaders.g, invaders.h) from a MAME 0.78 invaders.zip romset to the invaders/inv1 folder. The MAME2003 version should work as well. Then start Invaders from Ports in the emulationstation menu. \
Notes: Thanks to [loadzero](https://github.com/loadzero/si78c) for the memory accurate reimplementation of this game. Also thanks to [romadu](https://github.com/romadu/si78c) for the porting work for portmaster and packaging for portmaster.
### Maldita Castilla
Instructions: Maldita Castilla files are already included and ready to go. Just start Maldita Castilla from ports in the emulationstation menu. \
Notes: Thanks to [Locomalito](https://locomalito.com/maldita_castilla.php) for creating this game and make it available for free.
### Moonlight Nvidia Gamestreaming App (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Meritous
Instructions: Meritous files are already included and ready to go. Just start Meritous from Ports in the emulationstation menu. \
Notes: Thanks to [Lancer-X/ASCEAI](https://github.com/zear/meritous) and other contributors for creating this game and making available for free. Also thanks to Cebion and Romadu for the packaging for portmaster.
### Mighty Mike (RG552 JelOS Only!)
Instructions: Mighty Mike files are already included and ready to go. Just start Mighty Mike from Ports in the emulationstation menu. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/MightyMike) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Mirror Magic
Instructions: Mirror Magic files are already included and ready to go. Just start Mirror Magic from Ports in the emulationstation menu. \
Notes: Thanks to [Artsoft Entertainment](https://www.artsoft.org/mirrormagic/) for developing it and making it avaialble for free. Also thanks to Bamboozler for the porting work for portmaster.
### Moonlight Nvidia Gamestreaming App
Instructions: PC Requirements and setup as follows:
PC Requirements: \
A PC with an Nvidia 600 GPU or newer \
[GeForce Experience app](https://www.nvidia.com/en-us/geforce/geforce-experience/)
1. You'll need to make sure your streaming PC and your rk3326 device with ArkOS are connected to the same network.
1. You'll need to make sure your streaming PC and your rk3326 device with the supported linux distro are connected to the same network.
2. When you launch Moonlight from the ports menu, you'll be presented with a menu with 2 options, Start Streaming and settings. You'll want to go to settings first and choose the pair option.
3. You'll be presented with a screen asking for the name or IP address of your PC with the Nvidia Geforce Experience app installed.
4. Once you hit the ok button, you should be presented with a pairing dialog box on your PC.
@ -190,7 +324,7 @@ A PC with an Nvidia 600 GPU or newer \
Notes:
* To ensure that you have controls in your games while streaming, be sure to disconnect any game controllers from your PC and reboot your PC before you start your streaming session.
* More information about Moonlight is available [here](https://github.com/moonlight-stream/moonlight-docs/wiki).
* If you experience issues with the setup and launching menu functioning correctly, hitting start may resolve it or simply force close the port using the usual exit hotkey on ArkOS for your device (RGB10 = Minus + Start, RK2020/RG351P/M/V = Select+Start, Chi = 1 + Start).
* If you experience issues with the setup and launching menu functioning correctly, hitting start may resolve it or simply force close the port using the usual exit hotkey on ArkOS or supported linux distro for your device (RGB10 = Minus + Start, RK2020/RG351P/M/V/MP = Select+Start, Chi = 1 + Start).
* For those that don't have an Nvidia vide card, there's an alternative PC client called [Sunshine](https://github.com/loki-47-6F-64/sunshine). I haven't tested it so I don't know how well it will work but there's been reports that it seems to work well.
* To exit Moonlight when complete, you can press Select+Start+L1+R1 or simply use the exit hotkey for your device to get out of the app.
* If you experience issues reconnecting to your PC, go to settings in the Moonlight app and unpair the PC then do another pair again.
@ -198,102 +332,177 @@ Notes:
* You can add more apps for streaming by editing the Moonlight.sh file and adding more apps between lines 167 and 173. Be aware that the entries are case sensitive.
* Mouse control is only possible using the Rockchip platform in settings. That is only possible on the OGA, OGS, RGB10, and the RK2020 at this time. Holding start for about 2 - 3 seconds while using the Rockchip platform will switch to mouse mode. Hold Start for about 2 - 3 seconds again to switch back to gamepad controls.
Notes: Thanks to the [moonlight-stream](https://github.com/moonlight-stream/moonlight-embedded) team for creating this solution that makes it possible. Also thanks to [AreaScout](https://github.com/AreaScout/moonlight-embedded) for the necessary modifications that make this possible to run on the rk3326 platform.
Notes: Thanks to the [moonlight-stream](https://github.com/moonlight-stream/moonlight-embedded) team for creating this solution that makes it possible. Also thanks to [AreaScout](https://github.com/AreaScout/moonlight-embedded) for the necessary modifications that make this possible to run on portmaster.
### Mr. Boom (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Mr. Boom
Instructions: Mr. Boom files are already included and ready to go. Just start Mr. Boom from Ports in the emulationstation menu. \
Notes: Thanks to [Javanaise](https://github.com/Javanaise/mrboom-libretro) for creating this clone for libretro/retroarch and thanks to [Libretro](https://github.com/libretro/mrboom-libretro) for officially incorporating this as a retroarch core.
### Multris
Instructions: Multris files are already included and ready to go. Just start Multris from Ports in the emulationstation menu. \
Notes: Thanks to [Russell Reich](https://github.com/RustyReich/Multris) for developing this open source game. Also thanks to Bamboozler for the porting work for portmaster.
### Neverball and Neverputt
Instructions: Neverball and Neverputt files are already included and ready to go. Just start Neverball or Neverputt from Ports in the emulationstation menu. \
Notes: Thanks to [Neverball](https://github.com/Neverball/neverball) for creating both of these open source games. Thanks to Bamboozler for the packaging work for portmaster.
### nKaruga
Instructions: nKaruga files are already included and ready to go. Just start nKaruga from Ports in the emulationstation menu. \
Notes: Thanks to [matrefeytontias](https://github.com/matrefeytontias/nKaruga) for creating this game. Thanks to [gameblabla](https://github.com/gameblabla/nKaruga) for the additional work on this game. Also thanks to jetup for the packaging work for the rk3326 platform.
Notes: Thanks to [matrefeytontias](https://github.com/matrefeytontias/nKaruga) for creating this game. Thanks to [gameblabla](https://github.com/gameblabla/nKaruga) for the additional work on this game. Also thanks to jetup for the packaging work for portmaster.
### NAM (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### NAM
Instructions: You'll need to add your own full version NAM.GRP and NAM.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-redneck1/gamedata folder. Then you should be able to start NAM from the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### OpenClaw (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Nanosaur (RG552 JelOS Only!)
Instructions: Nanosaur files are already included and ready to go. Just start Nanosaur from Ports in the emulationstation menu. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/nanosaur) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Nonny
Instructions: Nonny files are already included and ready to go. Just start Nonny from Ports in the emulationstation menu. \
Notes: Thanks to [Greg Kikola](https://github.com/gkikola/nonny) for creating this game. Thanks to Bamboozler for the packaging work for portmaster.
### Oddworld: Abe's Oddysee & Exoddus
Instructions: Copy all .lvl and .ddv files (and sound.dat for Exoddus) from the original game(s) to either the ports/oddysee or ports/exoddus directory. Then just start Oddworld Abes Exoddus or Oddworld Abes Oddysee from Ports in the emulationstation menu. \
Notes: Thanks to [Alive Team](https://github.com/AliveTeam/alive_reversing) for creating the opensource port that makes this possible. Also thanks to Orson for the porting work for portmaster.
### OpenBlok
Instructions: OpenBlok files are already included and ready to go. Just start OpenBlok from Ports in the emulationstation menu. \
Notes: Thanks to [Mátyás Mustoha](https://github.com/mmatyas) for developing this open source game. Also thanks to Bamboozler for the porting work for portmaster.
### OpenClaw
Instructions: OpenClaw files are already included and ready to go. Just start Openclaw from Ports in the emulationstation menu. \
Notes: Thanks to [Petr Jašíček](https://github.com/pjasicek/OpenClaw) for creating the opensource port that makes this possible. Also thanks to Cebion for the porting work for the rk3326 platform.
Notes: Thanks to [Petr Jašíček](https://github.com/pjasicek/OpenClaw) for creating the opensource port that makes this possible. Also thanks to Cebion for the porting work for portmaster.
### OpenJazz (Jazz Jackrabbit)(Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### OpenFodder
Instructions: The game comes with demo files ready to go. Just start OpenFodder from Ports in the emulationstation menu. To install the full versions, using the DOS CD, Copy `CF_ENG.DAT` from the CD (or the GOG install destination) to the `roms/openfodder/Data/Dos_CD` folder. For the Amiga version, See [here](https://github.com/OpenFodder/openfodder/blob/master/INSTALL.md#amiga) for details on doing so. \
Notes: Thanks to the [OpenFodder Team](https://github.com/OpenFodder/openfodder) for the open source Cannon Fodder engine that makes this possible. Also thanks to the kloptops for the porting work for portmaster.
### OpenJazz
Instructions: Add the dos game files to the roms/ports/openjazz/gamedata/ folder then start OpenJazz from Ports in the emulationstation menu. \
Notes: Thanks to [AlisterT](https://github.com/AlisterT/openjazz) for creating the opensource port that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/openjazz-oga) for the porting work for the rk3326 platform.
Notes: Thanks to [AlisterT](https://github.com/AlisterT/openjazz) for creating the opensource port that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/openjazz-oga) for the porting work for portmaster.
### OpenOMF (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### OpenOMF
Instructions: OpenOMF files are already included and ready to go. Just start Openomf from Ports in the emulationstation menu. \
Notes: Thanks to [omf2097 team](https://github.com/omf2097/openomf) for creating this opensource port. Also thanks to Cebion for the porting work for the rk3326 platform.
Notes: Thanks to [omf2097 team](https://github.com/omf2097/openomf) for creating this opensource port. Also thanks to Cebion for the porting work for portmaster.
### OpenTTD (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### OpenRCT2 (Open Roller Coaster Tycoon 2)
Instructions: Install your Roller Coaster Tycoon 2 game files into `{PORTS}/openrct2/RCT2`, **these files are required**, and optionally your Roller Coaster Tycoon 1 game files into `{PORTS}/openrct2/RCT1`. They can be bought at either [Steam](https://store.steampowered.com/app/285330/) or [GOG.com](https://www.gog.com/game/rollercoaster_tycoon_2). If you have the original RollerCoaster Tycoon and its expansion packs, you can point OpenRCT2 to these in order to play the original scenarios. Then just start OpenRCT2 from Ports in the emulationstation menu. \
Notes: Thanks to [OpenRCT2 team](https://github.com/OpenRCT2/OpenRCT2) for creating this opensource port. Also thanks to [kloptops](https://github.com/kloptops/Portmaster-misc/tree/main/OpenRCT2) for the porting work for portmaster.
### OpenTTD
Instructions: OpenTTD files are already included and ready to go. Just start Openttd from Ports in the emulationstation menu. \
Notes: Thanks to [OpenTTD team](https://github.com/OpenTTD/OpenTTD) for creating this opensource port. Also thanks to Cebion and romadu for the porting work for the rk3326 platform.
Notes: Thanks to [OpenTTD team](https://github.com/OpenTTD/OpenTTD) for creating this opensource port. Also thanks to Cebion and romadu for the porting work for portmaster.
### OpenTyrian (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### OpenTyrian
Instructions: OpenTyrian 2.1 files are already included as they were made freeware sometime ago. Just start OpenTyrian from Ports in the Emulationstation. \
Notes: Thanks to the [OpenTyrian Team](https://github.com/opentyrian/opentyrian) and contributors for the open-source port that makes this possible.
### Prehistorik 2 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Includes the demo files. You can add your own full game Dos files to the ports/prehistorik2/gamedata folder. Then just start Prehistorik 2 from Ports in the Emulationstation menu. \
Notes: Thanks to [cyxx](https://github.com/cyxx/blues) for the Blues Brothers engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/blues-oga) for the porting work for the rk3326 platform.
### OpenXcom
Instructions: UFO Defense game data goes in the UFO folder, Terror from the deep goes in the TFTD folder, any mods go in the mods folder. Then just start OpenXcomEX from Ports in the emulationstation menu. \
Notes: **Never enable OpenGL or it will crash immediately on loading (which can be fixed by editing the .cfg file and turning it back off there)** \
Thanks to [MeridianOXC](https://github.com/MeridianOXC/OpenXcom) and contributors for the open-source ports that makes this possible. Also thanks to nl255 for the porting work for portmaster.
### Quake 1 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Add .pak files to /roms/ports/quake/quakepaks then start Quake from Ports in the emulationstation menu. \
Notes: Thanks to [Libretro](https://github.com/libretro/tyrquake) for adding this as a retroarch core.
### OttoMatic (RG552 JelOS Only!)
Instructions: Ottomatic files are already included and ready to go. Just start Ottomatic from Ports in the emulationstation menu. Currently only runs on the RG552 with Jelos installed. \
Notes: Thanks to Pangea Software for creating the game and publicly releasing the game files. Thanks to [Jorio](https://github.com/jorio/ottomatic) for porting the game engine to various platforms. Also thanks to brooksytech for the porting work for portmaster.
### Quake 2 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Add .pak files to /roms/ports/quake2/baseq2 then start Quake 2 from Ports in the emulationstation menu. \
Notes: Thanks to the [Yamagi Quake II team](https://github.com/yquake2/yquake2) for developing this client and [romadu](https://github.com/romadu/yquake2) for the porting work for the rk3326 platform.
### Quake 3 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You need to add your own full game pak files and product key to the ports/quake3/baseq3 folder then start Quake 3 from Ports in the emulationstation menu. \
Notes: Thanks to [Eugene C.](https://github.com/ec-/Quake3e) for developing this updated engine and [brooksytech](https://github.com/brooksytech/Quake3e) for the porting work for the rk3326 platform.
### RAWGL (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Includes the Out of this World demo files. You can add your own full game files to the ports/rawgl/gamedata/ folder. See this [link](https://github.com/cyxx/rawgl#supported-versions] for more supported files info. Then just start RAWGL from Ports in the emulationstation menu. \
Notes: Thanks to [cyxx](https://github.com/cyxx/rawgl) for the rawgl engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/rawgl-oga) for the porting work for the rk3326 platform.
### Redneck Rampage 1 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You'll need to add your own full version REDNECK.GRP and REDNECK.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-redneck1/gamedata folder. Then you should be able to start Redneck Rampage from the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
### Redneck Rampage 2 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You'll need to add your own full version REDNECK.GRP and REDNECK.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-redneck2/gamedata folder. Then you should be able to start Redneck Rampage Rides Again from the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
### Reminiscence (Flashback) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You will need the original files of the PC version copied to ports/reminiscence/gamedata folder. Then you should be able to start REminiscence from the Ports section in the emulationstation menu. \
Notes: Thanks to [Alex Chermenin](https://github.com/chermenin/REminiscence) for the Reminiscence engine that makes this possible. Also thanks to [Jetup](https://github.com/Jetup13/REminiscence-oga) and romadu for the porting work for the rk3326 platform.
### Return to Castle Wolfenstein (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You'll need to add your own pak0.pk3, sp_pak1.pk3, sp_pak2.pk3, sp_pak3.pk3 and sp_pak4.pk3 to the ports/iortcw/main folder. The Steam version seems to work best as it's patched for Linux use already. Then you should be able to start Return to Castle Wolfenstein from the emulationstation menu. \
Notes: Thanks to [Donny Springer, Zack Middleton, James Canete and other contributors](https://github.com/iortcw/iortcw) for this engine. Also thanks to [JohnnyonFlame](https://github.com/JohnnyonFlame/handheld-iortcw) for the porting work for the rk3326 platform and romadu for the packaging for portmaster. \
### Owlboy
Instructions: You must have a copy of Owlboy for Linux. Copy data into the ports/owlboy/gamedata folder \
Then just start Owlboy from Ports in the emulationstation menu. \
Notes: **This game is best played on devices with at least a 5" screen.** It is somewhat feasible on the 3.5" 640x480 device like the Chi, RG351MP or RG351V. Text is not legible on the 480x320 devices such as the RG351P/M, RGB10, or RK2020. \
Thanks to the [FNA-XNA](https://github.com/FNA-XNA/FNA) project for the runtime that's used to make this possible. \
Thanks to JohnnyonFlame for the port work that makes this possible. \
You can sponsor FNA-XNA's work [here](https://github.com/sponsors/flibitijibibo) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### RVGL (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Pekka Kana 2
Instructions: Pekka Kana 2 files are already included and ready to go. Just start Pekka Kana 2 from Ports in the Emulationstation menu. \
Notes: Thanks to [Janne Kivilahti, Samuli Tuomola, Danilo Lemos](https://github.com/danilolc/pk2) for creating this game, porting it to SDL and finally to SDL2 and making it available for free. Also thanks to Cebion for the packaging for portmaster.
### Powder
Instructions: Powder files are already included and ready to go. Just start Powder from Ports in the Emulationstation menu. \
Notes: Thanks to [Jeff Lait](https://www.zincland.com/powder/) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Prehistorik 2
Instructions: Includes the demo files. You can add your own full game Dos files to the ports/prehistorik2/gamedata folder. Then just start Prehistorik 2 from Ports in the Emulationstation menu. \
Notes: Thanks to [cyxx](https://github.com/cyxx/blues) for the Blues Brothers engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/blues-oga) for the porting work for portmaster.
### Quake 1
Instructions: Add .pak files to /roms/ports/quake/quakepaks/id1 then start Quake from Ports in the emulationstation menu. \
Notes: Thanks to [Libretro](https://github.com/libretro/tyrquake) for adding this as a retroarch core.
### Quake 2
Instructions: Add .pak files to /roms/ports/quake2/baseq2 then start Quake 2 from Ports in the emulationstation menu. \
Notes: Thanks to the [Yamagi Quake II team](https://github.com/yquake2/yquake2) for developing this client and [romadu](https://github.com/romadu/yquake2) for the porting work for portmaster.
### Quake 3
Instructions: You need to add your own full game pak files and product key to the ports/quake3/baseq3 folder then start Quake 3 from Ports in the emulationstation menu. \
Notes: Thanks to [Eugene C.](https://github.com/ec-/Quake3e) for developing this updated engine and [brooksytech](https://github.com/brooksytech/Quake3e) for the porting work for portmaster.
### RAWGL
Instructions: Includes the Out of this World demo files. You can add your own full game files to the ports/rawgl/gamedata/ folder. See this [link](https://github.com/cyxx/rawgl#supported-versions] for more supported files info. Then just start RAWGL from Ports in the emulationstation menu. \
Notes: Thanks to [cyxx](https://github.com/cyxx/rawgl) for the rawgl engine that makes this possible. Also thanks to [Jetup13](https://github.com/Jetup13/rawgl-oga) for the porting work for portmaster.
### RLVM (RealLive VM)
Instructions: Add your game files to the ports/rlvm/games/GAME_NAME directory, multiple games can be installed and you will get a choice of which game you want to play at launch. HD Releases do not currently work properly. \
Notes: Thanks to [Elliot Glaysher](https://github.com/eglaysher/rlvm.git) for the rlvm interpreter that makes this possible. Also thanks to [kloptops](https://github.com/kloptops/rlvm) for the porting work for portmaster.
### Redneck Rampage 1
Instructions: You'll need to add your own full version REDNECK.GRP and REDNECK.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-redneck1/gamedata folder. Then you should be able to start Redneck Rampage from the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Redneck Rampage 2
Instructions: You'll need to add your own full version REDNECK.GRP and REDNECK.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-redneck2/gamedata folder. Then you should be able to start Redneck Rampage Rides Again from the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Reminiscence (Flashback)
Instructions: You will need the original files of the PC version copied to ports/reminiscence/gamedata folder. Then you should be able to start REminiscence from the Ports section in the emulationstation menu. \
Notes: Thanks to [Alex Chermenin](https://github.com/chermenin/REminiscence) for the Reminiscence engine that makes this possible. Also thanks to [Jetup](https://github.com/Jetup13/REminiscence-oga) and romadu for the porting work for portmaster.
### Return to Castle Wolfenstein
Instructions: You'll need to add your own pak0.pk3, sp_pak1.pk3, sp_pak2.pk3, sp_pak3.pk3 and sp_pak4.pk3 to the ports/iortcw/main folder. The Steam version seems to work best as it's patched for Linux use already. Then you should be able to start Return to Castle Wolfenstein from the emulationstation menu. \
Notes: Thanks to [Donny Springer, Zack Middleton, James Canete and other contributors](https://github.com/iortcw/iortcw) for this engine. Also thanks to [JohnnyonFlame](https://github.com/JohnnyonFlame/handheld-iortcw) for the porting work for portmaster and romadu for the packaging for portmaster. \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### RVGL
Instructions: Necessary files will be downloaded and installed upon initial launch while connected to the internet. Just start RVGL from Ports in the emulationstation menu. You can also manually download the needed files from [Re-Volt I/O](https://re-volt.io/downloads/misc)\
Notes: Thanks to the [RV Team](https://rvgl.re-volt.io/) for this cross-platform rewrite / port of Re-Volt. Also thanks to romadu for the packaging for portmaster.
### Rick Dangerous (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Rick Dangerous
Instructions: Rick Dangerous files are already included and ready to go. Just start Rick Dangerous from Ports in the emulationstation menu. \
Notes: Thanks to [r-type](https://github.com/r-type/xrick-libretro) for creating this libretro/retroarch core and thanks to [Libretro](https://github.com/libretro/xrick-libretro) for officially incorporating this as a retroarch core.
### Ri-li
Instructions: The game files are already included and ready to go. Just start Ri-li from Ports in the Emulationstation menu. \
Notes: Thanks to the [Ri-li team](https://ri-li.sourceforge.net/index.html) for creating this open source port. Also thanks to Kloptops & Cebion for the packaging for portmaster.
### Rigel Engine
Instructions: You'll need to add your own full game files to the ports/RigelEngine/ folder. Then just start RigelEngine from Ports in emulationstation menu. \
Notes: Thanks to [Lethal Guitar](https://github.com/lethal-guitar/RigelEngine) for the source port of this game. Also thanks to romadu for the porting work for portmaster.
### Rise of the Triad (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: Demo files are already included. You can also add your full version files to the ports/rott folder. Just start ROTT from Ports in emulationstation menu. \
Notes: Thanks to [icculus](https://icculus.org/rott/) for the source port of this game. Also thanks to romadu for the porting work for the rk3326 platform.
Notes: Thanks to [icculus](https://icculus.org/rott/) for the source port of this game. Also thanks to romadu for the porting work for portmaster.
### Rigel Engine (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You'll need to add your own full game files to the ports/RigelEngine/ folder. Then just start RigelEngine from Ports in emulationstation menu. \
Notes: Thanks to [Lethal Guitar](https://github.com/lethal-guitar/RigelEngine) for the source port of this game. Also thanks to romadu for the porting work for the rk3326 platform.
### Rocks 'N' Diamonds (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Rocks 'N' Diamonds
Instructions: Rocks 'N' Diamonds files are already included and ready to go. Just start Rocks N Diamonds from Ports in the emulationstation menu. \
Notes: Thanks to [Artsoft Entertainment](https://git.artsoft.org/rocksndiamonds.git/) for creating this game and making it available for free.
### Shadow Warrior (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Shadow Warrior
Instructions: You must add your own full version SW.GRP and SW.RTS Shadow Warrior files to the ports/shadow-warrior folder. More information about the installation along with how to include music is available [here](https://www.jonof.id.au/jfsw/readme.html#install) \
Notes: Thanks to [Jonathon Fowler](https://github.com/jonof/jfsw) for the source port of Ken Silverman's build engine. Also thanks to romadu for the porting work for the rk3326 platform.
Notes: Thanks to [Jonathon Fowler](https://github.com/jonof/jfsw) for the source port of Ken Silverman's build engine. Also thanks to romadu for the porting work for portmaster.
### Shovel Knight - Treasure Trove (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Shipwreck
Instructions: You must have a copy of Shipwreck by Brushfire games for Linux or Windows. Copy data into the `ports/shipwreck/gamedata` folder. Then just start Shipwreck from Ports in the emulationstation menu. \
Notes: Thanks to the [FNA-XNA](https://github.com/FNA-XNA/FNA) project for the runtime that's used to make this possible. \
Thanks to JohnnyonFlame for the FNA fork to run FNA games on these devices. \
Thanks to jtothebell for the port work that makes this possible. \
You can sponsor FNA-XNA's work [here](https://github.com/sponsors/flibitijibibo) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame) \
You can sponsor jtothebell's work [here](https://github.com/sponsors/jtothebell)
### Shovel Knight - Treasure Trove
Instructions: You must have a copy of Shovel Knight Treasure Trove for Linux. You'll need the shovelknight folder:
1. Be sure the folder contains subfolders named 32, 64 and data. There should also be a filed named ShovelKnight.
2. Copy the shovelknight folder to the roms/ports folder on your device.
@ -302,18 +511,22 @@ Instructions: You must have a copy of Shovel Knight Treasure Trove for Linux. Y
Notes: **For PortMaster version, copy your Shovel Knight Treasure Trove for Linux folder to the ports/shovelknight/gamedata folder. You should have ports/shovelknight/gamedata/shovelknight folder structure with additional subfolders such as 32, 64, and data within ports/shovelknight/gamedata/shovelknight. Once done, just run Shovel Knight.sh.
Thanks to ptitSeb for box86 (https://github.com/ptitSeb/box86) \
Thanks to JohnnyonFlame for gl4es and the necessary packaging to allow this game to run on ArkOS. (https://github.com/JohnnyonFlame/gl4es/tree/sk_hacks) \
Thanks to JohnnyonFlame for gl4es and the necessary packaging to allow this game to run on supported linux distros. (https://github.com/JohnnyonFlame/gl4es/tree/sk_hacks) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### SDLPoP (Prince of Persia) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Simple Sokoban
Instructions: Simple Sokoban files are already included and ready to go. Just start Simple Sokoban from Ports in the emulationstation menu. \
Notes: Thanks to [Mateusz Viste](http://simplesok.osdn.io/) for creating the open source game. Also thanks to christopher-roelofs for the porting and packaging for portmaster.
### SDLPoP (Prince of Persia)
Instructions: The game is an open-source port and is already included and ready to go. Just start SDLPoP from Ports in the emulationstation menu. \
Notes: Thanks to [NagyD](https://github.com/NagyD/SDLPoP) for the open-source port of this game which makes this possible.
### Ski Jump 3 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Ski Jump 3
Instructions: Ski Jump 3 files are already included and ready to go. Just start Skijump3 from Ports in the emulationstation menu. \
Notes: Thanks to [suomipelit](https://github.com/suomipelit/skijump3-sdl) for creating this SDL2 ports. Also thanks to cebion for the porting work for the rk3326 platform.
Notes: Thanks to [suomipelit](https://github.com/suomipelit/skijump3-sdl) for creating this SDL2 ports. Also thanks to cebion for the porting work for portmaster.
### Sonic 1 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Sonic 1
Instructions: You must have a copy of the Sonic The Hedgehog Classic Android APK then do the following:
1. Using 7Zip, open the apk and extract /assets/Data.rsdk.xmf.
2. Rename the Data.rsdk.xmf to Data.rsdk. Case is important!
@ -323,7 +536,7 @@ Instructions: You must have a copy of the Sonic The Hedgehog Classic Android APK
Notes: Thanks to [Rubberduckycooly](https://github.com/Rubberduckycooly/Sonic-1-2-2013-Decompilation) for the decompilation work that makes this possible.
### Sonic 2 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Sonic 2
Instructions: You must have a copy of the Sonic The Hedgehog 2 Classic Android APK then do the following:
1. Using 7Zip, open the apk and extract /assets/Data.rsdk.xmf.
2. Rename the Data.rsdk.xmf to Data.rsdk. Case is important!
@ -333,7 +546,7 @@ Instructions: You must have a copy of the Sonic The Hedgehog 2 Classic Android A
Notes: Thanks to [Rubberduckycooly](https://github.com/Rubberduckycooly/Sonic-1-2-2013-Decompilation) for the decompilation work that makes this possible.
### Sonic CD (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Sonic CD
Instructions: You must have a copy of the Sonic CD Classic Android APK then do the following:
1. Using 7Zip, open the apk and extract Androind/obb/comm.sega.soniccd.classic/patch49.com.sega.soniccd.classic.obb.
* This file may have a different number such as patch56 or higher which should also work as well.
@ -345,7 +558,17 @@ Instructions: You must have a copy of the Sonic CD Classic Android APK then do t
Notes: Thanks to [Rubberduckycooly](https://github.com/Rubberduckycooly/Sonic-CD-11-Decompilation) for the decompilation work that makes this possible.
### SorR (Streets of Rage Remake)(Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Sonic Mania
Instructions: You must have a copy of the Sonic Mania Plus game from steam then do the following:
1. Copy the Data.rsdk file from your windows install to the ports/sonicmania folder.
2. If all is well, you should be able to run Sonic Mania now.
Notes:
* Thanks to [Rubberduckycooly](https://github.com/Rubberduckycooly/RSDKv5-Decompilation) for the decompilation work that makes this possible. Thanks to [TheGammaSqueeze](https://github.com/TheGammaSqueeze/RSDKv5-Decompilation) for the porting work.
* Please note that the game comes preconfigured for displaying on a 640x480 device (ex. RG351V and RG353V/VS). Unfortunately this truncates the menus a little but does not affect gameplay (the ring and lives hud are placed correctly). If you go to Options then Video, you can force Fullscreen to On and restart the game and it will set the screen to fullscreen for widescreen devices but add black bars at the top and bottom of 4:3 screens like the RG351V. Once you've made this change, you can't go back to 4:3 without either manually editing the settings.ini file within the sonicmania port folder and changing pixWidth to 320 and fullscreen to 0, or redownload the port through portmaster which will overwrite this settings.ini file with the default one provided in the port package that is preconfigured for 4:3.
* To access DLC (Sonic Mania Plus), per the developer's [license requirements](https://github.com/Rubberduckycooly/RSDKv5-Decompilation/blob/master/LICENSE.md), users need to compile this themselves. Thanks to romadu, the compile process has been made as simple as possible by providing a single GitHub repo that can be compiled on a device with ArkOS by following these instructions available [here](https://github.com/romadu/RSDKv5-Decompilation/blob/master/README.md#building-on-device-with-arkos).
### SorR (Streets of Rage Remake)
Instructions: You'll need to provide your own sorr.dat file, mod folder, and palettes folder:
1. Obtain any version of SorR. You can use either the windows or linux/debian version it does not matter which.
2. Extract them /roms/ports/sorr (For RG351V if using SD2, extract to /roms2/ports/sorr instead). You should have a /mod folder, a /palettes folder, and SorR.dat file in this location in order for the game to work.
@ -355,32 +578,52 @@ Instructions: You'll need to provide your own sorr.dat file, mod folder, and pal
Notes: Thanks to [josebagar](https://gitlab.com/josebagar/bennugd-monolithic) for the update to the bennugd-monolithic that made this possible. \
Thanks to [isage](https://github.com/isage/sorr-vita) for the slow down fix that benefits this platform.
### Space Cadet Pinball (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Space Cadet Pinball
Instructions: Just add your own Space Cadet Pinball PINBALL.DAT files and sound files to the spacecadetpinball folder. Then start Space Cadet Pinball from Ports in the emulationstation menu. \
Notes: Thanks to [Muzychenko Andrey](https://github.com/k4zmu2a/SpaceCadetPinball) for the reversed engineering work of this. Also thanks to [Jetup](https://github.com/Jetup13/SpaceCadetPinball) and [romadu](https://github.com/romadu/SpaceCadetPinball) for the porting work for the rk3326 platform.
Notes: Thanks to [Muzychenko Andrey](https://github.com/k4zmu2a/SpaceCadetPinball) for the reversed engineering work of this. Also thanks to [Jetup](https://github.com/Jetup13/SpaceCadetPinball) and [romadu](https://github.com/romadu/SpaceCadetPinball) for the porting work for portmaster.
### Spelunky (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Spelunky
Instructions: Spelunky files are already included and ready to go. Just start Spelunky from Ports in the emulationstation menu.
Notes: Thanks to [ptitSeb](https://github.com/ptitSeb/box86) for box86. \
Thanks to [yancharkin](https://github.com/yancharkin/SpelunkyClassicHD) for the updated source build.
### SRB2 (Sonic Robo Blast 2) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### SRB2 (Sonic Robo Blast 2)
Instructions: Sonic Robo Blast 2 files are already included and ready to go. Just start SRB2 from Ports in the emulationstation menu. To use mods and addons for SRB2, just add the relevant files to ports/SRB2/conf/.srb2/addons and load them using Add Ons menu item while in the game. \
Notes: Thanks to [Sonic Team Junior](https://github.com/STJr/SRB2) for creating this opensource fan game. Also thanks to romadu for the packaging for portmaster.
### SRB2Kart (Sonic Robo Blast 2 Kart) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### SRB2Kart (Sonic Robo Blast 2 Kart)
Instructions: Sonic Robo Blast 2 files are already included and ready to go. Just start Sonic Robo Blast 2 Kart from Ports in the emulationstation menu. To use mods and addons for SRB2, just add the relevant files to ports/srb2kart/.srb2kart and load them using Add Ons menu item while in the game.\
Notes: Thanks to [Sonic Team Junior](https://github.com/STJr/Kart-Public) for creating this opensource fan game. Also thanks to romadu for the packaging for portmaster.
### Star Wars Jedi Knight - Jedi Academy (RG552 Only) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Starcatcher
Instructions: Starcatcher files are already included and ready to go. Just start Starcatcher from Ports in the Emulationstation menu. \
Notes: Thanks to the team of [Escada Games](https://github.com/Escada-Games/starcatcher) for creating this game and making available for free and [efornara](https://github.com/efornara/frt) for creating the FRT platform. Also thanks to Cebion for the packaging for portmaster.
### Star Wars Jedi Knight - Jedi Academy (RG552 Only)
Instructions: You need to add your own full game pak files to the ports/JediAcademy/base folder. Then you should be able to launch Star Wars Jedi Knight - Jedi Academy from Ports in the emulationStation menu. \
Notes: Thanks to [JACoders](https://github.com/JACoders/OpenJK) for the opensource engine. Also thanks to [brooksytech](https://github.com/brooksytech/OpenJK-RG552) for the porting and packaging for portmaster.
### Star Wars Jedi Knight II - Jedi Outcast (RG552 Only) (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
Instructions: You need to add your own full game pak files to the ports/JediOutcast/base folder. Then you should be able to launch Star Wars Jedi Knight - Jedi Outcast from Ports in the emulationStation menu. \
### Star Wars Jedi Knight II - Jedi Outcast (RG552 Only)
Instructions: You need to add your own full game pak files to the ports/JediOutcast/base folder. Then you should be able to launch Star Wars Jedi Knight - Jedi Outcast from Ports in the emulationstation menu. \
Notes: Thanks to [JACoders](https://github.com/JACoders/OpenJK) for the opensource engine. Also thanks to [brooksytech](https://github.com/brooksytech/OpenJK-RG552) for the porting and packaging for portmaster.
### Super Mario War (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Stardew Valley
Instructions: You must have a copy of the [compatibility version](https://www.stardewvalley.net/compatibility/) of Stardew Valley for Linux. The windows version may work as well. Steam or GOG versions should work. Copy data into the ports/stardewvalley/gamedata folder \
Then just start StardewValley from Ports in the emulationstation menu. \
Notes: Thanks to the [MonoGame](https://github.com/MonoGame/MonoGame) project for the framework that's used to make this possible. \
Thanks to JohnnyonFlame for the port work that makes this possible. \
You can donate towards MonoGame's work [here](https://www.monogame.net/donate/) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Steel Assault (RG552 Only)
Instructions: You must have a copy of Steel Assault for Linux. Copy data into the ports/steelassault/gamedata folder \
Then just start SteelAssault from Ports in the emulationstation menu. \
Notes: Thanks to the [FNA-XNA](https://github.com/FNA-XNA/FNA) project for the runtime that's used to make this possible. \
Thanks to JohnnyonFlame for the port work that makes this possible. \
You can sponsor FNA-XNA's work [here](https://github.com/sponsors/flibitijibibo) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Super Mario War
Instructions: Super Mario War files are already included and ready to go. Just start Super Mario War from Ports in the emulationstation menu.
**Netplay**: There's a netplay feature available with the portmaster version that supports network play between multiple units. According to the author ([mmatyas](https://github.com/mmatyas/supermariowar/blob/master/docs/netplay.md)) of this feature, it is very much experimental so performance will vary depending on a a number of factors not limited to network latency, connection quality (2.4Ghz vs 5Ghz, vs Wired connection) and if attempting to play over Internet, lag and disconnects. To use this feature: you can do the following:
@ -391,31 +634,94 @@ Instructions: Super Mario War files are already included and ready to go. Just
- Be aware that if playing over internet, the unit with the smw server started must have port forwarding on that wifi or wired router's configuration for UDP 12521 to point to the internal IP of the unit running the smw server. If this is not done, Internet based players may not be able to join the smw server.
1. Once connected, a room must be created with a name. With the PortMaster setup, the x and y button can be used to just name the room x or y so the room can be setup and all players can enter the room and start playing.
Notes: Thanks to [mmatyas](https://github.com/mmatyas/supermariowar) for continuing the work originally started by Samuele Poletto and then Florian Hufsky to make this game what it is today.
Notes: Thanks to [Mátyás Mustoha](https://github.com/mmatyas/supermariowar) for continuing the work originally started by Samuele Poletto and then Florian Hufsky to make this game what it is today.
### SuperTux (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### SuperTux
Instructions: SuperTux files are already included and ready to go. Just start SuperTux from Ports in the emulationstation menu. \
Notes: Thanks to the [SuperTux](https://github.com/SuperTux/supertux) team and contributors for creating and making this game what it is today.
### Tomb Raider 1 (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Tamatool (Tamagotchi P1 Explorer)
Instructions: You will need a compatible Tamagotchi P1 ROM called rom.bin in its folder. The expected ROM format is 16 bits in big-endian per instruction (the actual E0C6S46 instructions are 12-bit long). \
Notes: Thanks to [Tamatool](https://github.com/jcrona/tamatool) for this Tamagotchi P1 explorer. Also thanks to Bamboozler for the porting work for portmaster.
### Thermomorph
Instructions: Thermomorph files are already included and ready to go. Just start the game from Ports in the Emulationstation menu. \
Notes: Thanks to [Varun Ramesh](https://github.com/rameshvarun/thermomorph) for creating this game and making it available for free. Also thanks to Cebion for the packaging for portmaster.
### Tile World
Instructions: Tile World files are already included and ready to go. To play the original Chip's Challenge levels, copy your chips.dat file into ports/tileworld/data folder and make sure it's lowercase. Just start Tile World from Ports in the emulationstation menu \
Notes: Thanks to [Ricardo Angeli](https://github.com/rangeli/tileworld) for this emulation port of Chip's Challenge created by Chuck Sommerville. Also thanks to Slayer366 for the porting work for portmaster.
### Timespinner
Instructions: You must have a copy of Timespinner for Linux. Copy data into the ports/timespinner/gamedata folder \
Then just start Timespinner from Ports in the emulationstation menu. \
Notes: Thanks to the [FNA-XNA](https://github.com/FNA-XNA/FNA) project for the runtime that's used to make this possible. \
Thanks to JohnnyonFlame for the port work that makes this possible. \
You can sponsor FNA-XNA's work [here](https://github.com/sponsors/flibitijibibo) \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Tiny Crate
Instructions: Tiny Crate files are already included and ready to go. Just start Tiny Crate from Ports in the Emulationstation menu. \
Notes: Thanks to [HarmonyHoney](https://github.com/HarmonyHoney/tiny_crate) for creating this game and making available for free and [efornara](https://github.com/efornara/frt) for creating the FRT platform. Also thanks to Cebion for the packaging for portmaster.
### Titan Tactics
Instructions: Titan Tactics files are already included and ready to go. Just start Titan Tactics from Ports in the Emulationstation menu. \
Notes: Thanks to [Team Potato](https://gitlab.com/team-potato/titan_tactics) for creating this game and making available for free and [efornara](https://github.com/efornara/frt) for creating the FRT platform. Also thanks to Cebion for the packaging for portmaster.
### Tomb Raider 1
Instructions: Just add your steam or gog Tomb Raider 1 files to the ports/tombraider1 folder. Then you should be able to launch Tomb Raider 1 from Ports in the emulationStation menu. \
Notes: Thanks to [XProger](https://github.com/XProger/OpenLara) for the OpenLara engine that makes this possible.
### Undertale (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Ultimate Tapan Kaikki
Instructions: The game files are already included and ready to go. Just start Ultimate Tapan Kaikki from Ports in the Emulationstation menu. \
Notes: Thanks to the [suomipelit team](https://github.com/suomipelit/ultimatetapankaikki) for creating this open source port. Also thanks to Kloptops and Cebion for the packaging for portmaster.
### Undertale
Instructions: You'll need to provide your own Undertale Linux version assets. You can purchase this from GoG for under $10. If you purchase this from GoG, you'll need to download the Linux version and it will have a .sh extension. Just change the .sh to .gz and use 7zip to open the file, then go to the \data\noarch\game\assets folder and copy all of it's contents to your /roms/ports/undertale/assets folder. Then you should be able to launch Undertale from Ports in the emulationstation menu. \
Notes: It's been reported that version 1.0.8 seems to work best with this setup. \
Notes:
- It's been reported that version 1.0.8 seems to work best with this setup. Version 2.0 or newer does not work at this time.
- On devices with resolutions higher than 640x480, pressing L1 or L2 will adjust the screen aspect ratio.
Thanks to ptitSeb for box86 (https://github.com/ptitSeb/box86) \
Thanks to JohnnyonFlame for the necessary modification to allow this game to run on ArkOS. \
Thanks to JohnnyonFlame for the necessary modification to allow this game to run on supported linux distros. \
You can donate towards JohnnyonFlame's work [here](https://ko-fi.com/johnnyonflame)
### Ur-Quan Masters (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Upo
Instructions: Upo files are already included and ready to go. Just start the game from Ports in the Emulationstation menu. \
Notes: Thanks to [Eemeli Mark](https://github.com/TheJeme/upo) for creating this game and making it available for free. Also thanks to Cebion for the packaging for portmaster.
### Ur-Quan Masters
Instructions: Ur-Quan Masters files are already included and ready to go. Just start UQM from Ports in the emulationstation menu. \
Notes: Thanks to [avolkov, luminescent, mcmartin and meep-eep](https://sourceforge.net/p/sc2/uqm/ci/main/tree/) for the creation and continued updates of this engine.
### VVVVVV (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### VanillaRA (Command and Conquor Red Alert)
Instructions: Demo files are already included. If you want to play the full version, you will need to place at least MAIN.MIX & READALERT.MIX into ports/vanillara/data/vanillara. You can get the game files from [here](https://github.com/TheAssemblyArmada/Vanilla-Conquer#vanillatd-and-vanillara). For multiple cd's for the campaigns & expansions it is a little more complex. Follow the installation instructions from [here](https://github.com/TheAssemblyArmada/Vanilla-Conquer/wiki/Installing-VanillaRA). If you want to use the expansions you will need the files from the patch 3.03, [available here](https://www.moddb.com/games/cc-red-alert/downloads/red-alert-303-beta-english-patch). \
Notes: Thanks to [TheAssemblyArmada](https://github.com/TheAssemblyArmada/Vanilla-Conquer) and other contributors for the build. Also thanks to kloptops and Snoopy from the AmberElec Discord for the porting work.
### VanillaTD (Command and Conquor Tiberium Dawn)
Instructions: Demo files are already included. If you want to play the full version, you will need to place the game files from the [following guide](https://github.com/TheAssemblyArmada/Vanilla-Conquer/wiki/Installing-VanillaTD) into ports/vanillatd/data/vanillatd. You will need to delete all the game files in ports/vanillatd/data/vanillatd before installing full game files. \
Notes: Thanks to [Vanilla Conquer](https://github.com/TheAssemblyArmada/Vanilla-Conquer) and other contributors for the build. Also thanks to kloptops and Snoopy from the AmberElec Discord for the porting work.
### VCMI - Heroes of Might and Magic III
Instructions: You need to add required game files either from CD1 & CD2, GoG or an installed copy of the game. This requires about 2-3 gb of free space. For the gog version copy `setup_heroes_of_might_and_magic_3_complete_4.0_(28740)-1.bin` and `setup_heroes_of_might_and_magic_3_complete_4.0_(28740).exe` into `ports/vcmi`. For the cd version copy the contents of cd1 into `ports/vcmi/cd1` and cd2 into `ports/vcmi/cd2`. For the installed version copy installed game files into `ports/vcmi/install`. \
Notes: Thanks to [VCMI Team](https://github.com/vcmi/vcmi) for the open source Heroes of Might and Magic III engine that makes this possible. Also thanks to the [kloptops](https://github.com/kloptops/Portmaster-misc/tree/main/VCMI) for the porting work for portmaster.
### VVVVVV
Instructions: The free Make and Play Edition data.zip file is already included. Just start VVVVVV from Ports in the emulationstation menu. You can also add your own purchased copy of the data.zip from your VVVVVV into the /roms/ports/VVVVVV folder if you prefer that version instead. \
Notes: Thanks to [Terry Cavanagh](https://github.com/TerryCavanagh/VVVVVV) and other authors and contributors for the creation and continued updates of this game.
### World War II GI (Available through [PortMaster](https://github.com/christianhaitian/arkos/wiki/PortMaster))
### Wetspot 2
Instructions: Wetspot 2 files are already included and ready to go. Just start Wetspot 2 from Ports in the Emulationstation menu. \
Notes: Thanks to [dmitrysmagin](https://github.com/dmitrysmagin/wetspot2) and [Angelo Mottola](https://geocities.restorativland.org/SiliconValley/Lakes/7303/) for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.
### Wordle SDL
Instructions: Wordle files are already included and ready to go. Just start Wordle from Ports in the emulationstation menu. \
Notes: Thanks to [Andrei Rafael](https://github.com/AndreiRafael/wordle_clone) for the original port and Rinnegatamante for the non desktop control logic. Also thanks to Bamboozler for the packaging for portmaster.
### World War II GI
Instructions: You'll need to add your own full version WW2GI.GRP and WW2DI.RTS and .CON files and optionally CD audio tracks as OGG file in the format trackXX.ogg (where XX is the track number) to the ports/rednukem-WWII/gamedata folder. Then yo should be able to launch World War II GI from Ports in the emulationstation menu. \
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for the rk3326 platform.
Notes: Thanks to [Nukeykt](https://github.com/nukeykt/NBlood) for the Rednukem engine that makes this possible. Also thanks to [romadu](https://github.com/romadu/NBlood) for the porting work for portmaster.
### Worship Vector
Instructions: Worship Vector files are already included and ready to go. Just start Worship Vector from Ports in the Emulationstation menu. \
Notes: Thanks to [Quasist, JohnnyonFlame and Zear](https://github.com/JohnnyonFlame/Worship-Vector) and other contributors for creating this game and making available for free. Also thanks to Cebion for the packaging for portmaster.