Official ddd - WiiU Title Dumper

Discussion in 'Wii U - Homebrew' started by Cyan, Mar 11, 2016.

Mar 11, 2016

Official ddd - WiiU Title Dumper by Cyan at 8:02 PM (163,092 Views / 46 Likes) 745 replies

  1. Cyan
    OP

    Global Moderator Cyan GBATemp's lurking knight

    Joined:
    Oct 27, 2002
    Messages:
    16,992
    Location:
    Engine room, learning
    Country:
    France


    ddd - WiiU Title Dumper


    What is ddd ?

    ddd is a WiiU Title Dumper developed by Dimok.
    It dumps the data of any title launched on your WiiU.

    It can dump all the files from these folders or their sub-folders:
    /vol/code
    /vol/content
    /vol/save
    /vol/aoc
    /vol/meta
    It will automatically generate the cos.xml and app.xml needed by Loadiine when dumping /vol/code


    It requires a server on your computer which works on Windows, Linux and Mac.


    Download

    Download : https://github.com/dimok789/ddd/releases
    Source : https://github.com/dimok789/ddd


    Compatibility

    ddd works on all WiiU versions capable of running the Homebrew Launcher.


    Usage


    :!: Attention : Before dumping your game, be sure you disabled the WiiU's Auto Power-Down feature, or the console will shut down in the middle of the dump.
    It can takes few hours to dump a game through the network, as the network average speed is 800KB/s to 1MB/s.

    On PC
    You need to launch the server with a command line to specify the path you want to dump, and where you want the files to be dumped to.


    Open a command line window (or a terminal on Linux/mac):
    Mac : The terminal is located in the Utilities folder in Applications.
    Windows (method1) : Start menu > run > type cmd and press enter
    Windows (method2) : press Shift on the keyboard and right-click on an empty spot of the folder where the dumper is located, then select "open a command line window here".

    If the command window is not already in the correct folder, browse to the Title Dumper folder using the "cd <path>" command. Example:
    Once you are on the correct folder, launch the Title Dumper. The command to launch the Title Dumper is different if you are on Windows or Mac/Linux.

    Windows
    Use this command line format:
    Linux and mac
    Use this command line format:

    where <dump_path_on_wiiu> is "/vol" or any valid sub-folders (see examples below) and <output_path_on_pc> is an existing folder in which you want to store the dumped files on your computer.

    You can also use a batch or bash file with that command line inside instead of opening a command line window every time.


    On WiiU
    1. Run ddd from the homebrew launcher.
    2. Set your computer's IP and press X button to install ddd in memory and return to WiiU Main menu. (You can press A button instead to autoboot the inserted disc)
    3. Launch the title you want to dump. It will pause on the logo until the dump is done.
    4. After the dump is done, the title will continue loading normally. Keep the server active if you need to dump rpl files.
    5. Close the server and launch it again with a different output path if you launch another title, or you will dump multiple titles to the same path.
    6. Launch Miimaker to return to installer and press Home button to exit to the homebrew Launcher to remove the dumper from memory.


    Special method to dump the /vol/meta folder
    If you want to dump the /vol/meta folder then the method is different based on the launched title type.

    WiiU disc titles and titles installed on WiiU USB Hard drive:
    1. After you launched the title, press the Home button.
    2. Wait on the Home menu until all files are dumped.
    3. You can now close the Home menu and either return to the game or exit.

    Titles installed on the WiiU system memory (NAND):
    1. After you launched the title, press the Home button
    2. Exit to the system menu
    3. Wait 30 seconds on the system menu, until all files are dumped. The dump will start about 15 seconds after the system menu is loaded.


    Things to know:
    - RPL files are dumped only if they are loaded in memory. You need to play the game and trigger their load for the files to be dumped.
    - The dumper will semi-resume the dump if you cancel it. The existing files will be skipped, partial files will be dumped again.
    - If you specify only /vol as input path it will dump all possible path.
    - You can't specify a single file to dump as input path yet.
    - On windows you can use either slash / or anti-slash \ in the output path.
    - If the path contains a space, you need to use quotes around it "c:\path with space\output folder\"


    Examples


    Example 1
    Dumping the "code" folder of your Lego City Game disc to E:\WiiU\ISO\Lego City\
    It will dump :
    E:\WiiU\ISO\Lego City\vol\code\legocity.master.rpx
    E:\WiiU\ISO\Lego City\vol\code\app.xml
    E:\WiiU\ISO\Lego City\vol\code\cos.xml

    Example 2
    Dump the "driver" folder of Mario Kart 8:
    it will dump:
    E:\WiiU\ISO\Mario Kart 8\vol\content\driver\BbDaisy.szs
    E:\WiiU\ISO\Mario Kart 8\vol\content\driver\BbLuigi.szs
    E:\WiiU\ISO\Mario Kart 8\vol\content\driver\ and all the szs files located in that folder

    Example 3
    Dump EVERYTHING the dumper can dump:
    Specify only "/vol" as input path.
    It will dump :
    /vol/code, app.xml cos.xml
    /vol/content
    /vol/save
    /vol/aoc
    into your mario kart 8 folder

    Example 4
    You can also specify relative path to dump the title into the current dumper's folder.
    Windows:
    Linux:


    Limitation

    You can't dump System menu or Miimaker titles.
    If you need these titles, they can be downloaded from NUS.

    The /vol/code folder is not a direct dump, it only dumps memory-loaded RPX or RPL files. It also extracts the data used by Loadiine and generate "fake" app.xml and cos.xml files.
    The generated files are not full extracted files, only some values are read from memory and stored in the files for loadiine's needs.


    Help wanted

    An icon for the homebrew launcher would be nice.
    If someone wants to write a better readme and usage for github, contact us.

    If you know how to get a list of all rpl files used by a title, then the dumper could be updated to dump them without the need to play the game and load them in memory.

    Donation

    If you want to thank Dimok for all his work in the WiiU development, you can make a gift in return.
    [​IMG]
     
    Last edited by Cyan, Aug 18, 2016 - Reason: updated the guide a little
    Boreas3, Maximilious, tbb043 and 43 others like this.


  2. dimok

    Member dimok GBAtemp Advanced Fan

    Joined:
    Jan 11, 2009
    Messages:
    721
    Country:
    United States
    Hey everyone,

    this is a test version and the sources will follow soon. I want to see if most of the parts work correct as we want it to and commit everything after that.
     
  3. daxtsu

    Member daxtsu GBAtemp Guru

    Joined:
    Jun 9, 2007
    Messages:
    5,335
    Country:
    Antarctica
    Out of curiosity, is there some reason game RPLs can't just be dumped directly? Are they not stored in /vol/code? I don't know a whole lot of how Wii U games store their code and RPLs, so forgive me if that's a silly question.
     
  4. BullyWiiPlaza

    Member BullyWiiPlaza Nintendo Hacking <3

    Joined:
    Aug 2, 2014
    Messages:
    1,389
    Country:
    Germany
    Nice, finally we can dump full titles. I was waiting for such a release :D
     
  5. Phantom64

    Banned Phantom64 Banned

    Joined:
    Aug 18, 2015
    Messages:
    581
    Country:
    Korea, North
    Cool. I'm serious, this is cool lol
    But this is just another tool that 5.5.X users can't use...
     
  6. Cyan
    OP

    Global Moderator Cyan GBATemp's lurking knight

    Joined:
    Oct 27, 2002
    Messages:
    16,992
    Location:
    Engine room, learning
    Country:
    France
    It doesn't dump the meta folder
     
    BullyWiiPlaza likes this.
  7. BullyWiiPlaza

    Member BullyWiiPlaza Nintendo Hacking <3

    Joined:
    Aug 2, 2014
    Messages:
    1,389
    Country:
    Germany
    What's the matter? Will it be added later on?
     
  8. Maschell

    Member Maschell GBAtemp Advanced Fan

    Joined:
    Jun 14, 2008
    Messages:
    677
    Country:
    Germany
    You can't directly access the /vol/meta and /vol/code folder

    Edit:with a bit of magic the meta is possible!
     
    Last edited by Maschell, Mar 11, 2016
  9. vgmoose

    Member vgmoose GBAtemp Regular

    Joined:
    Jan 31, 2016
    Messages:
    189
    Country:
    United States
    Looking forward to seeing the icons people make for this! Lots of room for creativity.
     
    Last edited by vgmoose, Mar 11, 2016
  10. Kafluke

    Member Kafluke GBAtemp Addict

    Joined:
    May 6, 2006
    Messages:
    2,194
    Country:
    United States
    Sweetness! Can't wait to get home and test on my 5.4u spoofed to 5.5.1. Thanks @dimok and @Cyan once again!
     
  11. Chuardo

    Member Chuardo GBAtemp Regular

    Joined:
    Oct 4, 2015
    Messages:
    291
    Country:
    Uruguay
    You can also use this with eShop titles or just using Physical Games on disc?
     
  12. NWPlayer123

    Member NWPlayer123 GBAtemp Addict

    Joined:
    Feb 17, 2012
    Messages:
    2,570
    Location:
    The Everfree Forest
    Country:
    United States
    Yes, any game you can boot into (besides those 3 mentioned in the OP but those you can just download from NUS)
     
    CallieMarie and Chuardo like this.
  13. Phantisy

    Newcomer Phantisy Advanced Member

    Joined:
    Feb 12, 2016
    Messages:
    87
    Country:
    United States
    Thank you for this guys! This is a GREAT addition to the homebrew community. Can't wait to use it :-)
     
  14. TiMeBoMb4u2

    Member TiMeBoMb4u2 GBAtemp Maniac

    Joined:
    Oct 25, 2008
    Messages:
    1,211
    Country:
    United States
    @dimok ... My first shot at a "ddd" icon...

    HQ:
    ACTUAL:
     
    TeddyBearYoshi and Masterwin like this.
  15. Cava

    Member Cava GBAtemp Fan

    Joined:
    Jan 26, 2016
    Messages:
    495
    Country:
    Hungary
  16. JFSAINTS

    Newcomer JFSAINTS Member

    Joined:
    May 19, 2008
    Messages:
    33
    Country:
    Spain
    great work !!! works perfect at 5.4 !! :D
     
  17. piratesephiroth

    Member piratesephiroth I wish I could read

    Joined:
    Sep 5, 2013
    Messages:
    2,688
    Country:
    Brazil
    Not quite that yet. We can't dump the tickets.

    We're probabaly gonna have to wait for the IOSU exploit.
     
  18. Pestilence204

    Member Pestilence204 GBAtemp Fan

    Joined:
    Mar 15, 2014
    Messages:
    308
    Country:
    Canada
    Is the NUS title key obtainable with this? If I remember correctly, that wouldn't be in the vol folder, but figured I'd ask.

    EDIT: Nevermind, @piratesephiroth literally just answered this.
     
    Last edited by Pestilence204, Mar 11, 2016
  19. TotalInsanity4

    Member TotalInsanity4 GBAtemp Supreme Overlord

    Joined:
    Dec 1, 2014
    Messages:
    6,137
    Location:
    Under a rock
    Country:
    United States
    I'm guessing this doesn't dump DLC/make it compatible with Loadiine?
     
  20. DragonSky

    Member DragonSky GBAtemp Advanced Fan

    Joined:
    Oct 27, 2010
    Messages:
    715
    Country:
    Belgium
    Somehow I though it was mayby Dream Drop Distance on the WiiU :P.
     
    vgmoose likes this.

Share This Page