node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Searchable collection of bookmarks in a webpage

The collection presented at is my personal set distilled from Firefox.

Running locally

bookmarks is hosted via GitHub pages meaning it is a set of static files. You can run a local server via a utility like serve.

# Install server if you haven't yet
npm install -g serve
# npm http GET
# npm http 200
# ...
# Run serve
# serving /home/todd/github/bookmarks on port 3000

Open http://localhost:3000/ in your browser and you should be presented with the webpage.

Installing your bookmarks

bookmarks.json is agnostic to being Firefox specific and it is planned that we support Pinboard in the future. The current structure is that from firefox-bookmarks' flatten method.

  • bookmarks Object[] - Array of bookmarks
    • Each bookmark should be of the format:
      • title String - Name of the folder
      • uri String - URL that was saved for the bookmark
      • description String - Description for the link
      • dateAdded Number - Microseconds (milliseconds/1000) since Linux epoch that bookmark was added
      • lastModified Number - Microseconds since Linux epoch that bookmark was last updated


We provide utility functions to load your Firefox bookmarks.

# Copy latest bookmark backup to `bookmarks.orig.json`
npm run copy-firefox-bookmarks
# Flatten and beautify `bookmarks.orig.json` into `bookmarks.min.json` and `bookmarks.json`
npm run parse-bookmarks


Support this project and others by twolfson via gittip.

Support via Gittip


Copyright (c) 2013 Todd Wolfson

Licensed under the MIT license.