arc_unpacker
is a command line tool for extracting images, sounds, music and
miscellaneous resources from visual novels (and some other Japanese games).
- List of supported games
- Nightly builds for Windows
- Latest stable release
- Build instructions for Windows and GNU/Linux
Drag'n'drop the archive or file onto arc_unpacker
. It will guess the format
and unpack it for you.
Caveats:
-
The file format might be detected by two or more decoders at once. In such cases you need to tell the program which one to use by supplying
--dec=...
option. -
The file might need more parameters to be correctly unpacked (all of which can be discovered with
--help --dec=DECODER
switch). In such cases you need to supply them manually. For example, XP3 archives need--plugin
that tells what kind of decryption to use. To tell it to use Fate/Stay Night decryption, supply--dec=krkr/xp3 --plugin=fsn
.
-
What do I do with
.wavloop
files?
These files are audio loops. You can play them like normal.wav
, however, most of the players will ignore looping information that is contained in such files. If you're looking for players that do support looped.wav
s, I recommend eithervgmstream
,foo_input_wave_loop
orwavosaur
. The extension.wavloop
was chosen so that it stands out from normal.wav
s and for compatibility withfoo_input_wave_loop
. -
I drag the game files onto
arc_unpacker
and it immediately closes.
Try running it from the command prompt to see the output and possible error message. Usually this behavior is a sign that the game requires additional switches which are described in the game list. If you are unfamiliar with the Windows command prompt, I recommend reading this little guide. -
I get
std::bad_alloc
, what gives?
One option is that an archive contains a very large file, which causesarc_unpacker
to run out of RAM while it tries to decode that file. To circumvent this (short of buying more memory), you can try runningarc_unpacker
with-t=1 --no-recurse
which should reduce its memory footprint. Since there only were a few such archives spotted, no special mechanism was developed to work around this issue, although this might change in the future. Other options include corrupt game files or a specific kind of bug inarc_unpacker
's decoders, but both are unlikely. If you are unable to unpack the files, do not hesitate to report the issue to the issue tracker. -
How can I help with development?
Thanks for asking this! There are a number of ways you can help:- By documenting games that are already supported but are not present on the games list.
- By porting existing decoders from other projects. Example projects can be found in THANKS.md.
- By reverse engineering games that are not yet supported, and coding new decoders for them.
For details, check out
CONTRIBUTING.md
and hit the IRC channel. -
What's the license?
All the code is licensed underLICENSE.md
unless otherwise noted. For acknowledgments, seeTHANKS.md
.
- Bug reporting: GitHub issue tracker
- Game requests: GitHub issue tracker
- IRC channel:
#arc_unpacker
onirc.rizon.net