View source for OS4 Adding ROMs

It is necessary to access the RGB-Pi file system in order to accomplish tasks such as adding '''ROMs''' and '''BIOSes'''. Access to the file system also makes it possible to save copies of your game list, favourites, save states, music, themes, etc. There are two different approaches to gaining access to the RGB-Pi file system:

* Network access
* Connecting the RGB-Pi SD card to a PC

'''Recommended:''' RGB-Pi OS can also be configured to use ROMs and all the above mentioned content from an external USB drive and even from a NAS.

==File System Layout==

It doesn't matter the way you access to the file system, you'll be always presented with the following basic schema:

* nfsg (NFS global)
* nfsl (NFS local)
* sd
* usb1
* usb2

==Transferring files via a network connection==

===Getting your RGB-Pi IP Network Address===

Before connecting from your PC to RGB-Pi OS, you need to know the IP address of the same. If you already plugged a network cable or configured a Wi-Fi connection, you should be able to get your IP from the Network menu.

===File transfer via SFTP===

SFTP is a secure file transfer protocol that also allows other computers on the local network to access and transfer files to RGB-Pi OS.

The most extended 3rd party tools for accessing via SFTP are:
* [https://filezilla-project.org Filezilla]
* [https://winscp.net/eng/download.php WinSCP]

Use your RGB-Pi OS IP address and '''port 22''' to connect. The credentials are: username '''pi''' and password '''rgbpi'''

===Direct drive access===

This method consists of mounting the SD card on a host PC running Windows, Linux, or OS X.

====Access from a Linux host====

If you’re on Linux, you can simply mount your SD card by using any smart-card reader or USB adapted. This way, you don’t need network connection, and you can access all files on your drive (/media folder).

====Access from a Windows host====

Accessing '''ext4''' partitions from windows is not supported natively but you can install a [https://www.howtogeek.com/112888/3-ways-to-access-your-linux-partitions-from-windows/ 3rd party driver] to achieve the same (we have not tested this method).

====Access from an OS X host====

Mac OS X does not allow users to mount '''ext4''' partitions natively but you can use one of the following programs:
* [https://www.paragon-software.com/home/extfs-mac/ Paragon’s ExtFS] which is paid software.
* [https://osxdaily.com/2014/03/20/mount-ext-linux-file-system-mac/ OSXFuse] which is a free software.

Please do note that '''we have not tested''' any of the two above solutions.

==Using an external USB drive==

RGB-Pi OS offers the possibility to store your ROMs, BIOS, game list information and favourites on an external USB drive.

Plug your USB storage in your PC, and check that the unit only contains one partiton. Then you can format the same in FAT32 or exFAT. This is the most easy way of accessing to your files from any PC and also to move all your content from one Raspberry to another. Another good example is when for some reason, your RGB-Pi OS SD card gets corrupted. By using an external USB drive you could write a new copy of the system and plug your USB again.

For detailed instructions on how to configure an external USB or NAS drive, please check the corresponding documentation in this wiki.

==Make ROMs available==

After copying your roms, please remember to execute the Scan Games option from the options menu. This will build the corresponding database with all your games scraped.

== Miscellany ==

The version of MAME used by OS4 is MAME 0.244