{"id":13629350,"url":"https://github.com/mateusz-bak/openreads","last_synced_at":"2026-06-30T07:01:10.889Z","repository":{"id":37003433,"uuid":"359926431","full_name":"mateusz-bak/openreads","owner":"mateusz-bak","description":"A mobile books tracker written in Flutter that respects your privacy.","archived":false,"fork":false,"pushed_at":"2026-06-19T00:01:24.000Z","size":160540,"stargazers_count":1567,"open_issues_count":40,"forks_count":113,"subscribers_count":12,"default_branch":"master","last_synced_at":"2026-06-28T09:24:25.568Z","etag":null,"topics":["android","books","flutter","flutter-app","flutter-apps","mobile","open-source","openlibrary","opensource","privacy"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mateusz-bak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"mateusz-bak","custom":["https://www.buymeacoffee.com/mateuszbak"]}},"created_at":"2021-04-20T19:16:47.000Z","updated_at":"2026-06-23T22:37:02.000Z","dependencies_parsed_at":"2024-03-04T05:06:14.791Z","dependency_job_id":"e31f1fb0-c1c5-40a2-8a01-c48e9a84788e","html_url":"https://github.com/mateusz-bak/openreads","commit_stats":null,"previous_names":["mateusz-bak/openreads","mateusz-bak/openreads-android"],"tags_count":65,"template":false,"template_full_name":null,"purl":"pkg:github/mateusz-bak/openreads","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateusz-bak%2Fopenreads","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateusz-bak%2Fopenreads/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateusz-bak%2Fopenreads/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateusz-bak%2Fopenreads/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mateusz-bak","download_url":"https://codeload.github.com/mateusz-bak/openreads/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateusz-bak%2Fopenreads/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34955986,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","books","flutter","flutter-app","flutter-apps","mobile","open-source","openlibrary","opensource","privacy"],"created_at":"2024-08-01T22:01:08.240Z","updated_at":"2026-06-30T07:01:10.869Z","avatar_url":"https://github.com/mateusz-bak.png","language":"Dart","funding_links":["https://github.com/sponsors/mateusz-bak","https://www.buymeacoffee.com/mateuszbak","https://github.com/sponsors/mateusz-bak'"],"categories":["Misc","Dart"],"sub_categories":["Flutter"],"readme":"\u003c!--\n  Title: Openreads\n  Description: A mobile books tracker written in Flutter. Free, private and open source.\n  Author: mateusz-bak\n  --\u003e\n\n# Openreads\n\n\n\u003cp align='center'\u003e  \n \u003cimg src='doc/github/github-banner.png' width='100%'/\u003e\n\u003c/p\u003e\n\n[![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/mateusz-bak/openreads?label=latest%20version\u0026style=flat-square)](https://github.com/mateusz-bak/openreads/releases/latest)\n[![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/mateusz-bak/openreads/test_build.yml?style=flat-square)](https://github.com/mateusz-bak/openreads/actions/workflows/test_build.yml)\n[![Weblate project translated](https://img.shields.io/badge/weblate-translations_needed-orange?style=flat-square\u0026logo=weblate)](https://hosted.weblate.org/engage/openreads/)\n[![Join the community](https://img.shields.io/badge/matrix.org-join_community-teal?style=flat-square\u0026logo=matrix)](https://matrix.to/#/#openreads:matrix.org)\n\u003ca rel=\"me\" href='https://fosstodon.org/@openreads'\u003e\u003cimg alt=\"Mastodon Follow\" src=\"https://img.shields.io/mastodon/follow/110707338082983645?domain=https%3A%2F%2Ffosstodon.org\u0026style=flat-square\u0026logo=mastodon\u0026color=royalblue\"\u003e\u003c/a\u003e\n\u003cbr/\u003e\n\n\u003ca href='https://github.com/mateusz-bak/openreads/releases/latest'\u003e\u003cimg height=70 alt='Get it on Github' src='https://raw.githubusercontent.com/mateusz-bak/openreads/master/doc/github/get-it-on-github.png'/\u003e\u003c/a\u003e\n\u003ca href='https://f-droid.org/en/packages/software.mdev.bookstracker'\u003e\u003cimg height=70 alt='Get it on F-Droid' src='https://fdroid.gitlab.io/artwork/badge/get-it-on.png'/\u003e\u003c/a\u003e\n\u003ca href='https://play.google.com/store/apps/details?id=software.mdev.bookstracker'\u003e\u003cimg height=70 alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png'/\u003e\u003c/a\u003e\n\u003ca href='https://apps.apple.com/app/id6476542305'\u003e\u003cimg height=70 alt='Download on App Store' src='https://raw.githubusercontent.com/mateusz-bak/openreads/master/doc/app_store/download_on_app_store.png'/\u003e\u003c/a\u003e\n\n### Openreads is a privacy oriented and open source cross-platform app written in Flutter available for Android and iOS for keeping track of your books.  \n#### There are four lists provided so you won't get confused:  \n- books you finished,  \n- books you are currently reading,  \n- books you want to read later,\n- books you didn't finish.\n\nYou can use custom tags and filter through them.\n\n#### A book can be added by:\n- looking it up in the Open Library database,\n- scanning its barcode,\n- adding its details manually.\n\n####  You can also view some cool statistics!  \n\n\u003cbr/\u003e\n\n\u003cp align='left'\u003e  \n \u003cimg src='doc/gplay/app-mockup/Google Pixel 4 XL Screenshot 0.png' width='19%'/\u003e  \n \u003cimg src='doc/gplay/app-mockup/Google Pixel 4 XL Screenshot 1.png' width='19%'/\u003e    \n \u003cimg src='doc/gplay/app-mockup/Google Pixel 4 XL Screenshot 2.png' width='19%'/\u003e\n \u003cimg src='doc/gplay/app-mockup/Google Pixel 4 XL Screenshot 3.png' width='19%'/\u003e\n \u003cimg src='doc/gplay/app-mockup/Google Pixel 4 XL Screenshot 4.png' width='19%'/\u003e\n\u003c/p\u003e  \n\u003cbr/\u003e\n\n## 🤝 Contributing\n\nDo you want to support Openreads development? You are welcome to take below actions:\n\n### 🪙 Become a Sponsor\n\nFund the project, or simply say thank you.\n\n\u003ca href='https://github.com/sponsors/mateusz-bak'\u003e\u003cimg height=50 alt='Become a GitHub Sponsor' src='https://raw.githubusercontent.com/mateusz-bak/openreads/master/doc/github/button_become-a-github-sponsor.png'/\u003e\u003c/a\u003e\n\u003ca href=\"https://www.buymeacoffee.com/mateuszbak\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" height=\"50\"\u003e\u003c/a\u003e\n\n### 📣 Spread the word about Openreads\n#### 👍 Vote on Alternativeto.net\n[Alternativeto.net link](https://alternativeto.net/software/openreads/about/)\n\n#### 🌟 Give a star to the project\n[Github.com link](https://github.com/mateusz-bak/openreads)\n\n### 📖 Translate Openreads\n\nGo to [Weblate](https://hosted.weblate.org/engage/openreads/) and help with the translations.\n\n\u003ca href=\"https://hosted.weblate.org/engage/openreads/\"\u003e\n\u003cimg src=\"https://hosted.weblate.org/widgets/openreads/-/multi-auto.svg\" alt=\"Translation status\" /\u003e\n\u003c/a\u003e\n\n### 🐞 Report bugs or new ideas\nSubmit an issue here: [Openreads issues](https://github.com/mateusz-bak/openreads/issues).\n\n### 📝 Contributors guide\n\nTake a look at our [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## 📄 Attributions\n\n### 👁️‍🗨️ Icons\n[Font Awesome](https://fontawesome.com/ \"Font Awesome\")\n\n## ❓ FAQ\n\n- **What platforms is Openreads available for?** \u003c/br\u003e\nThe app is written in the cross-platform framework Flutter. Android and iOS versions are available.\nBe aware that releasing an app to the App Store requires paid Apple Developer account ($99 per year) so please consider donating.\n- **Does Openreads support importing/exporting CSV file?**\u003c/br\u003e\nYes! See format of the CSV file: \n[Openreads CSV format](doc/csv.md)\n- **From which apps can Openreads import CSV files?**\u003c/br\u003e\nGoodReads, BookWyrm\n- **Which data providers does OpenReads use?**\u003c/br\u003e\nCurrently the one and only data source for the app is [OpenLibrary](https://openlibrary.org/), a FOSS crowdsourced library. Other sources (like BookBrainz) are considered for the future. There are no plans to add proprietary sources to the app (see: https://github.com/mateusz-bak/openreads/issues/90#issuecomment-1722339001)\n- **Is it possible to upload my book's data to OpenLibrary?**\u003c/br\u003e\nNot for now; see https://github.com/mateusz-bak/openreads/issues/85\n\n\u003cbr/\u003e\n\n## 🏗️ Build Process\n\n1. Clone or download this repository\n\n   ```sh\n   git clone https://github.com/mateusz-bak/openreads.git\n   cd openreads\n   ```\n\n2. Download dependencies\n\n   ```sh\n   flutter pub get\n   ```\n\n2. Build and install the app on your device\u003cbr/\u003e\n⚠️⚠️⚠️\u003cbr/\u003e\nWARNING: If you already have the Openreads app installed on your device, this step will uninstall it before installing the debug version.\nThis deletes all app data, to keep your books please make a backup first.\u003cbr/\u003e\n⚠️⚠️⚠️\u003cbr/\u003e\n\n   ```sh\n   flutter run\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateusz-bak%2Fopenreads","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmateusz-bak%2Fopenreads","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateusz-bak%2Fopenreads/lists"}