External Storage on Downloader 1.5

(ESPAÑOL ABAJO)

Downloader 1.5 is live!

This was the biggest release to this date in terms of changes in the code, so releasing it makes me feel quite relieved.

The CHANGELOG for this release is nothing to be shy of, but the real star of this release is a new feature called "Storage Priority Resolution".

This new feature allows Downloader to take advantage of your external storage when installing new files without having to do almost any extra configuration step. The end result for the user is having that plug & play feeling that we usually get when using modern consoles with external drives.

How to make use of your external storage thanks to Storage Priority Resolution

First I'd like to clarify what do I mean by external storage. I'm talking about USB Drives that you may connect to the USB ports of your MiSTer, or a network partition mounted at /media/fat/cifs.

Once you have plugged any external storage, MiSTer OS will detect it automatically. And with the default options, Downloader will be configured to use it out of the box.

Not all files and folders are meant to be installed on external drives, though. The ones that you'll want to install there are the files contained in heavy folders, such as games/* or docs/*. And by default, to have them installed on your external storage you'll need to create such directories there.

For example, if you'd like Downloader to install all PlayStation bios files on your external storage, you'd have to create the folder games/PSX on your external drive yourself. After that, Downloader will always take care of installing/removing anything going to games/PSX in that external drive.

For transitioning from a setup where you had your games/PSX folder on the SD to one containing it on your USB Drive, you just simply need to move the folder from one location to the other, without having to touch anything else.

"But I want ALL files under 'games' to be installed on my USB drive without having to manually create folders"

There is an option for that too. It is not the default behaviour because it could be problematic for some users, but it's very easy to enable it.

For activating this option, you'll have to edit the file downloader.ini in the root of the SD (or create it if it doesn't exist). In that file, as it's described here, you need to add the config option "storage_priority" and assign the value "prefer_external".

After that, all games & docs files will be always installed in the external storage that you have connected to your MiSTer, without having to manually create folders at all.

Conclusion

This feature is great for 2 use cases specially:

- Setups where you want to opt-in into installing big libraries on external drives, like the ones from the CD consoles.

- Setups with minimal SDs and a USB drive that should take most of the load. For this one, the "prefer_external" option is recommended.

As you might guess, releasing this before PSX & Saturn cores was my main goal, so I'm quite happy that I managed to make it on time.

Enjoy!

ESPAÑOL

¡Downloader 1.5 ya ha salido!

Esta ha sido la entrega más grande que hecho en cuanto a cantidad de cambios en el código, por lo que publicarlo me quita por fin una buena carga de encima.

El CHANGELOG de esta versión no es nada de lo que avergonzarse, pero la estrella de la 1.5 es una nueva funcionalidad llamada "Storage Priority Resolution".

Esta nueva funcionalidad permite a Downloader hacer uso de almacenamiento externo al momento de instalar nuevos archivos, sin tener el usuario que configurar casi nada. El resultado final es una experiencia muy plug & play, similar a la que estamos acostumbrados cuando usamos consolas modernas con almacenamiento externo.

Cómo hacer uso del almacenamiento externo gracias a Storage Priority Resolution

Primeramente me gustaría concretar a qué llamo almacenamiento externo. Obviamente me refiero a Unidades USB que puedes conectar a los puertos USB de MiSTer, o a unidades de red montadas en /media/fat/cifs.

Una vez que has conectado algún almacenamiento externo, el sistema operativo de MiSTer lo va a detectar automáticamente. Y con las opciones por defecto, Downloader estará configurado para usarlo directamente.

Sin embargo, no todos los archivos y directorios están pensados para ser almacenados externamente. Los que se instalarían en almacenamiento externo son aquellos que están contenidos en directorios muy pesados, como aquellos en games/* o docs/*. Y para que por defecto se instalen en tu almacenamiento externo es necesario crear previamente tales directorios en tus unidades externas.

Por ejemplo, si quieres que Downloader instale las bios de PlayStation en tu almacenamiento externo, vas a tener que crear el directorio games/PSX en tu unidad externa a mano. Una vez hecho eso, Downloader siempre se encargará de instalar o eliminar cualquier archivo o directorio que vaya dentro de games/PSX en tu almacenamiento externo.

Para pasar de una instalación en la que tenías el directorio games/PSX en la tarjeta SD a una que lo contenga en tu Unidad USB, simplemente tienes que mover el directiro de una ubicación a la otra, sin tener que tocar nada más.

"Pero yo quiero que TODOS los archivos bajo 'games' queden instalados en mi Unidad USB sin tener que crear manualmente ningún directorio"

Hay una opción para eso también. No está activada por defecto por que podría crear problemas a ciertos usuarios, pero se puede activar muy fácilmente.

Para activar la opción, hay que editar el archivo downloader.ini situado en la raíz de la SD (o crearlo si no existiera). En ese archivo, tal y como se describe aquí, tienes que añadir la opción "storage_priority" y asignarle el valor "prefer_external".

Tras ello, todos los archivos que vayan dentro de los directorios games y docs serán siempre instalados en el almacenamiento externo que tengas conectado a MiSTer, sin tener que crear ningún directorio nunca más a mano.

Conclusión

Esta funcionalidad es ideal para dos casos especialmente:

- Para instalaciones en las que quieres ir añadiendo directorios con librerías grandes que quieras almacenar externamente, como las de las consolas que usan CDs.

- Para instalaciones con tarjetas SDs muy pequeñas que tengan una Unidad USB siempre conectada. Para este caso, la opción "prefer_external" sería la idónea.

Como podéis suponer, sacar esta funcionalidad antes de que los cores de PlayStation y Saturn sean publicados, ha sido my meta principal durante este desarrollo, así que estoy bastante contento con haberlo conseguido a tiempo.

¡Que lo disfrutéis!