diff --git a/README.md b/README.md
index ced28c4..894b160 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# electron-fingerprints ![npm bundle size](https://img.shields.io/bundlephobia/minzip/electron-fingerprints) ![npm](https://img.shields.io/npm/v/electron-fingerprints) ![NPM](https://img.shields.io/npm/l/electron-fingerprints) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-blue)
+# [electron-fingerprints](https://www.npmjs.com/package/electron-fingerprints) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/electron-fingerprints) ![npm](https://img.shields.io/npm/v/electron-fingerprints) ![NPM](https://img.shields.io/npm/l/electron-fingerprints) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-blue)
 
 Generates fingerprints for electron version detection by downloading electron releases and generating checksums of the files contained in each release.
 
@@ -10,9 +10,24 @@ you get a better sense of what the application is running.
 
 Written as the backend for [`which-electon`][we].
 
+## install
+
+```shell
+npm install electron-fingerprints
+```
+
 ## usage
 
-This is just the raw data files, see [which-electron][we] for a usable package. The `lookup.json` file is published as the `electron-fingerprints` package on NPM.
+This is just the raw data files, see [which-electron][we] for a usable package. The `lookup.json` file is published as the `electron-fingerprints` package on NPM. Programmatic usage is still possible:
+
+```javascript
+const lookup = require('electron-fingerprints')
+// baf786083f482c1f035e50e105b5f7475af1e00b = sha1(ffmpeg.dll)
+lookup['win32-x64']['baf786083f482c1f035e50e105b5f7475af1e00b']
+// ["v1.4.3", "v1.4.4", "v1.4.5"]
+```
+
+You can sort or filter the returned versions if needed.
 
 ## supported releases
 
@@ -24,7 +39,11 @@ All Stable electron releases for the following architectures are fingerprinted:
 
 A list of release fingerprints is under the `hashes` directory.
 
-## LICENSE
+## todo
+
+- [ ] Add support for darwin-arm
+
+## license
 
 Released under WTFPL.