codito/noted

Extracts annotations/highlights from documents (pdf etc.), ebook readers (kindle, koreader etc.) to markdown

Noted

TL;DR noted is a command line app to liberate your highlights and notes.

Noted extracts annotations embedded into documents (pdf), or collects them from readers (kindle, or koreader). It tries to align them with the chapters and context to produce a plain text markdown file.

Features

✓ Extracts annotations (highlights and notes) for documents and books
✓ Extracts context and chapter headings along with the annotations
✓ Supports pdf, epub and mobi files
✓ Detects kindle My Clippings.txt files
✓ Detects koreader *.sdr directories
✓ Saves all the extracted information in markdown text

A note on how the author uses this tool: My reading workflow.

Installation

If you've .NET Core 5.0 or above already installed, simply download the Noted.<version>.Portable.<os>.zip file from the latest release.

If you do not wish to install .NET Core 5.0, try the self contained app from latest release.

• Windows: Noted.<version>.win-x64.zip
• Linux: Noted.<version>.linux-x64.zip

Usage

Noted:
  Extracts highlights and notes from documents and save them as markdown

Usage:
  Noted [options] <sourcePath> <outputPath>

Arguments:
  <sourcePath>    Source document or directory of documents to extract annotations
  <outputPath>    Destination file or directory

Options:
  -c, --context     extract the paragraph containing an annotation [default: False]
  -t, --toc         extract table of contents and align annotations [default: True]
  -v, --verbose     enable verbose logging [default: False]
  --version         Show version information
  -?, -h, --help    Show help and usage information

Examples

Extract a koreader library

Connect your reader device and use the KOReader documents library path. Noted will look for *.sdr directories besides each book to extract annotations.

$ ./Noted test/assets /tmp/note
> Extracting test/assets/koreader/pg42324.epub
 ✓ Frankenstein by Mary Shelley
 ✓ 5 annotations in 39 sections
 ✓ Saved to /tmp/note/pg42324.md

> Extracting test/assets/koreader/the_prophet.epub
 ✓ The Prophet by Khalil Gibran
 ✓ 4 annotations in 34 sections
 ✓ Saved to /tmp/note/the_prophet.md

Completed in 0.65s.

Extract a kindle library

First, connect your kindle over usb and provide the path to documents directory which contains My Clippings.txt file.

$ ./Noted /run/media/arun/Kindle/documents /tmp/kindle

> Extracting /run/media/arun/Kindle/documents/Epictetus/Enchiridion, The - Epictetus.mobi
 ✓ The Enchiridion by Epictetus
 ✓ 49 annotations in 58 sections
 ✓ Saved to /tmp/kindle/Enchiridion, The - Epictetus.md

Completed in 14.11s.

Now open the output file /tmp/kindle/Enchiridion, The - Epictetus.md and enjoy your notes.

Extract highlights from a pdf

$ ./Noted /home/arun/papers/Chambliss_1989_The\ Mundanity\ of\ Excellence.pdf /tmp/kindle

> Extracting /home/arun/papers/Chambliss_1989_The Mundanity of Excellence.pdf
 ✓ The Mundanity of Excellence: An Ethnographic Report on Stratification and Olympic Swimmers
 ✓ 6 annotations
 ✓ Saved to /tmp/kindle/Chambliss_1989_The Mundanity of Excellence.md

Completed in 1.71s.

Roadmap

• Support for kfx and azw3 files in kindle
• Support for additional readers like kobo etc.

Contributions in any form e.g. bug reports, feature requests or PRs are most welcome!

License

MIT

noted's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• chore(deps): update actions/checkout action to v3.5.3
• chore(deps): update dependency ephemerality.unpack to v0.0.7
• chore(deps): update dependency pdfpig to v0.1.8
• chore(deps): update dependency system.commandline to v2.0.0-beta4.22272.1
• chore(deps): update dependency anglesharp to v0.17.1
• chore(deps): update dependency versone.epub to v3.3.1
• chore(deps): update dependency anglesharp to v1
• chore(deps): update dependency anglesharp.xpath to v2
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

github-actions

.github/workflows/build.yml

• actions/checkout v3.5.2
• actions/setup-dotnet v3.2.0
• actions/upload-artifact v3
• actions/checkout v3
• actions/setup-dotnet v3.2.0
• ncipollo/release-action v1.12.0

nuget

src/Noted/Noted.csproj

• System.IO.FileSystem 4.3.0
• System.Net.Primitives 4.3.1
• Microsoft.Win32.Primitives 4.3.0
• VersOne.Epub 3.2.0
• System.Linq.Async 6.0.1
• System.CommandLine 2.0.0-beta1.20574.7
• Spectre.Console 0.47.0
• PdfPig 0.1.5
• Markdig 0.31.0
• JTForks.MiscUtil 1.285.0
• Ephemerality.Unpack 0.0.5
• AngleSharp.XPath 1.1.7
• AngleSharp 0.14.0

---

• Check this box to trigger a request for Renovate to run again on this repository