Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 1.56 KB

README.md

File metadata and controls

42 lines (30 loc) · 1.56 KB

KindleClippings

.NET parser for the Amazon Kindle's "My Clippings.txt" file.

The solution has two components, a library (KindleClippings) and GUI (KindleClippingsGUI) which provides a sample front-end for the library.

The GUI uses Eto.Forms for cross-platform compatibility.

How To Use

Library

  1. Build the solution and reference the outputted KindleClippings.dll
  2. Call MyClippingsParser.Parse() using either (a) the path to a "My Clippings.txt" file or (b) a stream matching the format of a "My Clippings.txt" file to return the clippings
  3. Optionally call ClippingOrganizer.GroupClippingsByAuthorAndBook(), passing in the clippings, to organize them

GUI

  1. Connect your Kindle to your PC as a USB drive
  2. Copy "My Clippings.txt" from your Kindle (optional)
  3. Build/Run the GUI
  4. Browse to the location of the "My Clippings.txt" file OR select the connected, removable Kindle device
  5. Click "Parse"
  6. Expand the appropriate author and book in the tree
  7. Double click on a highlight/note entry in the tree to view details

TODO

  • GUI: Minor improvements to interface, including background colors (Clipping Form)
  • Export functionality
  • Calibre integration?
  • Document the library
  • Some kind of installer and publishing mechanism
  • Automated test suite
  • Ensure that this works with all Kindle devices (so far tested only on output from Kindle Touch running various firmware versions)
  • Pull data directly from Kindle by Reading MBS files???
  • Move pulling from Kindle functionality from GUI to library?