d3vd/clips

Kindle Clippings Parser

Clips -- Kindle Clippings Parser

A Web App that parses kindle clippings into usable format

Running Locally

From Source

1. Clone the repo onto your local machine using git clone

  git clone https://github.com/D3vd/Clips.git

2. Install dependencies

  yarn

(or)

  npm install

3. Start App

  yarn start

(or)

  npm start

Using Docker

  docker run -p 3000:80 d3vd/clips

clips's Issues

some suggestions/feature requests

I've made the application run in docker. After I imported my clips.txt and tested it in the browser, I like it pretty much.
After my short testing, come up with a few suggestions, you can consider them, it would be great if you can apply some of them:

• Function: import works well! nice. however, re-import is required after reloading the page. I guess this is because it converted the content and saved it in the memory. Could we save the converted data (json? very likely) somewhere? If the goal of the app is only personal usage, I guess we can consider re-creating the json after each new import.
• Function: It would be great if there is font-size option.
• UI: book list and clips side by side is nice, I like it. However, could you please make the splitter selectable/moveable so that we can adjust the two frames to have a different proportion than 50%:50%?
• UI: Is it possible to provide a list view of the books? In case one had many books, it's a bit inconvenient to find the right one.
• UI: Do you think it's ok to make the header of the page "Books (number)" "upload area" and the "title -- x Clips" smaller? right now they're using about 25% of the browser window height

I like your application. I wish I could contribute to the nice project....
Probably, it encourages me to learn some javascript :-D
Thank you

Can we have a install/how to run guide?

Hi,
I am looking for a "self-hosted" kindle clips service. When I see Clips' animation, I think it almost fits all my needs.
I cloned your repo. However, I'm not a javascript developer.
After some googling, I know that I need first to install a js package manager npm/yarn.
However, after that, both npm install and yarn install run with errors.
Could you please add a "how to start" section (or something like that) in your readme.md?
Thank you.