Michel-FK b612a89b36 cleanup structure
Signed-off-by: Michel-FK <michel.stempin@funkey-project.com>
2021-02-01 22:51:45 +01:00

42 lines
4.0 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){.lightbox} | 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){.lightbox} | At the launcher's main screen (example here with gmenu2x), press the <i class="funkey-menu"></i> key |
| ![Mount USB](/assets/images/Mount_USB_gmenu2x.png){.lightbox} | Press the <i class="funkey-up"></i> or <i class="funkey-down"></i> keys until you see "**MOUNT USB**" |
| ![Mount USB Are you sure](/assets/images/Mount_USB_are_you_sure_gmenu2x.png){.lightbox} | Press the <i class="funkey-A"></i> key twice to confirm |
| ![Eject USB](/assets/images/Eject_USB_gmenu2x.png){.lightbox} | "**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){.lightbox} | 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){.lightbox} | 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){.lightbox} | Eject cleanly the USB drive from your computer |
| ![Eject USB Are you sure](/assets/images/Eject_USB_are_you_sure_gmenu2x.png){.lightbox} | Back on the **FunKey S**, at the "**EJECT USB**" menu entry, press the <i class="funkey-A"></i> key twice to confirm |
| ![Unmount USB](/assets/images/Mount_USB_gmenu2x.png){.lightbox} | Press the <i class="funkey-menu"></i> 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<--