readstor

Crates.ioreadstor
lib.rsreadstor
version
sourcesrc
created_at2021-10-30 22:45:59.786616
updated_at2025-01-05 21:10:06.752595
descriptionA CLI for Apple Books annotations
homepagehttps://github.com/tnahs/readstor
repositoryhttps://github.com/tnahs/readstor
max_upload_size
id474535
Cargo.toml error:TOML parse error at line 26, column 1 | 26 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Shant Ergenian (tnahs)

documentation

https://tnahs.github.io/readstor/

README

ReadStor - A CLI for Apple Books annotations

ReadStor is a simple CLI for exporting user-generated data from Apple Books. The goal of this project is to facilitate data-migration from Apple Books to any other platform. Currently, Apple Books provides no simple way to do this. Exporting is possible but not ideal and often times truncates long annotations.

Version 0.1.x contained the core functionality: (1) save all annotations and notes as JSON (2) render them via a custom (or the default) template using the Tera syntax or (3) backup the current Apple Books databases.

Note that this repository is a heavy work-in-progress and things are bound to change.

Usage

See the documentation for usage information.

Installation

Using Homebrew

brew tap tnahs/formulas
brew install readstor
readstor --version

Using Cargo

cargo install readstor

Version Support

Apple Books' data schema can change with any update. The following versions have been verified as working. This is an ever-growing, non-exhaustive list of verified versions. If a version isn't listed, it doesn't necessarily mean it isn't supported.

macOS

  • macOS Sonoma 14.x
    • Apple Books 6.x
  • macOS Ventura 13.x
    • Apple Books 5.x
  • macOS Monterey 12.x
    • Apple Books 4.x
  • macOS Big Sur 11.x
    • Apple Books 3.x

iOS

  • iOS 16.x

Limitations

Libraries that are synced with iCloud Drive are not supported.

Commit count: 263

cargo fmt