ROM Hack [RELEASE] 3DSeSTUFF (another FunKeyCIA wrapper)

[Rudi Rastelli]

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'

*****************************************************************
*  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

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

 

[pikatsu]

This is the complete eshop downloader.

 

[proflayton123]

This is the complete eshop downloader.

If only ninty was on to us

Thanks for this app along with the OG devs~

 

[pikatsu]

Just tested on Zorin OS through wine. It works perfectly

 

[pikatsu]

Just tested on Zorin OS through wine. It works perfectly

Ubuntu working too. So perhaps all other linux versions

 

[Glyptofane]

This is similar to DTK, but even nicer. Thanks!

 

[b921603]

Does it support FBI 2.0?

 

[pikatsu]

Does it support FBI 2.0?

I do not know but someone can try and tell us

 

[DjoeN]

Works nice, thanks, very easy to use!

 

[b921603]

I just find the answer.It supports FBI 2.xx .It was mentioned in the reader.

 

[Glyptofane]

Does it support FBI 2.0?

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.

 

[fatherjack]

WTF............password needed - that's a bit shit

 

[DjoeN]

@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

 

[Rudi Rastelli]

It doesn't rename it: output in CIAs folder: 00040000000CCF00.cia

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' ?

 

[DjoeN]

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.

 

[pikatsu]

@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

Have you checked the box near rename output? Then select the naming options and create cia

 

[OnenZ]

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

 

[Rudi Rastelli]

But WHY does the program deletes my dectitlekeys.bin file everytime?

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.

 

[pikatsu]

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

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

 

[OnenZ]

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

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)