[RELEASE] 3DSeSTUFF (another FunKeyCIA wrapper)

Discussion in '3DS - ROM Hacking, Translations and Utilities' started by Rudi Rastelli, May 13, 2016.

  1. Rudi Rastelli
    OP

    Rudi Rastelli Advanced Member

    Newcomer
    73
    75
    Sep 15, 2007
    Gambia, The
    Hi !

    Here're my little GUI/wrapper for @cearp's amazing 'FunKeyCIA' script.
    It's windows-only, but may be it works through 'wine' on the other platforms as well
    EDIT1: Seems 2 work fine on 2 different linux using wine... big thx 2 @pikatsu
    EDIT2: Looks like it works as well in OSX using wine

    This is from the included 'ReadMe_NOT' :rolleyes:
    Code:
    *****************************************************************
    *  3DSeSTUFF V1.4.3  *
    * by Rudi Rastelli  *
    *****************************************************************
    * CREDITS:  *
    * @cearp 4 'FunKeyCIA'  *
    * @Steveice10 4 'socketfile'-source  *
    * @Housey 4 'Ticket Parser'-source  *
    * @Madridi,@Cha0sEm3rald,@Rohul1997,@Jimmsu 4 'community.xml'  *
    * @masa & @pikatsu for testing  *
    *****************************************************************
    
    DIDN'T IT SAY 'ReadMe_NOT' ???
    ... but anyway... your here now... SO READ WHAT U SHOULDN'T READ !
    
    Features:
    *********
    - Creates 'good' CIAs/Tickets
    - Already created CIAs/Tickets will be marked with colors in title list (see 'TIPS')
    - New titles will be marked (see 'TIPS')
    - Titles needing a 'Seed' or Cryptofix will be marked (see 'TIPS')
    - Auto converts a 'seeddb.bin' to single seed files('<TitleID>.dat') (see 'TIPS')
    - Titles with a not yet validated 'Decrypted Title Key' will be marked (see 'TIPS')
    - Import 'decTitleKey.bin'-file into local database
    - Import 'seeddb.bin' -file into local database
    - Keys will be otionally checked for validity
    - Creates a 'decTitleKey.bin'-file for titles with missing 'Encrypted Key' (see 'TIPS')
    - Metadata adjustments via 'community.xml, '3dsdb.com' and 'Another Metadata Site'
    - Textsearch and filter for region and type
    - Sort by clicking at column header
    - Batch-Mode
    - Shutdown PC after downloading CIAs (optional)
    - Configurable renaming-function
    - Batch renaming function (in 'Extras'-menu)
    - Configurable savepaths for the created CIAs/Tickets
    - Network-Install of CIAs/Tickets via FBI 2.x
    - Creates a log-file while creating CIAs/Tickets
    - Useful functions via context-menu (Edit, Copy, Delete, Restore)
    - Tooltips
    - Unicode support, to be able to also display japanese titles correctly
    - Riddel protected hidden feature (See 'TIPS')
    
    
    STARTING UP:
    ************
    Upon first start the title list appears empty. Now you have 2 ways to continue:
    A) 'Extras'-Menu -> Import Titles From '[dec|enc]TitleKeys.bin' -> Select a 'decTitleKey*.bin' (eg 'decTitleKeys_Rudi.bin')
      (If there is an 'encTitleKeys*.bin' in same folder and with same name(eg 'encTitleKeys_Rudi.bin'), it will be imported as well)
    B) 'Extra'-Menu -> Click what shouldn't be clicked ^^
    
    TIPS:
    *****
    1. COLORED MARKINGS
      Already created CIAs and Tickets in selected save folder will be marked in title list with the following colors:
      - Yellow : CIA already created
      - Purple : Ticket already created
      - Green  : CIA and Ticket already created
     
    2. '*'-MARKS
      '*' in 'Name'-Column  : New added title (temporary)
      '*' in 'Title ID'-Column : 'Decrypted Title Key' isn't validated yet
      '*' in 'Serial'-Column  : Title needs a 'seed' or needs to be cryptofixed
     
    3. MISSING "ENCRYPTED KEYS"
      Sometimes there are titles missing their 'encrypted key', which is needed in order to create CIAs/Tickets.
      In that case 3DSeSTUFF creates a 'decTitleKey.bin'-file, which can be used by 'Decrypt9' to create a 'encTitleKey.bin'-file.
      That 'encTitleKey.bin'-file has all the missing 'Encrypted Keys'.
      A little 'How To' will be shown by 3DSeSTUFF in a small message box and it works in conjunction with the next tip.
     
    4. AUTO IMPORT OF 'ENCRYPTED TITLE KEYS'
      All 'encTitleKeys*.bin' in main directory of 3DSeSTUFF will be automatically imported upon program start.
      This is to add missing 'Encrypted Title Keys' to the database.
    
    5. SEEDS
      Some newer games need a so called 'Seed' to function properly.
      If u enter eShop the needed 'Seed' will be downloaded... OR...
      Copy 'fbi'-folder and it's content from programs main directory to SD and use the 'import title seeds' feature of FBI 2.2.2+
      Alternatively u can cryptofix such a game. To explain how this could be done simply exceeds the bounds of this readme.
      If the 'rename'-funktion is active a '[seed]'-tag will be added to the file name of the CIA/Ticket.
     
    6. NETWORK-INSTALL VIA FBI 2.X
      For this the IP-Address of the 3DS is need, which will be shown when FBI's 'Network Install' is selected.
      I recommend giving the 3DS a static IP in order to avoid repeated input of the IP.
      In general this kind of install only makes sense for small CIAs or Tickets, because speed isn't very good.
     
    7. DOUBLE CLICKS
      Double-Left-Click on a title creates it's CIA
      Double-Right-Click on a title creates it's Ticket
     
    8. BATCH MODE
      In order to multi-select titles hold 'SHIFT'- or 'STRG'-Button on keyboard while selecting titles.
      Then press 'Create CIA(s)' or 'Create Ticket(s)'
     
    9. DELETING AND RESTORING TITLES
      Deleted titles will only be marked as deleted in the local database. This makes it easy to restore them.
      Restored titles will be displayed with a '*' in 'Title ID' column, which will disapear only after a restart of 3DSeSTUFF
      and a re-check of their keys.
     
    10. RIDDLE PROTECTED EXTRA FEATURE
      Sry... but i have absolutly no ideas about riddels ^^
      But... if you're able to solve it u need to restart 3DSeSTUFF in order to take effect of the new option.
     
    11.TOOLTIPS
      Hover your mouse pointer over a button, checkbox etc to get a tooltip
    TROUBLESHOOTING:
    ****************
    1. FBI DOESN'T RESPOND, WHEN I PRESS THE 'CANCEL'-BUTTON WHILE INSTALL IS RUNNING
      Throughout my test i came across that FBI sometimes needs about 1-2 minutes(!) to recognize that 3DSeSTUFF has aborted connection.
      And sometimes it doesn't recognize it at all. Already wrote a pm to FBI's dev, but got no reponse so far.
      WORKAROUND: Don't cancel a running network install via 3DSeSTUFF. Instead cancel it via FBI by pressing the 'B'-button.
     
    
    Regards
    Rudi
    
    
    [​IMG]

    Pretty sure there are some bugs/glitches left... just check it out and tell me.
    Also any ideas for improvement are more then welcome.

    If u get any warnings from ur anti-virus i can't do anything on that. Had that as well sometimes in the past, but currently 4 me it's gone. Have no idea why this happens sometimes. As far as i can say 3DSeSTUFF is virus free.

    DOWNLOAD:
    3DSeSTUFF V1.4.3

    Regards
    Rudi
     
    Last edited by Rudi Rastelli, Jun 8, 2017
    lomejor18, rocknard, demon77 and 9 others like this.
  2. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    This is the complete eshop downloader.
     
    proflayton123 likes this.
  3. proflayton123

    proflayton123 Undeclared Shitposter 2.1

    Member
    5,873
    2,216
    Jan 11, 2016
    Japan
    日本
    If only ninty was on to us:ph34r:

    Thanks for this app along with the OG devs~
     
  4. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    Just tested on Zorin OS through wine. It works perfectly
     
    Rudi Rastelli likes this.
  5. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    Ubuntu working too. So perhaps all other linux versions
     
  6. Glyptofane

    Glyptofane GBAtemp Advanced Fan

    Member
    561
    283
    Feb 12, 2009
    United States
    This is similar to DTK, but even nicer. Thanks!
     
  7. b921603

    b921603 Member

    Newcomer
    20
    4
    Mar 10, 2016
    Taiwan
    Does it support FBI 2.0?
     
    pikatsu likes this.
  8. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    I do not know but someone can try and tell us
     
    b921603 likes this.
  9. DjoeN

    DjoeN Captain Haddock!

    Member
    5,190
    1,496
    Oct 21, 2005
    Belgium
    Somewhere in this potatoland!
    Works nice, thanks, very easy to use!
     
  10. b921603

    b921603 Member

    Newcomer
    20
    4
    Mar 10, 2016
    Taiwan
    I just find the answer.It supports FBI 2.xx .It was mentioned in the reader.
     
  11. Glyptofane

    Glyptofane GBAtemp Advanced Fan

    Member
    561
    283
    Feb 12, 2009
    United States
     
  12. fatherjack

    fatherjack GBAtemp Fan

    Member
    365
    37
    Jul 3, 2007
    Still Here
    WTF............password needed - that's a bit shit :(
     
  13. DjoeN

    DjoeN Captain Haddock!

    Member
    5,190
    1,496
    Oct 21, 2005
    Belgium
    Somewhere in this potatoland!
    @Rudi Rastelli
    - Tested Donkey Kong Country Returns 3D
    - Create CIA
    - Rename Output To checked -> Name [TitleID][Type][Region]

    It doesn't rename it: output in CIAs folder: 00040000000CCF00.cia
     
  14. Rudi Rastelli
    OP

    Rudi Rastelli Advanced Member

    Newcomer
    73
    75
    Sep 15, 2007
    Gambia, The
    Hmmm .... I've tried it right away with a smaller title and same rename-settings as yours and cia is renamed as expected.
    Did u check the checkbox at 'Rename Output To' ?
     
    Last edited by Rudi Rastelli, May 14, 2016
  15. DjoeN

    DjoeN Captain Haddock!

    Member
    5,190
    1,496
    Oct 21, 2005
    Belgium
    Somewhere in this potatoland!
    Yupz i did.

    Trying again.
    But WHY does the program deletes my dectitlekeys.bin file everytime?
    Everytime i have to place it back and reimport it and everytime it get wiped again.
     
  16. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    Have you checked the box near rename output? Then select the naming options and create cia
     
  17. OnenZ

    OnenZ Advanced Member

    Newcomer
    78
    4
    Sep 4, 2015
    Chile
    Valparaíso
    I believe the program deletes the encTitlekeys, bcs i create it mbe two times, and the third one say me the same thing for make the missing encTitleKey.bin
     
    Last edited by OnenZ, May 14, 2016
  18. Rudi Rastelli
    OP

    Rudi Rastelli Advanced Member

    Newcomer
    73
    75
    Sep 15, 2007
    Gambia, The
    Yep... thats something i should mention in readme.
    Idea behind is:
    Any 'dectitleKey.bin' in programs main directory is a 'decTitleKeys.bin' created by 3DSeSTUFF and it signs the user "hey there are some tiltes with missing encrypted title keys!". Then user should take over that created 'decTitleKeys.bin' to decrypt9 in order to get the missing keys via decrypt9's encrypt function.
    To avoid that ur own 'dectitleKeys.bin' is deleted just place it in a folder like 'MyKeys' or something like that.
    But... what gives me wonder is that u always have import the keys... normaly they should be stored in '3DSeSTUFF_Keys.db'... so no need to import them erverytime.
     
  19. pikatsu

    pikatsu GBAtemp Advanced Fan

    Member
    736
    127
    Apr 16, 2014
    Argentina
    A few games no more than 5 i think miss their encTitleKeys (is 3ds.titlekeys that didnt add the yet) so you have to use Decrypt 9 to convert the decTitleKeys.bin - that created from the tool- to encTitleKeys.bin and add it to the tools folder then open the tool again
     
  20. OnenZ

    OnenZ Advanced Member

    Newcomer
    78
    4
    Sep 4, 2015
    Chile
    Valparaíso
    But the box "Missing titlekey" say put the enctitlekeys.bin on the root of 3DSeSTUFF. Like i say i encrypted few times with this result (Get deleted from the folder)