Skip to content

A mobile books tracker written in Flutter that respects your privacy.

License

Notifications You must be signed in to change notification settings

mateusz-bak/openreads

Repository files navigation

Openreads

GitHub tag (latest by date) GitHub Workflow Status (with event) Weblate project translated Join the community Mastodon Follow

Get it on Github Get it on F-Droid Get it on Google Play Download on App Store

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.

There are four lists provided so you won't get confused:

  • books you finished,
  • books you are currently reading,
  • books you want to read later,
  • books you didn't finish.

You can use custom tags and filter through them.

A book can be added by:

  • looking it up in the Open Library database,
  • scanning its barcode,
  • adding its details manually.

You can also view some cool statistics!



🀝 Contributing

Do you want to support Openreads development? You are welcome to take below actions:

πŸͺ™ Become a Sponsor

Fund the project, or simply say thank you.

Become a GitHub Sponsor

πŸ“£ Spread the word about Openreads

πŸ‘ Vote on Alternativeto.net

Alternativeto.net link

🌟 Give a star to the project

Github.com link

πŸ“– Translate Openreads

Go to Weblate and help with the translations.

Translation status

🐞 Report bugs or new ideas

Submit an issue here: Openreads issues.

πŸ“ Contributors guide

Take a look at our CONTRIBUTING.md file.

πŸ“„ Attributions

πŸ‘οΈβ€πŸ—¨οΈ Icons

Font Awesome

❓ FAQ

  • What platforms is Openreads available for?
    The app is written in the cross-platform framework Flutter. Android and iOS versions are available. Be aware that releasing an app to the App Store requires paid Apple Developer account ($99 per year) so please consider donating.
  • Does Openreads support importing/exporting CSV file?
    Yes! See format of the CSV file: Openreads CSV format
  • From which apps can Openreads import CSV files?
    GoodReads, BookWyrm
  • Which data providers does OpenReads use?
    Currently the one and only data source for the app is OpenLibrary, 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: #90 (comment))
  • Is it possible to upload my book's data to OpenLibrary?
    Not for now; see #85

πŸ—οΈ Build Process

  1. Clone or download this repository

    git clone https://github.com/mateusz-bak/openreads.git
    cd openreads
  2. Download dependencies

    flutter pub get
  3. Build and install the app on your device
    ⚠️⚠️⚠️
    WARNING: If you already have the Openreads app installed on your device, this step will uninstall it before installing the debug version. This deletes all app data, to keep your books please make a backup first.
    ⚠️⚠️⚠️

    flutter run