# Splirate

![Splirate logo](./logo.png)

Allows you to download Splice samples from the browser by decrypting the preview audio.

I didn't read or write the code.

WTFPL licensed.

## Screenshots

<p align="center">
  <img src="./screenshot-history.png" alt="Splirate history view" />
  <br />
  <em>History view showing captured sample cards with pack, key/BPM, tags, and quick download actions.</em>
</p>

<p align="center">
  <img src="./screenshot-player.png" alt="Splirate on Splice playbar" />
  <br />
  <em>Inline Splirate controls inside the Splice playbar for current-sample download and history access.</em>
</p>

<p align="center">
  <img src="./screenshot-popup.png" alt="Splirate popup view" />
  <br />
  <em>Popup view for active-tab captures with compact metadata and one-click download icon.</em>
</p>

## Load in Firefox (Temporary Add-on)

1. Open `about:debugging#/runtime/this-firefox`
2. Click **Load Temporary Add-on...**
3. Select this extension's `manifest.json`
4. Visit `https://splice.com/sounds/search/samples`

## Build Firefox Package

1. From the project root, run either:
   - `npm run build`
   - `npm run build:xpi`
   - `bash scripts/build-firefox.sh`
2. The packaged extension is created in:
   - `dist/splirate-firefox-v<version>.xpi`

## Install Locally in Firefox

1. Build the XPI: `npm run build:xpi`
2. Open Firefox and go to `about:debugging#/runtime/this-firefox`
3. Click **Load Temporary Add-on...**
4. Select `dist/splirate-firefox-v<version>.xpi`

Note: on standard Firefox, unsigned extensions are temporary via `about:debugging` and are removed on restart.

## Signed Build Download

- Direct signed XPI: [splirate-signed.xpi](https://git.zetaphor.com/zetaphor/splirate/releases/download/signed/splirate-signed.xpi)
- Releases page: [Splirate Releases](https://git.zetaphor.com/zetaphor/splirate/releases)

## Persistent Install (Private / Unlisted Signing)

Use Mozilla's unlisted signing to get a persistent signed XPI without public listing.

1. Create AMO API credentials:
   - [Firefox Add-on Developer Hub](https://addons.mozilla.org/developers/)
2. Export credentials in your shell:
   - `export AMO_JWT_ISSUER="your-issuer"`
   - `export AMO_JWT_SECRET="your-secret"`
3. Run signing:
   - `npm run sign`
4. Install the signed `.xpi` from:
   - `dist/signed/`
   - Firefox: `about:addons` → gear icon → **Install Add-on From File...**