Skip to content

โšก See Amazon prices in sats! FOSS Chrome extension that converts USD to Bitcoin satoshis instantly ๐Ÿ›๏ธ

License

Notifications You must be signed in to change notification settings

TristanBietsch/Satsify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

1ec4316 ยท Mar 11, 2025

History

11 Commits
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025
Mar 11, 2025

Repository files navigation

Satsify Demo

Satsify Logo Satsify Chrome Extension for Amazon โšก๐Ÿ’ฐ

License: MIT Version PRs Welcome Bitcoin

A Chrome extension that converts Amazon product prices from USD to satoshis (sats). ๐Ÿ”„

Brought to you by Nummus Bitcoin

โœจ Features

  • ๐Ÿ›๏ธ Amazon Integration: Seamlessly converts prices on Amazon product pages
  • ๐Ÿ” Smart Detection: Accurately detects Amazon price formats and components
  • โšก Real-Time Conversion: Converts USD to satoshis based on current Bitcoin exchange rates
  • ๐Ÿ’ป Minimal UI: Simple, user-friendly interface with only essential controls
  • ๐Ÿ“Š Live Price Updates: Fetches current Bitcoin prices from CoinGecko (with Coinbase as backup)
  • ๐Ÿ’ญ Tooltip Display: Hover over converted amounts to see original USD values
  • ๐Ÿ”„ Toggle Conversion: Enable or disable automatic conversion with a simple switch
  • ๐Ÿ–ฑ๏ธ Manual Conversion: "Convert Now" button for on-demand conversion

๐Ÿš€ Installation

  1. ๐Ÿ“ฅ Download or clone this repository
  2. ๐ŸŒ Open Chrome and navigate to chrome://extensions/
  3. ๐Ÿ‘จโ€๐Ÿ’ป Enable "Developer mode" (toggle in the top-right corner)
  4. ๐Ÿ“ Click "Load unpacked" and select the satsify directory
  5. โœ… The extension should now be installed and visible in your Chrome toolbar

๐Ÿ“– Usage

  1. ๐ŸŒ Visit any Amazon product page or search results
  2. ๐Ÿ–ฑ๏ธ Click the Satsify icon in your Chrome toolbar to open the popup
  3. ๐Ÿ”„ Toggle "Auto-Convert USD to Sats" to enable automatic conversion on Amazon
  4. ๐Ÿ‘† Use the "Convert Now" button to manually convert prices on the current page
  5. ๐Ÿ‘€ Hover over converted amounts to see the original USD value

โš™๏ธ How It Works

  • ๐Ÿ” Satsify detects prices on Amazon pages using specialized selectors
  • ๐ŸŽฏ It handles various Amazon price formats including:
    • Regular product prices
    • Deal prices
    • Price ranges
    • "List Price" and "Sale Price"
  • ๐Ÿงฎ Converts prices to satoshis using the formula: sats = usd_amount * 100,000,000 / btc_price_in_usd
  • ๐Ÿ”„ Replaces the original USD text with the satoshi amount, formatted for readability
  • ๐Ÿ”’ Preserves Amazon's page functionality while providing Bitcoin-native prices

๐Ÿ”’ Privacy & Permissions

Satsify requires minimal permissions:

  • activeTab: To detect and convert prices on Amazon pages
  • storage: To save your preferences and Bitcoin price data
  • *://*.amazon.com/*: To operate on Amazon domains

The extension doesn't collect any personal data or browsing history.

๐Ÿ‘จโ€๐Ÿ’ป Development

Project Structure

satsify/
โ”œโ”€โ”€ manifest.json        # Extension configuration
โ”œโ”€โ”€ popup/
โ”‚   โ”œโ”€โ”€ popup.html       # Simple popup interface
โ”‚   โ”œโ”€โ”€ popup.css        # Styling for popup
โ”‚   โ””โ”€โ”€ popup.js         # Popup functionality
โ”œโ”€โ”€ scripts/
โ”‚   โ”œโ”€โ”€ content.js       # Main script for Amazon price conversion
โ”‚   โ””โ”€โ”€ bitcoin-api.js   # Functions for fetching BTC price data
โ”œโ”€โ”€ background.js        # Background script for handling events
โ””โ”€โ”€ icons/
    โ”œโ”€โ”€ icon16.png       # Extension icons
    โ”œโ”€โ”€ icon48.png
    โ””โ”€โ”€ icon128.png

๐Ÿ“‹ Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contributions welcome

๐Ÿ“œ License

This project is available under the MIT License.

License: MIT

โšก Nummus: The Bitcoin Card

Hold Bitcoin & Spend USD with Nummus, the credit card that turns everyday purchases into sats.

Join Waitlist

About

โšก See Amazon prices in sats! FOSS Chrome extension that converts USD to Bitcoin satoshis instantly ๐Ÿ›๏ธ

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published