mangariini
about
mangariini is a small utility for reading scanned comics, particularly manga. unlike other image viewers, it opens everything at once, and scrolls between pages easily. it isn't the most stable program on the planet, but in most cases it works perfectly fine.
mangariini is public domain software. the source code is provided, and you can do whatever you want with it, just don't expect it to come with verbose documentation.
if you do decide to do something with it, it would be nice if you would let us know, so we can then either add it here as a new release, or at the very least link to your new project.
the current version is 0.1.2, it was released on 22 NOV 2004.
features
mangariini doesn't have a huge featureset, it's mostly toggles. here's a rundown of what you get.
- multi-directional image ordering - your comic might read left to right. it might read right to left. it might not matter. mangariini provides buttons [and menu options] to choose what direction it loads images in. it defaults to right-to-left, but can easily be swapped to left-to-right, or top-down. this also effects scrolling behavior, if you're reading right-to-left, mouseWheelDown will scroll to the left.
- simple navigation - scroll around with the arrow keys or the mousewheel, switch pages with page up/page down, click and drag with the mouse, it's all very intuitive and lacks stupid features like "FOLLOW MOUSE".
- fullscreen mode - 'enter' or the fullscreen-mode-button will toggle fullscreen mode, which is hopefully self explanitory.
- potentially self-contained program - mangariini used to be a self-contained file by default. as of version 0.1.2 it now stores a tiny config file in your home dir. you can turn off this ability with the /n or --noconfig commandline options, so you can take mangariini around with you on a thumbdrive and not litter the machines you use with config files.
- auto levels - [EXPERIMENTAL] auto leveling is for adjusting the contrast of images which were poorly scanned. this feature may be questionably stable.
wishlist
mangariini isn't an incredibly featureful program, but it gets the job done. here are some things that we think would be nice for someone to add.
- .CBZ/.CBR/.ZIP/.RAR handling - many people distribute comics as solid compressed files, due to ease of transporting one .cbz instead of 300 .jpgs. this feature doesn't exist because you can just as easily decompress before reading. but it would be nice to have.
- contrib builds - osx and linux builds are very possible, but hard for us to build/test. if you've been able to build mangariini for something other than win32, contact us with the form below and we'll get it up.
- stability - as we've said before, mangariini isn't the most stable program out there. it seems to randomly crash in random situations on random platforms/hardware configs. if you can figure out how to fix it, that would be neat.
screenshots
not much to show here, but just for the sake of things, here are two screenshots.
download
at the moment we just have a windows build. linux and mac builds should be possible, but we haven't been able to make/test one. details on how to help with that below. the windows build is a 7zip self-extracting exe.
since this is public domain, here's the source. as stated previously, feel free to make your own build, modify the code, etc, all we ask is that you let us know if/when you do something. we'd also like some contrib builds of this code on other platforms, if possible. here's what the readme has to say about building:
"You need wxWindows to build it. The makefile has some sort of support for building with mingw under Windows, and also for Linux and friends. The makefile will probably need tweaking under Windows, since it's pretty hardcoded for my system. To build for Windows, run "make". For Linux and such, "make os=unix"."
older builds, if you really want them for some reason, can be found in the archive.
known bugs & bug reporting
we know it crashes occasionally. we know it doesn't build easily. we know it chokes if you attempt to load 800 megs of 30,000x40,000px jpgs. we know auto-leveling is somewhat weird. please don't tell us these things, because we already know. if you come up with something brand new, or even better - if you come up with a FIX for something - then you should contact us. it would also be appreciated if you could find a reproducable test-case for the random crashing.
credits
original program, original source, original everything: Dag Ågren, circleSoft
misc code cleanup and preferences: MAD-Leser
website, icons, product evangelism: inpheaux
mangariini is hosted by skizzers.org, much like many other things.