{"id":24247479,"url":"https://github.com/daniel-c-j/vndb-lite","last_synced_at":"2026-03-06T03:32:13.102Z","repository":{"id":267917054,"uuid":"901888654","full_name":"Daniel-C-J/vndb-lite","owner":"Daniel-C-J","description":"A lite open-source mobile version of your favorite vndb.org website.","archived":false,"fork":false,"pushed_at":"2025-01-03T13:41:47.000Z","size":41888,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-03T14:42:38.481Z","etag":null,"topics":["android","android-application","flutter-app","flutter-apps","ios","visual-novel","vn","vndb","vndb-api","vndb-lite"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Daniel-C-J.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"danielcj","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-12-11T13:59:48.000Z","updated_at":"2025-01-03T13:41:51.000Z","dependencies_parsed_at":"2024-12-13T08:37:54.662Z","dependency_job_id":null,"html_url":"https://github.com/Daniel-C-J/vndb-lite","commit_stats":null,"previous_names":["daniel-c-j/vndb-lite"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-C-J%2Fvndb-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-C-J%2Fvndb-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-C-J%2Fvndb-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daniel-C-J%2Fvndb-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Daniel-C-J","download_url":"https://codeload.github.com/Daniel-C-J/vndb-lite/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233976388,"owners_count":18760043,"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":["android","android-application","flutter-app","flutter-apps","ios","visual-novel","vn","vndb","vndb-api","vndb-lite"],"created_at":"2025-01-14T23:46:28.491Z","updated_at":"2025-09-23T12:32:30.864Z","avatar_url":"https://github.com/Daniel-C-J.png","language":"Dart","funding_links":["https://ko-fi.com/danielcj","https://ko-fi.com/P5P4L666F"],"categories":[],"sub_categories":[],"readme":"\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003e [!WARNING]\n\u003e 1) This app may contain explicit content, so viewer discretion is **strongly advised**. \n\u003e 2) Yes I still maintain this app, but not as often as in the past. This app will be keep maintained until 2026.\n\n\u003c!-- Banner --\u003e\n\u003cimg src=\"./media/banner.png\" align=\"center\"\u003e\n\n\u003c!-- Title \u0026 description --\u003e\n\u003ch1 align=\"center\"\u003e[VNDB Lite]\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA lite, free, and open-source mobile version of your favorite website, vndb.org.\u003c/p\u003e\n\n\u003c!-- Badges --\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://flutter.dev\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/Platform-Flutter-02569B?logo=flutter\"\n        alt=\"Platform\" /\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/Daniel-C-J/vndb-lite\" alt=\"license\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/Daniel-C-J/vndb-lite\" alt=\"release\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003c!-- Standalone Obtainium badge --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"http://apps.obtainium.imranr.dev/redirect.html?r=obtainium://app/%7B%22id%22:%22com.vndblite.dcj%22,%22url%22:%22https://github.com/daniel-c-j/vndb-lite%22,%22author%22:%22DanielCJ%22,%22name%22:%22VNDB%20Lite%22,%22preferredApkIndex%22:0,%22additionalSettings%22:%22%7B%5C%22includePrereleases%5C%22:false,%5C%22fallbackToOlderReleases%5C%22:true,%5C%22filterReleaseTitlesByRegEx%5C%22:%5C%22%5C%22,%5C%22filterReleaseNotesByRegEx%5C%22:%5C%22%5C%22,%5C%22verifyLatestTag%5C%22:false,%5C%22dontSortReleasesList%5C%22:false,%5C%22useLatestAssetDateAsReleaseDate%5C%22:false,%5C%22trackOnly%5C%22:false,%5C%22versionExtractionRegEx%5C%22:%5C%22%5C%22,%5C%22matchGroupToUse%5C%22:%5C%22%5C%22,%5C%22versionDetection%5C%22:true,%5C%22releaseDateAsVersion%5C%22:false,%5C%22useVersionCodeAsOSVersion%5C%22:false,%5C%22apkFilterRegEx%5C%22:%5C%22%5C%22,%5C%22invertAPKFilter%5C%22:false,%5C%22autoApkFilterByArch%5C%22:true,%5C%22appName%5C%22:%5C%22VNDB%20Lite%5C%22,%5C%22exemptFromBackgroundUpdates%5C%22:false,%5C%22skipUpdateNotifications%5C%22:false,%5C%22about%5C%22:%5C%22A%20lite,%20free,%20and%20open-source,%20mobile%20version%20of%20your%20favorite%20website,%20vndb.org.%5C%22,%5C%22appAuthor%5C%22:%5C%22DanielCJ%5C%22%7D%22%7D\"\u003e\n    \u003cimg src=\"./media/badge_obtainium.png\" alt=\"Make sure you have Obtainium installed!\" title=\"Make sure you have Obtainium installed!\" height=\"70\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\nest. read time: \u003cb\u003e6.5 minutes\u003c/b\u003e\n\u003cbr/\u003e\u003cbr/\u003e\n\n\u003c!-- INDEX --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eIndex\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#quick-start\"\u003eQuick start\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\n    \u003ca href=\"#disclaimer\"\u003eDisclaimer\u003c/a\u003e\n    \u003cli\u003e \u003ca href=\"#about-the-project\"\u003eAbout the project\u003c/a\u003e\u003c/li\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#community-and-support\"\u003eCommunity and support\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#main-features\"\u003eMain features\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt with\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#history\"\u003eHistory\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#changelog\"\u003eChangelog\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributors\"\u003eContributors\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n## Quick start\n\n[Download the latest version here.](https://github.com/Daniel-C-J/vndb-lite/releases)\n\nN.B. - currently, this app only supports Android. I am unable to test the app for iOS, because I don't have any device from Apple. Contact me if you want to help me test VNDB Lite for iOS! :D\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## Disclaimer\n\nThis project, **VNDB Lite**, is not an official app supported by [VNDB.org](https://vndb.org/) itself. It is simply a personal project that the developer found interesting, and that it was worthwhile to expand his competences and knowledge in mobile application development.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## About the project\n\n### Community and support\n\nThis is a relatively new project with a lot of potential for new improvements. If you'd like to help out, please give it a star 🌟 and share it with others! You can also jump in and start contributing right away! Just fork the project and suggest changes you'd like me to consider. That'll be very helpful for a small developer like me.\n\nCredit to flat-gal-expert for refactoring this README file and other files!\n\nAnd hey, I also accept donations!\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/P5P4L666F)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### About VNDB\n\nIt is a website that hosts a large public database of visual novels, and as the name suggests, VNDB stands for the Visual Novel DataBase. You can learn more about the website itself [here](https://vndb.org/d7).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### About VNDB Lite\n\n\u003e Please read the disclaimer above first.\n\nThis app is still in development. It is heavily inspired by Tachiyomi (a digital comic reading application), someone from Reddit which I forgot, and an image I found from the Internet which looked really cool! That image gave me a lot of inspiration. I tried to make something resembling it, but I ended up having a lite version and a sleep apnea instead.\n\n\u003cimg src=\"./media/inspiration.png\" width=\"350px\" height = \"250px\"\u003e\n\nIf you ever used Tachiyomi or some similar app, then I assure you that you will adapt rapidly to this app's interface.\n\nVNDB Lite is currently released for **Android only**, and it only supports **Android 5.0+**. \n\nCurrently, unfortunately, I have no iOS device to compile or even test the app. But as the framework (Flutter) itself is cross-platform, you can compile yourself the app from the source code for your own specific platform, and then test it.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### Main features\n\nAs the name implies: this is a **lite** application, it does not cover all of the features you might find on the original website itself, but most of the fundamentals are covered by this app.\n\nHere are the primary features:\n1. Up to 11 VNDB official themes (well, some of them suck, but these are the official themes, so don't blame me XD)\n2. Previews of VNs (based on the latest user collection, and top VNs)\n\u003cbr\u003e[![Previews](https://img.icons8.com/ios-filled/50/000000/video.png)](https://github.com/Daniel-C-J/vndb-lite/raw/refs/heads/master/media/feature/preview.mkv)\n3. Advanced search\n\u003cbr\u003e[![Previews](https://img.icons8.com/ios-filled/50/000000/video.png)](https://github.com/Daniel-C-J/vndb-lite/raw/refs/heads/master/media/feature/adv_search.mkv)\n4. Easy way to save VN selection and multi-selection\n\u003cbr\u003e\u003cimg src =\"./media/feature/selection.png\" width=150\u003e\n5. A chart of VNDB's latest statistics (I know it's ugly, but at least it can **spin** XD)\n\u003cbr\u003e\u003cimg src =\"./media/feature/chart.png\" width=150\u003e\n6. Local collection\n7. VNDB account synchronization\n\u003cbr\u003e\u003cimg src =\"./media/feature/sync.png\" width=150\u003e\n8. Offline mode (for the VN details)\n\u003cbr\u003e\u003cimg src =\"./media/feature/offline_mode.gif\" width=150\u003e\n9. Double-click to censor/uncensor cover 👀\n10. (งツ)ว And many more...!\n\n\u003e [!WARNING]\n\u003e VNDB Lite's synchronization feature does not support the following:\n\u003e 1. Custom status other than the built-in ones, i.e. `playing, finished, stalled, dropped, wishlist, blacklist`. Anything other than that will be considered invalid and will not be synchronized. (Yet)\n\u003e 2. Decimal values for VN score. (It will eventually be rounded)\n\u003e 3. A VN item which has multiple status on it, such as: `playing`, and `dropped`, is currently not going to be considered fully valid. Synchronization with VNDB Lite will only take **one** from the two. But any of the built-in status with `voted` is valid.\n\u003e 4. ~~Saving the changes made from the VNDB server to the local storage once successfully synchronized. VNDB Lite's synchronization is local-oriented, so once the user synchronized his/her collection, any change from the VNDB server, such as **modifying** an already existing item, will not be tolerated, and will be over-written instead by the existing local ones instead whenever the user decides to synchronize again. The same thing happens when **deleting** an item from the VNDB server, once synchronizing again, if the item still exists in your local collection, then it will go back to the VNDB server (in the form of a backup). The only thing that is tolerated with VNDB server changes, is that **adding** a new item from the VNDB server, and that will be saved in the local collection.~~ Client-server semi-full synchronization is now supported starting from version 3.0.0\n\u003e 5. The ability to immediately synchronize lots of VNs (approximately 60+ items) at once in a single synchronization. There are times when your VNDB.org collection VNs are not fully synchronized with the local collection after the first time synchronization, especially if you have lots of VNs in your VNDB.org collection. Make sure to try to synchronize again after some delay until it fully indexes all of your VNDB.org collection VNs within the local collection.\n\u003e\n\u003e **Consider changing your collection via vndb.org first to make sure that all of your VNs are valid when synchronizing using this app.**\n\n\u003cbr\u003e\n\nTODOS:\n- BBCode\n- Better logic\n- Landscape mode optimization\n- Custom background\n- Detail screen UI update\n- Filter \u0026 sort mechanism\n- Better collection methods\n- VN review\n- VN note (Add note to a certain vn)\n- New VN releases news\n\nDev note:\n- No, there will be no localizations. – =͟͟͞͞ =͟͟͞͞ ﾍ( ´Д`)ﾉ I can engrish\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### Built with\n\n\u003cimg src=\"https://img.shields.io/badge/Flutter-02569B?style=for-the-badge\u0026logo=flutter\u0026logoColor=white)\"\u003e\n\nVNDB Lite mainly depends on these dependencies:\n- [Riverpod](https://pub.dev/packages/riverpod)\n- [GoRouter](https://pub.dev/packages/go_router)\n- [Dio](https://pub.dev/packages/dio)\n- [Local Notifications](https://pub.dev/packages/flutter_local_notifications)\n- [SharedPreferences](https://pub.dev/packages/sharedpreferences)\n\nBut that's not all...!\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### History\n\nMigrated to an upcoming blog site 🚛...\n\n\n### Changelog\n\n[See the change-log](./CHANGELOG.md)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting started\n\n### Prerequisites\n\nTo avoid incompatibility, it is recommended that you have at least Flutter's engine \u003e= version **3.29.2** (stable). Here's how to verify the version.\n\n```sh\nflutter --version\n```\n\nAlso do check if there's anything wrong with the engine.\n\n```sh\nflutter doctor -v\n```\n\n\n### Installation\n\n1. Clone this repository \n```sh\ngit clone https://github.com/Daniel-C-J/vndb-lite.git\n```\n\n2. Open your terminal and `cd` to the root path of the repository, for example:\n```sh\ncd vndb-lite\n```\n\n3. Type `flutter build --help` then head down to the `Available subcommands:` section, you'll be able to find the platform specific options to compile the app. \n```sh\nflutter build --help \nflutter build apk --release # This compiles the Android application.\n```\n\n4. The output path is usually in `./build`, for Android specifically it is in `./build/app/outputs/flutter-apk/` alongside with the `sha-1` hash.\n```batch\nstart . # This opens Windows's file explorer to check out the output.\n```\n\n5. And you're done! Congratulations 🎉!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage   \n\nWhile there is no real official documentation yet for this project, it is as simple as managing your own VNDB.org collection. So have fun, and experiment with it!\n\n\u003cimg src=\"./media/screenshots/Screenshot_01.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_02.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_03.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_04.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_05.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_06.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_07.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_08.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_09.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\u003cimg src=\"./media/screenshots/Screenshot_10.png\" alt=\"screenshot\" width=180  style=\"padding: 5px;\" \u003e\u003c/img\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under terms of the [Apache-2.0 License](./LICENSE).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nDaniel CJ - dcj.dandy800@passinbox.com\n\nVNDB Lite's Git repositories: [https://github.com/Daniel-C-J/vndb-lite](https://github.com/Daniel-C-J/vndb-lite), [https://codeberg.org/daniel-c-j/vndb-lite/](https://codeberg.org/daniel-c-j/vndb-lite/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n## Acknowledgments\n\n- Synchronized data is stored back to vndb.org via its official API.\n- The icon used for this app is an edited high resolution version of vndb's original icon.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- CONTRIBUTORS --\u003e\n## Contributors\n\n- [micah686](https://vndb.org/u28821) - Helped suggesting having a backup repo. (Availability and thicker OSS solution matters)\n- [flat-gal-expert](https://vndb.org/u305047) - Or should I say linguistic expert to help this app's engrish.\n- [OG-Yorhel](https://vndb.org/u2) - Helped with synchronization logic!\n  \nAnd many others that helped me outside the code spectrum — your support is greatly appreciated! You rock!\n  \n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniel-c-j%2Fvndb-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaniel-c-j%2Fvndb-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniel-c-j%2Fvndb-lite/lists"}