by EricGoldstein
Tadpole is a device management tool for the SF2000 / Datafrog. It currently provides the following main features:
- Rebuilding of the console specific rom lists
- Changing the firmware to official releases or multicore (including rebuilding multicore gamelists)
- Merging ROM zips and jpg files with the same name to the relevant Zxx fileformat for each console
- Downloading cover art for ROMs
- Changing the four in menu game shortcuts for each console
- Changing the boot logo
- Changing the background music
- Changing the Console logos
- Applying the bootloader fix
- Applying the battery fix
- Automating the GBA bios fix
Tadpole started as a project to provide an easy to use GUI for tzlion's frogtool. However it has since added additional features.
Tadpole allows you to rebuild the preset game lists on the SF2000 / Datafrog emulator handheld, so you can add (or remove) ROMs in the proper system categories instead of only being able to add them in the user folder.
This program is not developed or authorised by any company or individual connected with the SF2000 handheld and is based on public reverse engineering of SF2000 file formats.
You should make your own backups of the Resources and bios folders and ideally your whole SD card so you can restore the original state of your device if anything goes wrong.
Download the latest release from https://github.com/EricGoldsteinNz/tadpole/releases
Download the latest .exe file if you are on windows, or the python source folder if you are on Linux/Mac.
You should be able to run the source using: python tadpole.py Note that you may need to install the required libraries if you do not have them already using: python -m pip install -r requirements.txt
- Insert the SF2000 SD card in a card reader connected to your computer
- Drag and drop your desired ROMs into the respective system folders (ARCADE, FC, GB, GBA, GBC, MD, SFC)
- Run tadpole (double-click tadpole.exe or run the python from source)
- All the standard games lists will be rebuilt as soon as tadpole opens.
- Other changes such as updating the OS, changing the boot logo, background music, or theme can be made from the menu.
- Start with Tadpole open and the SD card connected to the computer.
- Open the OS menu, and select "Build Fresh SD Card".
- Follow the instructions on screen to build a new SD
The SF2000 OS will load the following file extensions:
| Type | Extensions |
|---|---|
| Zipped | bkp, zip |
| Thumbnailed | zfc, zsf, zmd, zgb, zfb (see "Thumbnails & .zxx files" section) |
| SFC/SNES | smc, fig, sfc, gd3, gd7, dx2, bsx, swc |
| FC/NES | nes, nfc, fds, unf |
| GB/GBC | gbc, gb, sgb |
| GBA | gba, agb, gbz |
| MD/GEN/SMS | bin, md, smd, gen, sms |
It doesn't generally care if you put the wrong system's roms in the wrong folder, it will load them in the correct emulator according to their file extension.
Master System games are "secretly" supported by the Mega Drive emulator, it recognises the .sms extension but will actually run these games with any of the Mega Drive file extensions too. Game Gear games don't work properly.
Both .bkp and .zip extensions seem to function as normal ZIP files, I think .bkp was used for obfuscated zip files on
another system. Any supported ROM inside a ZIP file will be treated the same as an uncompressed ROM, and loaded in the
appropriate emulator.
(Arcade game ZIP files are weird, see the "Arcade games" section below.)
In the launch firmware version, filenames may contain Chinese and Japanese characters and these will be correctly displayed in the list even when English is selected. In the 2023-04-20 update, supported characters depend on the selected language, as it uses different fonts per language.
Arcade ROMs work differently from any others, since they consist of multiple ROM dumps inside a ZIP file, and emulators typically recognise them by their filename and the contained files' checksums. This means they usually can't be renamed.
For the SF2000 OS's purposes, in order to display the full names of the games in the menu instead of the shortened
emulator-standard filenames (eg. "Metal Slug X -Super Vehicle-001" instead of mslugx) their approach is to use .zfb
files named with the full name, these files contain a thumbnail image plus the actual filename, which refers in turn to
the actual rom zip file which is found in the ARCADE/bin subfolder.
(See the "Thumbnails & .zxx files" section for more info on this format)
The OS will still recognise arcade ROM ZIP files placed directly in the ROM folders with their emulator-standard filenames, but I don't know which ROM set it expects; even the manufacturers don't seem to know, they preloaded three Sonic Wings ROMs in the user "ROMS" folder and only one of them loads! Internal strings suggest the emulator is some version of Final Burn Alpha if that helps.
Many preloaded arcade games also have ".skp" files in the ARCADE/skp folder, these appear to be savestates which are automatically loaded when booting a game, to skip its boot sequence and bring you straight to the title screen with a coin already inserted. However it seems these only function correctly when the ROM is loaded using a .zfb file; if you place an arcade ROM ZIP directly in the ARCADE folder and index it using this tool, and there is a corresponding .skp file in the skp folder, the game will crash after loading the ROM. Personally I prefer to delete these files anyway as I'd rather see the original attract mode instead of jumping straight to the title screen.
The following file formats: zfc, zsf, zmd, zgb, zfb are a custom format created for this and similar devices, containing both a thumbnail image used in the menu and a either a zipped ROM or a pointer to one. Collectively I will refer to them as .zxx files for now.
They correspond to the following systems:
- .zfc = FC
- .zsf = SFC
- .zmd = MD
- .zgb = GB, GBC, GBA
- .zfb = ARCADE
Tadpole supports generating these files, so you can use your own custom thumbnails! (Except arcade games for now.)
Just drop a zipped rom and an image (png, jpg, gif) with the same filename in the same folder, run frogtool and it will automatically combine the two into an appropriate .zxx file. (The source image and zip file will be deleted.)
Example: "Bubsy.zip" and "Bubsy.jpg" would be combined to "Bubsy.zsf" if placed in the "SFC" folder.
Thumbnails in this system are 144 x 208 pixels, your image will be resized to those dimensions if necessary.
Frogtool was developed by taizou and Evan Clements
RGB565 conversion code based on PNG-to-RGB565 (c) 2019 jpfwong https://github.com/jimmywong2003/PNG-to-RGB565
Frog icon from public domain photo by LiquidGhoul https://commons.wikimedia.org/wiki/File:Australia_green_tree_frog_(Litoria_caerulea)_crop.jpg
_crop.jpg){kind=link}
Special thanks to the firmware devs