Michel-FK f0ada68cc5 add ROM and OPK drag and drop tutorial
Signed-off-by: Michel-FK <michel.stempin@funkey-project.com>
2021-01-21 09:21:22 +01:00

41 lines
3.9 KiB
Markdown

**OPK** (Open PacKage) files are archive files that contains
emulators, standalone games, applications or utilities along with all
their associated resources like icons packed into a single file that
does not require installation to be able to run them.
!!! Note
In the current (2.0.0) release of the FunKey-OS, the **OPK** files are only available for the gmenu2x launcher, and not in RetroFE.
[7-Zip][1] can be used to extract **OPK** files, and [Open Package
Creator (v1.1.2)][2] is a useful tool if you want to re-package an
**OPK** or customize icons, add additional games and much more.
Connect your **FunKey S** console to your computer and add **OPK**
files as simply as you would do it with a simple USB memory stick:
| **Display** | **Action** |
|:----------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ![Connection PC](/assets/images/Connection_PC.png) | Connect the **FunKey S** to your computer using the provided micro USB cable, then open it to turn it on |
| ![RetroFE](/assets/images/gmenu2x.png) | At the launcher's main screen (example here with gmenu2x), press the **MENU** key |
| ![Mount USB](/assets/images/Mount_USB_gmenu2x.png) | Press the **UP**/**DOWN** keys until you see "**MOUNT USB**" |
| ![Mount USB Are you sure](/assets/images/Mount_USB_are_you_sure_gmenu2x.png) | Press the **A** key twice to confirm |
| ![Eject USB](/assets/images/Eject_USB_gmenu2x.png) | "**EJECT USB**" is now displayed instead, now go to your host computer and open a File Explorer window |
| ![USB Drive](/assets/images/USB_Drive.png) | You should see the **FunKey S** appear as an USB drive on your computer in the File Explorer (example here with Windows 10) |
| ![Copy OPK](/assets/images/Copy_OPK.png) | Drag & drop the **OPK** file into any 1st-level folder[^1] in this USB drive on your computer and they will be automatically available on the **FunKey S** |
| ![Eject Drive](/assets/images/Eject_Drive.png) | Eject cleanly the USB drive from your computer |
| ![Eject USB Are you sure](/assets/images/Eject_USB_are_you_sure_gmenu2x.png) | Back on the **FunKey S**, at the "**EJECT USB**" menu entry, press the "**A**" key twice to confirm |
| ![Unmout USB](/assets/images/Mount_USB_gmenu2x.png) | Press the **MENU** key to return to the launcher screen |
Of course, you can remove **OPK** files from the **FunKey S** console
as you would do with a USB memory stick, too!
[1]: https://www.7-zip.org/download.html
[2]: https://github.com/Harteex/OpenPackageCreator/releases
[^1]: You can create additional 1st-level folders in order to organize your **OPK** files just like you want.
--8<--
includes/glossary.md
--8<--