Skip to content

theypsilon/Update_All_MiSTer

Repository files navigation

Update All ViewCount GitHub all releases GitHub Workflow Status Patreon donate button Twitter

All-in-one script for keeping up-to-date with the MiSTer ecosystem.

This script runs the MiSTer Downloader under the hood. It expands it by selecting additional downloader databases.

Update All has a Settings Screen that allows you to configure which databases and tools you want to use. In said screen the menu includes:

  1. Main Distribution. Downloads most essential files, including cores and firmware. You are able to select between two versions:
  2. JTCORES for MiSTer. Downloads many cores made by Jotego Team. [Default option]
    • You may additionally enable patreon-only cores.
  3. Coin-Op Collection. Downloads cores developed by the Coin-Op Collection organization. [Default option]
  4. Other Cores. A selection of curated databases that provide unofficial cores, including:
  5. Other Tools & Scripts. Additional tools & scripts.
    • Arcade Organizer. Creates a folder structure under _Arcade/_Organized for easy navigation to all the MRA files. [Disabled by default]
    • Names TXT. Downloads a complete names.txt file curated by Threepwood that enables better core names in the menus. [Disabled by default]
    • And more...
  6. Extra Content. A selection of curated databases that provide extra content. Roms, Bios, Wallpapers, etc.
  7. Analogue Pocket. Tools to connect your MiSTer with your Analogue Pocket.
  8. Patron Menu. A menu with exclusive contents for members of my Patreon community.

Installation

Download this ZIP file and extract update_all.sh to your /Scripts folder on your primary SD card (create that folder if it doesn't exist). You only need to perform this operation once, since this tool self-updates itself.

Then turn on your MiSTer, go to the Scripts menu and run this script from there.

It will take around 15 minutes the first time you run it, but later runs should take much less time.

Accessing the Settings Screen

settings screen

The Settings screen will show up if you press UP in your controller or keyboard during the countdown showing up right after starting update_all.sh in your MiSTer. Please, don't forget to select SAVE to keep all the changes you have done before leaving.

PC Launcher (for Windows, Mac, and Linux)

Check MiSTer Downloader's PC Launcher to download all MiSTer files on your PC. Useful if you can't connect your MiSTer to the internet.

To install the same files that you get with Update All, use the same downloader.ini file that you have in your MiSTer at the root of the SD card. Keep in mind that Update All writes into that file every time you change something in the Settings Screen.

Alternative Installation on MiSTer (via Downloader)

Manually edit the downloader.ini file on the root of your SD (or create it if it doesn't exist) to add the following lines:

[update_all_mister]
db_url = https://raw.githubusercontent.com/theypsilon/Update_All_MiSTer/db/update_all_db.json

Then turn on your MiSTer, go to the Scripts menu and run update or downloader from there (they are both equivalent).

It will install Update All and other files. Then go back to the Scripts menu and run it.

NOTE: This alternative method installs the same files as the other one, but it's a bit safer.

How to avoid executing remote code altogether (Installation via Downloader)

If you're concerned about executing a build that the launcher fetches from the web, you can avoid it by installing Update All in the following way:

If not done manually, the launcher will automatically install the Update All and Downloader builds during its first run. This auto-installation occurs only once and is designed to be secure.

Funding

Consider funding Alexey Melnikov "Sorgelig" for his invaluable work on the MiSTer project.

Check also other core developers that you might want to support:

And finally, if you would like to support my work, you may also subscribe to my patreon here: https://www.patreon.com/bePatron?u=37499475

Supporters+ shout-out!

Alex Frégeau, The Sentinel's Playground Team, Thomas Williams, and W S.

Thank you so much for supporting this project on Patreon! You'll show up here if you become a Supporter+!

Special thanks to Locutus73 for all his great work on the older Updater script. That Updater script is no longer used by Update All but it was an amazing source of inspiration.

License

Copyright © 2020-2024, José Manuel Barroso Galindo. Released under the GPL v3 License.

Warning

MiSTer Scripts are run with root access in a pretty powerful device that has internet access. Be careful and do proper research before running any script on your device.

About

All-in-one script for updating your MiSTer

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published