Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

arcataroger/instant-ink-usage

Open more actions menu

Repository files navigation

Instant Ink Usage 🖨️📊

A free bookmarklet to check your HP Instant Ink usage history — see how many pages you've printed each month and each year.

Ever wonder how many pages you've actually printed on your HP Instant Ink plan? This little tool shows your whole printing history — every month and every year — as a clean, friendly chart.

It's a bookmarklet: a bookmark you click that adds a one-time button to your browser. There's nothing to install, no account to create, and nothing runs on the internet — it works right inside your own browser, using the HP login you already have.

Example of the usage report


✅ How to use it

👉 The easiest way: open the install page and follow the three steps. Or do it here:

1. Add the button to your browser (one time)

Open the install page and drag the pink “📊 Instant Ink Usage” button up onto your bookmarks bar.

Don't see a bookmarks bar? In most browsers press Ctrl/+Shift+B to show it. Prefer to do it by hand? Make a new bookmark and paste the contents of build/bookmarklet.txt as the address.

2. Go to your HP Instant Ink page and sign in

Visit portal.hpsmart.com → Print and Payment History and log in to your HP account like you normally would. This is HP's own website.

3. Click the bookmark

Once you're signed in and looking at that page, click the Instant Ink Usage bookmark you just added. Your report pops up right on the page, showing:

  • Pages and cost, split into your base plan vs. overage — using HP's own per-cycle charges
  • A year-by-year summary plus your average pages and spend per year
  • A breakdown of every billing cycle, oldest to newest
  • Buttons to copy the report or download it as a spreadsheet (CSV) or a data file (JSON)

To close it, press Esc or click the ✕.


🔍 How it works (behind the scenes)

Totally fair to want to know what it's doing before you click it. Here's the plain-English version:

  • It runs only in your browser. Clicking the bookmark just runs a small script on the HP page you already have open. Nothing is installed, and no outside website or server is involved.
  • It uses the login you already have. You sign in to HP yourself, in the normal way. The tool never sees, asks for, or stores your password — it simply piggybacks on the session your browser already created.
  • It asks HP for your history, one billing cycle at a time. Your HP account keeps a record of each monthly billing cycle. The tool politely requests each cycle's pages and charges — the exact same numbers HP's own dashboard shows you — and collects them all, going back as far as your account goes.
  • It does the math locally. It groups your billing cycles by year, splits base vs. overage pages and cost, and works out your yearly totals and averages — using HP's own per-cycle figures, so the dollars match your real bills.
  • Nothing leaves your computer. Your usage data isn't uploaded anywhere. The only thing the tool talks to is HP's own website — the same one you're already looking at. If you download the CSV/JSON, those files save straight to your computer.

And because it's open source, you can read every line yourself in bookmarklet.src.js before trusting it.


🛠️ For developers: build it yourself

The bookmarklet is generated from bookmarklet.src.js (plain JavaScript, no dependencies, needs Node 18+):

npm run build

That writes build/bookmarklet.txt (the bookmark code) and docs/index.html (the install page, also served via GitHub Pages). preview.html renders the report against fake data so you can tweak the design without a real account.

📄 License

CC0 1.0 Universal — public domain. Do anything you like with it, no permission or credit needed.

About

A free bookmarklet that shows your full HP Instant Ink history — pages and cost, split into base plan vs. overage, per billing cycle and year. Runs in your browser; never sees your password, nothing uploaded.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.