Warning
- This app may contain explicit content, so viewer discretion is strongly advised.
- This app is in dormant mode, and there are some known issues specifically about the local collection. Hopefully will be maintained again in somewhere in 2025 ~ early 2026 :).
A lite open-source mobile version of your favorite vndb.org website.
Table of Contents
Currently, this app only supports for Android. I am unable to test the app for IOS platform, since I don't have any apple device. Contact me if you want to help me testing for IOS platform! :D
This project, VNDB Lite, is not an official app advertised by the official website itself. It is simply just a personal project that the developer himself found interesting, and worthwhile expanding his skills and knowledge in mobile development.
This is a very new project with a lot of potential to improve. If you'd like to help out, please give it a star π and share it with the others! You can also jump in and start contributing right away! Just fork the project and suggest any changes you'd like me to consider. That'll be very helpful for a small developer like me.
And hey, I'm always open for donation!
It is a website that houses a large public database of Visual Novels, hence the name stands for Visual Novel DataBase (VNDB). You can learn more about the website itself here.
Do read the disclaimer above first please.
This app is still in development, and is heavily inspired by Tachiyomi (A digital comic reading app), someone from reddit which I forgot, and a picture I found from the internet which looks really cool! That picture gave me a lot of inspiration. I tried to make one like that, but I ended up having a lite version and a sleep apnea instead.
If you ever use Tachiyomi or similar app, then I assure you can adapt fast with this app's UI.
VNDB Lite is currently released for Android only, and it only supports Android 5.0+.
Unfortunately and currently, I don't have any IOS device to neither build nor even test the app. But as the framework (Flutter) itself supports cross-platform, you can build yourself the app from the source code for your own specific platform, and then test it.
As the name stated: Lite, this app does not cover the entire feature you might found in the original website itself, though, some of the fundamentals are covered in this app.
Here are the features:
-
Up to 11 VNDB official themes (though some of them sucks, I really am following the official theme, so don't blame me lol)
-
Previews of VNs (Based on latest user collection, and Top-bys)
-
Advanced search
-
Easy to save vn selection and multiselection
-
VNDB latest statistics chart (I know it's ugly, but at least it can spin)
-
Local collection
-
VNDB account synchronization
-
Offline mode (Once entering vn detail screen)
-
Double-click to censor/uncensor cover π
-
(ΰΈγ)ΰΈ§ And many more...!
Warning
VNDB Lite Synchronization does not support the following:
- Custom status other than the built-in ones, such as:
playing, finished, stalled, dropped, wishlist, and blacklist. Other than that will be considered invalid and will not be synchronized. - A VN item which has multiple status on it, such as:
playing, anddroppedin a single item, that is not fully valid. Synchronization with VNDB Lite will only take one from the two. But any of the built-in status withvotedis valid. - Saving the changes made from the cloud to the local once successfully synchronized. VNDB Lite's synchronization is local-oriented, so once user synchronized, any change from the cloud, such as editing an already existing item, will not be tolerated, and will be overrided instead by the local existing ones instead the moment user synchronizing again. The same thing happens when deleting an item from the cloud, once synchronizing again, if the item still exists in local, then it will go back to the cloud (in a form of a backup). The only thing that local tolerated with cloud changes, is that adding a new item from the cloud, and that will be saved in the local.
- The ability to immediately synchronize lot of vns (probably 60+) at once in a single synchronization. There are times when your cloud vns are not fully synchronized in the local collection after the first time synchronization, especially if you've lots of vns in your vndb collection. Make sure that after a short delay, try to synchronize again until it fully indexing all of your cloud vns in the local collection.
Consider changing your collection via vndb.org first to make sure that all of your VNs are valid when synchronizing using this app.
TODOS:
- Landscape mode optimization
- Custom background
- Detail screen UI update
- Filter & Sort mechanism
- Better collection methods
- Vn review
- Vn self-note (Add note to a certain vn)
- New vn releases news
Dev note:
- No, there will be no localizations. β =ΝΝΝΝ =ΝΝΝΝ οΎ( Β΄Π`)οΎ I can engrish
){kind=icon}
With main dependencies such as:
And many more...!
Migrated to an upcoming blog site π...
To avoid incompatibility, it is recommended that at least you have flutter's engine with version of 3.29.2 (stable). Here's how to check yours.
flutter --versionAlso do check whether there's anything wrong with the engine.
flutter doctor -v- Clone this repository
git clone https://github.com/Daniel-C-J/vndb-lite.git- Open your terminal and
cdto the root path of the repository, for example:
cd vndb-lite- Type
flutter build --helpthen head down to theAvailable subcommands:section, you'll be able to found the platform specific options to build the app.
flutter build --help
flutter build apk --release # If you choose to build android app.- The output path is usually in
./build, for android specifically it is in./build/app/outputs/flutter-apk/alongside with thesha-1hash.
start . # To quickly opens file explorer to see for yourself the output.- And you're done! Congrats π!
Well there's no real official documentation yet for this project, and it is as simple as managing your own library. So have fun, and experiment with it!
Distributed under the Apache-2.0 License.
Daniel CJ - dcj.dandy800@passinbox.com
Project Link: https://github.com/Daniel-C-J/vndb-lite
- Synchronized data is stored in vndb.org via its official API.
- The icon used for this app is not mine, it's one of majikoi's CG, and I'm just using it just for fun.
