Homebrew [Release] freeShop - open source eShop alternative

  • Thread starter Thread starter TheCruel
  • Start date Start date
  • Views Views 2,153,532
  • Replies Replies 6,701
  • Likes Likes 229
Status
Not open for further replies.
VljLxOM.png
chart

https://github.com/Cruel/freeShop/releases

This is homebrew software designed to imitate Nintendo's eShop. It allows you to browse and search games, and download ones you own (i.e. games for which you have the titlekey).

Usage:
1. Install the CIA file on your CFW of choice (preferably one removing region restrictions). Do NOT ask about CFW issues in this thread.
2. Put an encTitleKeys.bin file in the directory sdmc:/3ds/data/freeShop/keys/ or go to update settings in freeShop and add a URL to auto-download (recommended).
3. Launch freeShop and enjoy.

This is perhaps over-simplified. I'll be more thorough later. This is mostly for linux, building on Windows will be difficult.

1. Install devkitARM, including ctrulib and citro3d.

2. Build cpp3ds. This script shows how to build it on ubuntu. This includes downloading precompiled portlibs/tools. (if you use Arch it's on AUR)

3. Set CPP3DS env variable to the dir with cpp3ds build (containing lib/include dirs)

4. Build/install libarchive (to portlibs dir) and freeShop as detailed in this script.

FAQs

Q: Do I need a CFW for this?
A: Yes.

Q: Is there a 3dsx version?
A: No, and with the elevated permissions needed, it's not worth the trouble.

Q: Why are games missing? They're on the eShop.
A: It only shows games for which you have the title key (dumped to encTitleKeys.bin). And even then some games won't show because they're not cached server-side (this will eventually change).

Q: Why does freeShop show DLC as installed when I don't have it?
A: All DLC is lumped together with the same title id, so even partial installs will show it as installed. If you're missing DLC, just delete it and reinstall it. If eShop partially installed it, or you previously purchased some DLC through eShop on that console, you may lose the DLC freeShop installs when you revisit eShop. This is currently unavoidable.

Q: Can freeShop download while sleeping?
A: Not yet. It's currently unknown how to go into sleep mode without interrupting network services.

Q: Can I download games of any region?
A: Depends on your CFW. Most of them allow it, including the popular Luma3DS.

Q: Is this safe? Will I get banned/sued for using this?
A: Even modding your console's software/firmware runs legal risks. But like running freeShop, the risk is minimal. If you make sure to only install games you've purchased, then you remain in a safer legal grey area. And there is no way for Nintendo to know which client IP owns which games. That would requires some analytic guesswork, potentially resulting in many false-positive bans. Not likely to happen and none have been reported.

Q: Why don't I have any friends?
A: You should get out more.

Troubleshooting

I keep getting "Failed to install seed" errors.
You likely have a FW version < 9.6 and therefore cannot play newer games that utilize crypto seeds. You can fix this with a FW update.

I keep getting "Wrong title key" errors.
You're probably not using correct encrypted keys (encTitleKeys.bin). Decrypted keys will give this error.

I keep getting "Failed to finalize TMD install: 0xC86044D2".
The system is reporting that you don't have enough space on your SD card to install the game. If it's a DSiWare game, then it's your NAND that doesn't have the space.

I keep getting "Failed to finalize content install: 0xD8E08025".
There are many possible reasons for this. But one known diagnosis is a possible SD card problem. For example, a fake SD card who is reporting space available while it's actually full will often give this error. Double-check your SD card.

I get error code 0xD8A08004
This happens with the installation state gets screwed up. You have to reboot the console to get rid of it. If you consistently get this, report how so the bug can be fixed.


So yeah I have A9HL and luma cfw on 9.2 U but when I try to download some of the newer games it tells me I need to have 9.6 or higher so how do I fix this...
 
So yeah I have A9HL and luma cfw on 9.2 U but when I try to download some of the newer games it tells me I need to have 9.6 or higher so how do I fix this...
I don't know your precise setup, but if you have A9LH and Luma you can probably just update to 11.2.
 
Can't seem to find updates with this prog? I want to update my cia and 3ds files (thouhg i have no idea what region they are)
But can't with normal eshop or this tool..?
 
Can't seem to find updates with this prog? I want to update my cia and 3ds files (thouhg i have no idea what region they are)
But can't with normal eshop or this tool..?

You can only update cias. On the 2nd section of the bottom screen you can see your installed stuff. Those with an icon green/yellow have DLC/Updates to install. Just tap on the one you want and select the option to download them. :)
 
You can only update cias. On the 2nd section of the bottom screen you can see your installed stuff. Those with an icon green/yellow have DLC/Updates to install. Just tap on the one you want and select the option to download them. :)
I tried this. but some games that show notification of an update don't have an icon green/yellow.
And the ones that have an icon green yellow arent the ones that need an update.. even if i click the one that has yellow icon it seems i can delete existing update and dlc. (dont remember installing an update for this game though)
Then what is the best way to download a mass of updates for .3ds files?
 
I tried this. but some games that show notification of an update don't have an icon green/yellow.
And the ones that have an icon green yellow arent the ones that need an update.. even if i click the one that has yellow icon it seems i can delete existing update and dlc. (dont remember installing an update for this game though)
Then what is the best way to download a mass of updates for .3ds files?

That's really weird. Well, you can always look for the update on that ISO site.
 
But if u dont know if all ur roms are US or EU is there a way without checking them all individually on pc? i have a lot of them..

You have to check the titles one by one or using a program like FunkyCia to check your seeddb x(
 
  • Like
Reactions: Chrisssj2
It would be very nice to have a Japanese keyboard layout so we could search for Japanese games.. Kanji wouldn't really be possible, but kana would be easy. I was going to try making a layout since the XML layout file seems simple to edit, but it's a huge pain in the ass trying to build freeShop, at least on Windows. It was impossible to build CPP3DS for me as the cmake files were just broken and wouldn't work on Windows. I downloaded the latest release (deleting the symbolic links in the zip cuz they would give me an error when extracting..) then finally got cmake for freeShop to finish. Then G++ refused to find the source files so I just gave up. Maybe I'll get a Linux virtual machine going and try again sometime.

I don't know why a Japanese layout hasn't been done yet. 3DS's of all regions can display kanji and kana so I don't see why we can't input kana. Unless the compilers don't support it, which I don't know about. Anyone have any input on this?
 
It would be very nice to have a Japanese keyboard layout so we could search for Japanese games....Anyone have any input on this?

Don't know if it has been said before, couldn't you change the region to display japanese-only games? Then refine the search to list genre?
 
Don't know if it has been said before, couldn't you change the region to display japanese-only games? Then refine the search to list genre?
That's already possible through freeShop's settings.
Look around, you can filter through region, console (in case of VC too) and also genre.
 
Status
Not open for further replies.

Site & Scene News

Popular threads in this forum