{"id":27429728,"url":"https://github.com/gerbilsoft/mcrecover","last_synced_at":"2025-04-14T14:29:13.683Z","repository":{"id":46886056,"uuid":"62972334","full_name":"GerbilSoft/mcrecover","owner":"GerbilSoft","description":"GameCube Memory Card Recovery program.","archived":false,"fork":false,"pushed_at":"2025-03-16T21:59:20.000Z","size":6632,"stargazers_count":37,"open_issues_count":3,"forks_count":10,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-16T22:31:57.889Z","etag":null,"topics":["gamecube","memory-card","nintendo","recovery","save-files"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GerbilSoft.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-09T22:55:46.000Z","updated_at":"2025-03-16T21:59:25.000Z","dependencies_parsed_at":"2025-03-16T22:38:18.829Z","dependency_job_id":null,"html_url":"https://github.com/GerbilSoft/mcrecover","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GerbilSoft%2Fmcrecover","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GerbilSoft%2Fmcrecover/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GerbilSoft%2Fmcrecover/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GerbilSoft%2Fmcrecover/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GerbilSoft","download_url":"https://codeload.github.com/GerbilSoft/mcrecover/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248896623,"owners_count":21179466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gamecube","memory-card","nintendo","recovery","save-files"],"created_at":"2025-04-14T14:29:12.936Z","updated_at":"2025-04-14T14:29:13.667Z","avatar_url":"https://github.com/GerbilSoft.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GCN MemCard Recover\n\nVersion 0.2.1+\n\nCopyright (c) 2012-2018 by David Korth.\nEmail: gerbilsoft@gerbilsoft.com\n\nThis program is licensed under the GNU General Public License v2.\nSee [doc/gpl-2.0.txt](doc/gpl-2.0.txt) for more information.\n\n[![Travis Build Status](https://travis-ci.org/GerbilSoft/mcrecover.svg?branch=master)](https://travis-ci.org/GerbilSoft/mcrecover)\n[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/grxmj5520cbw9wwd/branch/master?svg=true)](https://ci.appveyor.com/project/GerbilSoft/mcrecover/branch/master)\n[![Coverity Scan Build Status](https://scan.coverity.com/projects/11187/badge.svg)](https://scan.coverity.com/projects/11187)\n\n## What is GCN MemCard Recover?\n\nGCN MemCard Recover is a program that can recover save files from\ncorrupted Nintendo GameCube memory cards. Usually, when GameCube\nsoftware indicates that a memory card is corrupted, only a few system\nareas are affected; the data area, where the actual save files are\nstored, is left intact. GCN MemCard Recover works by searching for\ngame descriptions in the data area of memory card dumps.\n\nIn addition, GCN MemCard Recover can recover save files if a memory\ncard is accidentally reformatted. Formatting a memory card only\nerases the directory and block tables; as long as no new save files\nare written, there's a high chance that the deleted files can be\nrecovered successfully.\n\n## How to compile GCN MemCard Recover\n\nGCN MemCard Recover requires the following packages:\n* CMake 2.8.12 or later.\n* Qt 5.5.0 or later. (5.7.0+ recommended)\n* libpng (1.6 or later with APNG patch recommended)\n* zlib (1.2.5 or later recommended)\n\nIf you do not have libpcre, libpng, or zlib, GCN MemCard Recover\nincludes copies of each of these libraries. They will be used\nautomatically.\n\nOn Debian and Ubuntu Linux systems, the following packages contain\nthe development headers required for compiling the program:\n* build-essential\n* cmake\n* libpcre3-dev\n* libpng12-dev\n* zlib1g-dev\n* qtbase5-dev\n* qttools5-dev\n\nNOTE: Most Linux distributions do not have the APNG patch in their packages\nfor libpng. If you want APNG support, you should configure GCN MemCard\nRecover to use its built-in libpng by specifying `-DUSE_INTERNAL_PNG=ON`\non the `cmake` command line.\n\nGCN MemCard Recover is known to compile with gcc5, MSVC 2010, and later\nversions. Older versions may have issues.\n\nTo compile GCN MemCard Recover on Linux, run the following commands\nin a terminal window:\n$ tar xpfv mcrecover-0.2.1.tar.gz\n$ cd mcrecover-0.2.1/\n$ mkdir build/\n$ cd build/\n$ cmake ../\n$ make\n$ sudo make install\n\nTo compile GCN MemCard Recover on Windows, you will need to install\nthe following: (minimum versions)\n* CMake 2.8.12\n* Microsoft Visual C++ 2010, or MinGW-w64\n\n## How to use GCN MemCard Recover\n\nIn order to recover files from a GCN memory card, you will first\nneed to dump the memory card image to a computer-readable format\nusing a Nintendo Wii. Two programs are available for this purpose:\n\n* GCMM: GameCube Memory Card Manager - http://wiibrew.org/wiki/GCMM\n* ctr-gcs-DacoTaco-Edition - http://wiibrew.org/wiki/Ctr-Gcs-DacoTaco-Edition\n\nInstalling and using these programs requires installing homebrew\nsoftware on the Wii console. A tutorial for setting up homebrew\nis available at http://wiibrew.org/wiki/Homebrew_setup .\n\nGCMM is more up-to-date and has more functionality, so GCMM is recommended.\n\nYou will need an SD card or USB mass storage device in order to\ndump the memory card.\n\nTo dump a GameCube memory card to an SD card in GCMM:\n1. Start GCMM from The Homebrew Channel.\n2. Press A if you're using an SD card or B if you're using a\n   USB mass storage device.\n3. Select \"Raw Backup\". (L+Y on GCN controller, B+'-' on Wii Remote.)\n4. Press A to dump the memory card in Slot A or B for Slot B.\n   The memory card image will be dumped to the MCBACKUP directory\n   on the SD card or USB mass storage device.\n5. Press Start (GCN) or Home (Wii Remote) to exit.\n\nOnce the memory card image is dumped, you can open the image file\nin GCN MemCard Recover:\n1. Start GCN MemCard Recover.\n2. Drag the memory card image file (e.g. 1019b_2013_07Jul_17_23-57-22.raw)\n   onto the GCN MemCard Recover window.\n\nGCN MemCard Recover will open the image file. If there were any save\nfiles that were normally visible on the GameCube (e.g. the card was\nreformatted and reused), they will appear in the list.\n\nTo search for files deleted and/or lost due to reformatting or file\nsystem corruption, click the \"Scan\" button on the toolbar. GCN MemCard\nRecover will scan each block of the memory card image to see if it can\nfind matches for known files. Once it's finished scanning, any files\nit found will appear in the list highlighted in yellow.\n\nHighlight the file(s) you want to extract, then click the \"Save\" button.\nThe file(s) will be saved in GCI format, which you can then restore onto\nthe memory card using GCMM.\n\nIn some cases, a recently-deleted file may be accessible by viewing an\nalternate directory table. The GameCube Memory Card has two copies of\nthe Directory Table and Block Table. When saving a file, only one of\neach of these tables is actually updated. This also counts for deleting\nfiles. To change the active Directory Table and Block Table, click the\nA or B buttons for Directory and Block Tables in the Memory Card pane.\n\nIn addition to extracting the save files, you can also extract the\nbanners and icons. To do this, click the Options menu, then check off\n\"Extract Banners\" and/or \"Extract Icons\". The banners and icons will\nbe saved with the same name as the files, but with a different extension.\n\nBanners and non-animated icons will always be saved in PNG format.\n\nAnimated icons can be extracted in one of five formats:\n* APNG\n* GIF\n* PNG (file per frame): Each frame is saved in its own file.\n* PNG (vertical strip): Each frame is stored one above another.\n* PNG (horizontal strip): Each frame is stored next to each other.\n\nNote that GIF support on Linux requires a copy of giflib v4.0 or later\nto be installed. giflib v5.1.4 is included with the Windows version.\n\n5. File Search Limitations\n\nGCN MemCard Recover works by searching through the file data instead\nof using the file system's directory tables. Unfortunately, this means\nthat file recovery has a few limitations:\n\n1. If files are heavily fragmented, GCN MemCard Recover may not be able\n   to successfully recover them. If this happens, the file will appear\n   to be extracted successfully, but attempting to load the save file\n   in the game will result in either a \"file corrupted\" error or a crash.\n\n   GCN MemCard Recover does support verifying the checksums of some files,\n   which is indicated by the icon in the rightmost column:\n   * Checkmark: Checksum is known and is valid. File can be recovered.\n   * X: Checksum is known and is invalid. File cannot be recovered\n        using the current version of GCN MemCard Recover.\n   * ?: Checksum is unknown. If you know the correct checksum algorithm\n        for this file, please email me so I can add support for the\n        algorithm in the next version.\n\n   Note that checksums are currently only checked for \"lost\" files (that is,\n   files found using the scanning algorithm). Files that are visible on\n   the card normally are not checked, and hence won't show any icon in the\n   rightmost column.\n\n2. Some games don't store the game description in the first block of the\n   file. This includes \"Mario Kart: Double Dash!!\" and \"The Legend of Zelda:\n   Twilight Princess\". Due to limitations in the current scanning engine\n   code, these files cannot be recovered yet. Support for these files will\n   be added in a future version.\n\n3. Games that have multiple slots but don't have a slot identifier in the\n   comment section will all be restored with the same filename. This includes\n   \"Animal Crossing\", so if e.g. multiple \"Animal Crossing\" save files are\n   restored from the memory card, they will all have the same name, so you\n   can't restore them to the same card. This will be fixed in a future version.\n\n4. The included databases are far from complete. If you have save files for\n   any games not currently supported by GCN MemCard Recover, please send me\n   copies of the GCI files so I can add support for these games to the\n   databases.\n\n# UI Language Translations\n\nGCN MemCard Recover has a fully-localizable user interface.\nThe following translations are included with v0.2.1:\n\n* English (US): Base translation.\n* English (GB): British English translation. Provided by Overlord.\n* Español (CL): Spanish translation. Provided by Kevin López.\n* Русский (RU): Russian translation. Provided by Egor.\n* \"1337 5p34k\": Basic en_US to 1337 conversion.\n  * The following converter was used in \"basic leet\" mode:\n    http://www.robertecker.com/hp/research/leet-converter.php?lang=en\n\nIf you are a fluent speaker of English and another language and\nwould like to contribute a translation, please let me know.\n\n# Additional Tools\n\nGCN MemCard Recover includes a command-line utility called \"gcbanner\".\nThis utility lets you extract GameCube disc banner images from opening.bnr\nfiles (both BNR1 and BNR2 format), as well as Wii save banner and icon\nimages from Wii save files (both Dolphin banner.bin and encrypted Wii\nsave formats).\n\nFor more information, see gcbanner's built-in help:\n$ gcbanner --help\n\n# External Resources\n\nA basic tutorial for setting up MinGW-w64 on Windows is available at:\nhttp://kemovitra.blogspot.com/2012/11/installing-mingw-w64-on-windows.html\n\nYet Another GameCube Documentation has useful documentation on the\nstructure of GameCube memory card images:\nhttp://hitmen.c02.at/files/yagcd/yagcd/chap12.html\n\nFinally, support for GCN MemCard Recover is available at:\n* Sonic Retro: http://forums.sonicretro.org/index.php?showtopic=32621\n* GBAtemp: http://gbatemp.net/threads/gcn-memcard-recover.349406/\n* Email: gerbilsoft@gerbilsoft.com\n* IRC: [irc://irc.badnik.zone/GensGS](irc://irc.badnik.zone/GensGS)\n\n# Trademarks\n\nNintendo, GameCube, Wii, Mario Kart, Mario Kart: Double Dash!!,\nThe Legend of Zelda, The Legend of Zelda: Twilight Princess,\nand Animal Crossing are either trademarks or registered trademarks\nof Nintendo Co., Ltd.\n\nMicrosoft, Windows is a registered trademarks of Microsoft Corporation.\n\nQt is a registered trademark of The Qt Company.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerbilsoft%2Fmcrecover","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgerbilsoft%2Fmcrecover","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerbilsoft%2Fmcrecover/lists"}