# -------- NOTES -------- # Arcade core will work on most systems using Update_All # For Console cores make sure you are using the recommended folder structure: /media/fat/games/SNES/ etc. # The script supports zipped Everdrive packs or unzipped folders. # For PSX, MegaCD and Turbografx16 CD your games need to be in CHD format. # !!! Some settings will need a reboot to take effect !!! # -------- GENERAL OPTIONS -------- # Time before Super Attract Mode starts in seconds. On reboot it will wait an additional minute for all services to load up. # SAM comes on at 60s + samtimeout, so default is a 2 mins wait in main menu before SAM starts. # 300 = 5 minutes, 600 = 10 minutes, 900 = 15 minutes samtimeout=60 # Time before going to the next core in seconds gametimer=180 # Start SAM only from MiSTer main menu # If menuonly is set to "No", SAM will start from an active core after you put down the controller. menuonly="yes" # How do we exit SAM? # "No" - SAM will reboot to MiSTer Menu when a button is pushed. # "Yes" - SAM will stay in the current game when exiting. # NOTE - If you push Start on your controller it will play the current game, any other button quits SAM. # Set up Start button if yours isn't working in SAM's menu under "Configure Exit behavior" playcurrentgame="no" # Which systems would you like to display in Attract Mode? # Valid options: amiga,amigacd32,ao486,arcade,atari2600,atari5200,atari7800,atarilynx,c64,cdi,coco2,colecovision,intellivision,fds,gb,gbc,gba,genesis,gg,jaguar,megacd,n64,neogeo,neogeocd,nes,s32x,saturn,sgb,sms,snes,stv,tgfx16,tgfx16cd,vectrex,wonderswan,wonderswancolor,psx,x68k,mgls corelist="arcade,atarilynx,gb,gbc,genesis,gg,megacd,n64,nes,psx,saturn,s32x,sgb,sms,snes,tgfx16,tgfx16cd" # When SAM starts, mute volume. Playing a game will turn on volume. # A reboot or stopping SAM will clear all volume settings and restore any volume settings you have set prior # Options are Yes or No # NOTE - MUTE gets overridden if BGM is active. This setting writes to SD on every exit and startup of SAM mute="Yes" # SAM supports Background Music Player # Drop pls or mp3s in /media/fat/music. More info at https://github.com/wizzomafizzo/MiSTer_BGM # For automated install, set up BGM through SAM's menu (Select "Background Music Player") bgm="No" # Stop BGM when SAM stops bgmstop="Yes" # A Hardware Add-On display for MiSTer # "Yes" shows the text name of the game being played. # Find more options at bottom of file. ttyenable="Yes" # No hacks, prototypes etc. when using strict. Can be "normal" or "strict". normal shows all hacks. dupe_mode="normal" # ---------- SPECIAL MODES -------------- # This is a curated list of games for different cores with great Attract Modes. # Feel free to edit it to your liking at /media/fat/Scripts/.MiSTer_SAM/SAM_Gamelists/sam_goat_list.txt sam_goat_list="No" # SAM game roulette is a mode available in the menu, where you only have a certain amount of time to play a game, before SAM shuffles to the next game. # SAM will ignore any button inputs and shuffle to a new game after the set timer expires. # While SAM is primarily meant as a way to enjoy the pixel art of random games, roulette mode let's you play those games while continuing to shuffle. roulettetimer="500" # Turn your MiSTer into a M82 NES unit - A kiosk display system for NES games that you'd find in a game store in the 80s and 90s. # Edit /media/fat/Scripts/.MiSTer_SAM/SAM_Gamelists/m82_list.txt to customize the m82 list with your favorite games. The system has 12 slots. # Set M82 gametimer (in secs) for how long you want games to be playable. Original M82 has settings for 30 seconds, 3 minutes (180 secs), 6 minutes (360 secs) and 128 minutes (7680 secs). # If m82_mute is set to yes, sound will only come on when a button is pushed to play the game m82="no" m82_game_timer="180" m82_muted="no" # Good to use if you have young children. Limits rom selection to ESRB rated games with the "All Ages" label # Please update SAM after enabling this to download the ESRB game whitelists # Some cores like MegaCD will only have very few games so it's best to use coreweight which you can find further down in this ini # Can be kids or mature rating="No" # Alternative way of selecting cores. Based on how many games a system has. coreweight="no" # When pushing "next game" button on controller, do we want to ignore the current game from now on? # Only works if controller has been configured in menu (or try default button "select") ignore_when_skip="no" # The Amigavision image contains demos and games. Here you can select what Amiga content you want SAM to show. Options are "Demos", "Games" or "All" amigaselect="All" # Some cores require a bios message to be skipped, eg FDS and Saturn. Try a value higher than 10 skiptime="10" # Skip BIOS or other startup messages when loading games # Options are Yes or No skipmessage="Yes" # --------- MGL SCAN DIRECTORIES --------- # Comma-separated directories containing .mgl files for the MGLs console # Example: mgls_dirs="/media/fat/_MGLs,/media/usb0/MGLs" mgls_dirs="" # --------- ARCADE ORIENTATION --------- # Set Arcade orientation to "horizontal" "vertical" or leave empty arcadeorient="horizontal" # --------- PATH FILTER --------- # If you would like to only play games from a subdirectory of your games folder, put it here # Partial match is all you need. Can be part of the path or filename. # Please reboot for path filter to take effect. # # nespathfilter="(Japan)" amigapathfilter="" amigacd32pathfilter="" ao486pathfilter="" arcadepathfilter="" atari2600pathfilter="" atari5200pathfilter="" atari7800pathfilter="" atarilynxpathfilter="" c64pathfilter="" cdipathfilter="" coco2pathfilter="" colecovisionpathfilter="" intellivisionpathfilter="" fdspathfilter="" gbpathfilter="" gbcpathfilter="" gbapathfilter="" genesispathfilter="" ggpathfilter="" jaguarpathfilter="" megacdpathfilter="" n64pathfilter="" neogeopathfilter="" neogeocdpathfilter="" nespathfilter="" psxpathfilter="" s32xpathfilter="" saturnpathfilter="" sgbpathfilter="" smspathfilter="" snespathfilter="" stvpathfilter="" tgfx16pathfilter="" tgfx16cdpathfilter="" vectrexpathfilter="" wonderswanpathfilter="" wonderswancolorpathfilter="" x68kpathfilter="" mglspathfilter="" # FOLDER AND FILE EXCLUSION # Folders and files you would like to exlude, like NSF (Audio files for NES) for example. You don't need to include the full path or file name. # Partial names with case insensitive spelling will suffice. exclude=( readme unsupported bios CPS-0 ) # -------- SAMVIDEO SETTINGS ------- # New method to play commercials through CDI core. samvideo_tvc_cdi="Yes" # Play videos in SAM (eg old video game commercials) # ATTENTION: In order for SAMVIDEO to work, we will modify MiSTer.ini (adding a video_mode for menu core). Please check MiSTer.ini if you experience any issues. samvideo="Yes" # Choose the video output, either HDMI or CRT. Note that only archive playback is supported for "samvideo_source" if using CRT mode. samvideo_output="HDMI" # Change the following setting if you can only hear the audio of the video and SAM shows the Menu core. Some displays need more time. # Setting should be 2 or more. Try higher values if you encounter issues samvideo_displaywait="3" # Use the download manager for improved download speeds from archive.org download_manager="yes" # Customize lists for youtube, archive or local playback # Due to the MiSTer CPU not being very powerful # Recommended video codec is XVID in 640x480 for HDMI or 640x240 for CRT samvideo_path="/media/fat/video" # This option will download all commercials to samvideo_path keep_local_copy="Yes" # Alternate with every core played, play video like another core or only play videos - Options are alternate, core or only samvideo_freq="alternate" #Play videos from youtube, archive or local. Lists are auto generated. Just setting youtube or archive is enough to have videos play from there. #If you're having issues with Youtube, try deleting /media/fat/Scripts/.MiSTer_SAM/ytdl file samvideo_source="Archive" # Play a TV commercial of eg SNES and than show the corresponding SNES game. Only works for archive.org list. samvideo_tvc="Yes" # For HDMI playback if your device shows black bars, try setting sv_aspectfix_vmode to yes. sv_aspectfix_vmode="yes" # SAM modifies MiSTer.ini to set up correct video_modes for video playback. You can disable INI modification by setting sv_inimod to no sv_inimod="yes" # If we mod MiSTer.ini, do we want to return to the backed up ini when SAM quits? # NOTE - This setting writes to SD on every exit when set to yes sv_inibackup="no" # For CRT playback on archive playback we use 640x240 samvideo_crtmode640="video_mode=640,16,64,80,240,1,3,14,12380" # For CRT playback on youtube playback we use 320x240 samvideo_crtmode320="video_mode=320,-16,32,32,240,1,3,13,5670" sv_archive_hdmilist="https://archive.org/download/640x480_videogame_commercials/640x480_videogame_commercials_files.xml" sv_archive_crtlist="https://archive.org/download/640x240_videogame_commercials/640x240_videogame_commercials_files.xml" sv_youtube_hdmilist="/media/fat/Scripts/.MiSTer_SAM/sv_yt360_list.txt" sv_youtube_crtlist="/media/fat/Scripts/.MiSTer_SAM/sv_yt240_list.txt" # -------- ADVANCED (HANDLE WITH CARE) -------- # QUALITY OF LIFE FEATURES # SAM will play every game on your system once before starting from the beginning. Change this to disable SAM's no repeat feature. norepeat="Yes" # Disables SAM's blacklist feature which blocks games with static screens disable_blacklist="No" #Disable NES bootrom. If you have a game set to start when you are starting the NES core, this game will show for a brief second before SAM loads a new one. #This setting makes sure no bootrom is loaded disablebootrom="Yes" # In case you turn off your MiSTer while SAM is running, we need to unmute on bootup unmute_on_boot="Yes" # List Building Control # Rescan gamelists for new games once per core check_for_new_games="No" # Check for new zip files on disk when building lists; may cause extra disk access checkzipsondisk="No" # Force a one-time scan for new zips on next run force_zip_scan="No" # Compare gamelists for changes while SAM runs update_gamelists_during_play="No" # BUTTON DETECTION # When you push a button or move the mouse, interrupt SAM # SAM tries to listen for controller buttons, mouse movement, mouse buttons, and keyboard input # SAM attempts to detect newly added controllers and mice for monitoring # Note: Not all devices will be recognized - notably BlisSTer controllers in LLAPI mode, some BT controllers and SNAC devices listenmouse="Yes" listenkeyboard="Yes" listenjoy="Yes" # TTY2OLED ADVCANCED SETTINGS # All needed values are read from the tty2oled INI files ttysystemini="/media/fat/tty2oled/tty2oled-system.ini" ttyuserini="/media/fat/tty2oled/tty2oled-user.ini" # How long to show the core logo for in seconds ttycoresleep="10" # How many seconds until core logo is shown again (default is "gametimer / 3") ttycoreshow="" # How often to show the core logo ttydisplayswitch="2" # Display scrolling text with bigger font, omit system info ttybig="no" # A lot of games have info in brackets. This will remove brackets from tty2oled output ttyname_cleanup="no" # How fast the scrolling speed should be. Options are slower, normal or faster ttyscroll_speed="normal" # DEPRECATED kids_safe="no" # DEBUG samdebug="Yes" # Write debug message to file at /tmp/samdebug.log samdebuglog="Yes" # GitHub branch to download updates from # Valid choices are: "main" or "test" branch="test"