How to Use¶
So, you’ve got your MiSTer, followed the “How to Setup” guide, now what? Let’s get you more familiar with what you can do!
Before you continue…
You’ll need a USB keyboard, and internet for the MiSTer.
Make sure both are plugged in, and power on the MiSTer. The red, orange and green led lights should start pulsing, and you should see the MiSTer menu onscreen after a second or two.
Important Menu Keys¶
Key | Function |
---|---|
Brings up the Menu in a Core. | F12 |
Brings up the Core Menu | ALT+F12 |
Navigate the Menu | Up and Down |
Changes the Background | F1 |
Bluetooth Pairing Menu (bluetooth) | F11 |
Linux Prompt | F9 / F12 to go back to the Menu |
Reboot | Left Shift+Left Ctrl+Left Alt+Right Alt |
Screenshot | Win+Print Screen |
bluetooth: for supported BT adaptors.
Fixing Missing Certificates¶
The default system comes with no cert files, which is a bit annoying, as you need to add --no-check-certificate
on wget
to download anything https.
Lets fix that.
SSH into your MiSTer and type:
1 2 | cd /etc/ssl/certs
wget --no-check-certificate https://curl.haxx.se/ca/cacert.pem
|
Assuming it downloaded correctly, you can now use wget
normally!
Keeping your system updated¶
We’ll need to download the update.sh
script from Github, so lets login to Linux and do so.
Press F9 to bring up the Linux prompt. (Login with user “root”, and password “1”, then copy / paste the below)
1 2 3 | cd /media/fat/Scripts wget --no-check-certificate https://raw.githubusercontent.com/MiSTer-devel/Updater_script_MiSTer/master/update.sh -O update.sh exit |
That will download the updater for you in the correct folder. Once that’s downloaded, it should exit back to the prompt, and we can now update the system from within MiSTer. We only need to download that script once. Once its installed, you can simply run the updater from the Scripts menu.
Updating our system¶
Open up the System Menu (F12) Navigate to Scripts, then run “update” (use the cursor to move and press enter to select). It will download all the latest cores for you and keep your MiSTer updated. MiSTer cores are regularly updated - sometimes daily, so run “update” regularly! Ok, you’re updated, now what?
Samba Sharing Setup¶
Lets setup samba sharing. By default the samba script is disabled, so we need to rename it.
From your MiSTer: Press F9 to go to the linux prompt.
(The default user is root
, and the default password is 1
)
Type or paste the following to enable samba, this will enable samba, and reboot MiSTer
1 2 3 4 | cd /media/fat/linux
mv _samba.sh samba.sh
/media/fat/Scripts/samba_on.sh
reboot
|
If you press F12
again once rebooted, you can see the ip address of your MiSTER in the setup menu.
You can now navigate to your mister via \\IP ADDRESS
on windows or smb://IP ADDRESS
on Mac.
Check your ip address, and navigate to it.
eg if your ip address is 192.168.0.210
Windows¶
Note: this is something I don’t want to call attention to.
File, Run
1 | \\192.168.0.210 |
Mac¶
Press Cmd+K
1 | smb://192.168.0.210 |
You’ll want to start copying appropriate file backups of your cartridges - i.e. roms to the appropriate locations. I usually stick my Console or Computer roms in a folder called roms under the root folder, then sort by name under there.
eg;
1 2 3 4 5 6 | ├── linux └── roms ├── Megadrive ├── SNES ├── NES └── NeoGeo |
Arcade roms, Computer BIOS and Core system rom’s will need to be put elsewhere in a folder called bootrom.
/bootrom/ [ BIOS / Arcade Roms / Core roms go here ]
Important Folders or files - what goes where!¶
Note - If the folders or files don’t exist make them!
If you are connecting over SSH or over Linux (F9) on the MiSTer then use the full folder name ‘/media/fat/…’
If connecting over SMB, then remove the /media/fat/
below as you are already in that folder!
eg /media/fat/menu.jpg
would simply be a file called menu.jpg
in the root folder
/media/fat/menu.jpg or /media/fat/menu.png
Background menu image for MiSTer (Press F1 to cycle through when in the MiSTer menu). Needs to be a jpg or a png format file. MiSTer will resize it for you.
/media/fat/fonts
Fonts folder. Get your fonts here
Edit /media/fat/MiSTer.ini and edit font=fonts/xxx.pf to your choice of font
/media/fat/screenshots
Screenshots taken with Windows Key + PrintScreen will go in here
/media/fat/bootrom
Place your rom files in this folder. Cores will look in this folder first. Note that Arcade cores need to be built specially for MiSTer and copied in here. Instructions to build roms are in the core menu per core.
eg Asteroids, you will need to acquire the rom’s from, uh, your PCB, and download the files from here - then run the build_rom.sh or bat file to create the MiSTer compatible file - a.asteroid.rom
and finally copy that into to /media/fat/bootrom
.