BROWSER EXTENSION

Profile Notes

v0.2.0 · Testing release

Remember why you blocked, unfollowed, or liked someone. Private notes for X/Twitter, Bluesky, and Reddit, saved in your browser.

01 / FIREFOX

Firefox

Desktop Firefox 140+, including Windows.

Download Firefox XPI

Unsigned testing build. Use “Load Temporary Add-on”; opening the file as a normal install will fail.

  1. Save the XPI. If Firefox tries to install it, right-click the download link and choose Save Link As…
  2. Open about:debugging#/runtime/this-firefox.
  3. Choose Load Temporary Add-on and select the XPI.

Firefox removes temporary add-ons when it closes. Export notes before closing. Permanent installation and automatic updates await Mozilla signing.

02 / CHROME

Chrome

Desktop Chrome on Windows, macOS, and Linux.

Download Chrome ZIP
  1. Extract the ZIP into a permanent folder.
  2. Open chrome://extensions and turn on Developer mode.
  3. Choose Load unpacked and select the folder containing manifest.json.

Keep the folder in place. After replacing its files with a new release, click Reload on the extension.

Write your first note

Visit a supported profile and open Profile Notes from your browser’s extensions menu. Write a note, choose Blocked, Unfollowed, Cool, or Note, then save. Drafts save as you type; saved notes are searchable.

Notes appear in the extension popup. They follow profile URLs, so renamed or reassigned handles need manual review. Notes do not sync between browsers. Backup export is available; importing backups is not yet supported.

Install or update files from the terminal

Requires Python 3. Download the updater, inspect it if you wish, then run it. Run the same commands again for future releases. It verifies the download’s SHA-256 checksum and updates a dedicated folder; you still load or reload the extension in your browser.

Windows · PowerShell

curl.exe --fail --location --connect-timeout 10 --max-time 30 https://profile-notes.multi.fairystack.com/install.py -o profile-notes-install.py
py -3 profile-notes-install.py --browser firefox

macOS / Linux · Terminal

curl --fail --location --connect-timeout 10 --max-time 30 https://profile-notes.multi.fairystack.com/install.py -o profile-notes-install.py
python3 profile-notes-install.py --browser firefox

Use --browser chrome for Chrome. Files go into ProfileNotes/firefox or ProfileNotes/chrome in your home folder. The updater neither installs Python nor changes browser settings. Firefox signing restrictions still apply.

Privacy and release details

The extension stores notes locally and sends no notes or browsing history to a server. It requests storage and access to the current tab when you open it. Notes are not encrypted against someone using your browser profile.

This download page uses Observatory for visit counts and performance measurements. That tracking is not included in either extension.

Automated editor and packaging tests pass; Mozilla’s validator reports no errors or warnings. Live Firefox and Chrome testing remains pending.

Release metadata · Checksums · Firefox installation help