base on An Open source app to download and read books from shadow library (Anna’s Archive) <div align="center"> <img src="assets/icons/appIcon.png" width="150"> # Openlib An Open source app to download and read books from shadow library ([Anna’s Archive](https://annas-archive.org/)) [](https://flutter.dev/) [](https://opensource.org/licenses/) [](https://github.com/dstark5/Openlib/releases) [<img src="github_releases.png" alt="Get it on GitHub" height="60">](https://github.com/dstark5/Openlib/releases) [<img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" alt="Get it on IzzyOnDroid" height="60">](https://android.izzysoft.de/repo/apk/com.app.openlib) [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="60">](https://f-droid.org/en/packages/com.app.openlib/) </div> ## Note 📝 **WARNING:** This App Is In Beta Stage, So You May Encounter Bugs. If You Do, Open An Issue In Github Repository. **Publishing Openlib, Or Any Fork Of It In The Google Play Store Violates Their Terms And Conditions** ## Screenshots 🖼️ [<img src="screenshots/Screenshot_1.png" width=160>](screenshots/Screenshot_1.png) [<img src="screenshots/Screenshot_2.png" width=160>](screenshots/Screenshot_2.png) [<img src="screenshots/Screenshot_3.png" width=160>](screenshots/Screenshot_3.png) [<img src="screenshots/Screenshot_4.png" width=160>](screenshots/Screenshot_4.png) [<img src="screenshots/Screenshot_5.png" width=160>](screenshots/Screenshot_5.png) [<img src="screenshots/Screenshot_6.png" width=160>](screenshots/Screenshot_6.png) [<img src="screenshots/Screenshot_7.png" width=160>](screenshots/Screenshot_7.png) [<img src="screenshots/Screenshot_8.png" width=160>](screenshots/Screenshot_8.png) ## Description 📖 Openlib Is An Open Source App To Download And Read Books From Shadow Library ([Anna’s Archive](https://annas-archive.org/)). The App Has Built In Reader to Read Books As [Anna’s Archive](https://annas-archive.org/) Doesn't Have An API. The App Works By Sending Request To Anna’s Archive And Parses The Response To objects. The App Extracts The Mirrors From Response And Downloads The Book ## Features ✨ - Trending Books - Download And Read Books With In-Built Viewer - Supports Epub And Pdf Formats - Open Books In Your Favourite Ebook Reader - Filter Books - Sort Books ## Roadmap 🎯 - Adding More Book Format supports (cbz,cbr,azw3,etc...) - Adding Support For Background Downloads - Adding Support For Multiple Downloads - Move existing books when changing the storage path ## Building from Source - If you don't have Flutter SDK installed, please visit official [Flutter](https://flutter.dev) site. - Git Clone The Repo ```sh git clone https://github.com/dstark5/Openlib.git ``` - Run the app with Android Studio or VS Code. Or the command line: ```sh flutter pub get flutter run ``` - To Build App Run: ```sh flutter build ``` - The Build Will Be In './build/app/outputs/flutter-apk/app-release.apk' ### Android Make sure that `android/local.properties` has `flutter.minSdkVersion=21` or above For setup guide see [SETUP.md](./SETUP.md) ## Contributor required 🚧 We are actively seeking contributors. Whether you're a seasoned developer or just starting out, we welcome your contributions to help make this project even better! ## Contribution 💝 Whether you have ideas, design changes or even major code changes, help is always welcome. The app gets better and better with each contribution, no matter how big or small! If you'd like to get involved See [CONTRIBUTING.md](./CONTRIBUTING.md) for the guidelines. ## Issues 🚩 Please report bugs via the [issue tracker](https://github.com/dstark5/Openlib/issues). ## Donate 🎁 If you like Openlib, you're welcome to send a donation. [Donate To Anna’s Archive.](https://annas-archive.org/donate?tier=1) ## License 📜 [](https://www.gnu.org/licenses/gpl-3.0.en.html) Openlib is a free software licensed under GPL v3.0 It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. [GNU General Public License](https://www.gnu.org/licenses/gpl.html) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. ## Disclaimer ⚠️ Openlib does not own or have any affiliation with the books available through the app. All books are the property of their respective owners and are protected by copyright law. Openlib is not responsible for any infringement of copyright or other intellectual property rights that may result from the use of the books available through the app. By using the app, you agree to use the books only for personal, non-commercial purposes and in compliance with all applicable laws and regulations. ", Assign "at most 3 tags" to the expected json: {"id":"9992","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"