Skip to content

Helper to automate the process of running a seed

Notifications You must be signed in to change notification settings

coxla1/AlttprHelper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is this?

It's a soft that automates the whole process of renaming your seed accordingly to the MSU you want to use, and start every side tools you'll need (trackers, USB interface for auto-tracking, ...) You can use URLs for trackers too (for instance, https://alttprtracker.dunka.net/)

It is compatible with emulator and SD2SNES/FXPak using SNI

Many thanks to Synack for providing the pyz3r library!

Ok cool, where do I get this?

You can find the latest version on the Releases page.

Windows

Just download the compiled version and run the Helper.exe executable.

macOS, Linux

I haven't tested it personally, but I'm confident that the soft is cross-platform if you build it from source.

  • Download the source code
  • Install Python (should work on 3.8+)
  • Install requirements with pip: pip (or pip3) install -r requirements.txt
  • Run the helper with: python (or python3) gui.py

How to configure it?

  • Choose the mode you want to use (USB transfer or copy file).
    • If using USB transfer, write the path to your MSU folder in the corresponding entry next to Detect FXPak button (not case sensitive, e.g. /alttp/msu)
    • If copying the file, select the MSU folder (this will be the output path if no MSU is used). Optionally, you can also specify an emulator path and RetroArch core path.
  • The remaining options are not necessary, set them accordingly (you can use URL for trackers too, e.g. https://alttprtracker.dunka.net/)

/!\ Boot ROM is currently not working with USB transfer (it does work, but then SNI disconnects and it's a mess if you want to use autotracking) If using an FXPak/SD2SNES, please use at least SNI v0.0.81-pre (the -pre is important !)

How to use it?

  1. Download your seed as an .sfc file (works from everywhere: main site, kara fork, door branch, ...), and add it in the seed path entry.
  2. If using USB transfer, hit the Detect FXPak button (be sure to have specified SNI path beforehand, you'll have a message at the bottom saying Found FXPak on xxxxx if it worked)
  3. Refresh the MSU list with the Refresh button at the bottom of the window, then choose an MSU from the dropdown list.
  4. Doublecheck your options, then hit RUN.
  5. If everything went smoothly and if using a seed from the main site, the hash will be copied to the clipboard.

Bug reports

Feel free to contact me on Discord (Coxla#2119) if you find any bug.