kindle-my-clippings is a command line tool for parsing and organizing your Kindle highlights.
If you installed the module globally, run it in the folder containing 'My Clippings.txt' file or specify a path to it with -i (--input) option.
Running kindle-my-clippings will display a title list, ex.:
1 - Developing Backbone.js Applications
2 - Dive Into Python
3 - Zen and the Art of Motorcycle Maintenance
4 - Jump Start Node.js
Entering a number from the list will display all highlights for a corresponding title.
will show location of each highlight, ex.
---------- 205-6
We’re in such a hurry most of the time we never get much chance to talk.
The result is a kind of endless day-to-day shallowness, a monotony that leaves a person wondering years later where all the time went and sorry that it’s all gone.
---------- 207-8
What is in mind is a sort of Chautauqua—that’s the only name I can think of for it—like the traveling tent-show Chautauquas that used to move across America,
---------- 211-12
Perhaps because of these changes the stream of national consciousness moves faster now, and is broader, but it seems to run less deep.
---------- 213-14
In this Chautauqua I would like not to cut any new channels of consciousness but simply dig deeper into old ones that have become silted in with the debris of thoughts grown stale and platitudes too often repeated.
You might want to use locations for more control over the output - see the next option.
This options lets you specify the first highlight to display from. For example, given the above example output,
running kindle-my-clippings -b 3 -l -s '211-12' will return highlights starting from this particular location, skipping the first two.
This may be useful in a situation where you've generated a file with some highlights but want to add more to the same file after finishing the book.
Note the use of -b option which is mandatory to use with -s options.
Specifying this option will skip the title list and at the beginning and display the contents of a given book.
Lets you specify a path to your clippings file or files. You can specify multiple coma separated files, ex. -i 'my_clippings_1.txt,my_clippings_2.txt'.
Writes output to the provided path.
Determines the output of clippings: json for a stringified collection of JSON objects, html for simple html, text for plain text, and evernote for .enex files. SEE NOTES ABOUT EVERNOTE MODE below
If the option is not specified, the default format is text.
If evernote is selected, it will create a file for each book, named <title>_<author>.enex. If the notes for a book do not contain text (like if the notes are only bookmarks), the file for that book will not be created. The -b, -o, -s options are disabled if evernote is selected.
-
0.3.0 22.11.2015 CLI only. New API. Display title list and choose a title.
-
Older API versions, supporting html output can be found here: version 0.2.1.