Skip to content
CLI tool to upload lookups from a Kindle to vocabulary.com
JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
index.js
package.json
readme.md
yarn.lock

readme.md

Voc Uploader

A simple CLI app to upload the dictionary lookups from any book on your Amazon Kindle to a vocabulary.com list.

Enabled by the unofficial Vocabulary.com API (GitHub).

1 - Select the lookups you want to upload (in CLI)

2 - Learn them in vocabulary.com

For everyone who thinks learning words on a Kindle device is not the best way. This app joins a range of other projects that do the same for other vocabulary services (Memrise, ANKI), ...

Currently in a working proof-of-concept state.

Installation

  1. Clone the repo
  2. Connect your Kindle via USB. Locate your vocab.db file, making sure that you can see hidden files in your file manager. On my macOS system it's in /Volumes/Kindle/system/vocabulary/vocab.db
  3. Copy vocab.db to somewhere on your file location (so you don't mess with the original).
  4. Create a file config.js in the repo with the following content:
    module.exports = {
        voc_username: "<your vocabulary.com username>",
        voc_password: "<your vocabulary.com password>",
        db_path: "<path to your Kindle's vocab.db file>"
    };
    
    Note: for now you need to create an explicit password for your account if you only used OAuth login before (eg. Google). A way to support any vocabulary.com login is in the works.

Usage

Run node index.js An interactive CLI will guide you through the process of uploading a list for a book.

Wishlist

  • Interactive Kindle device handling (plug & play, no explicit vocab.db reference)
  • A GUI to (de)select unintended words at upload time.
  • Testing/support for more e-readers with this function

You may also be interested in: Voc Enhancer (GitHub), the browser plugin that enhances word collection & learning in vocabulary.com.

You can’t perform that action at this time.