Nitty Music Social Management
Nitty Music Social Management

Configuration

Browser extension

Configure the Nitty Music Social browser extension on a self-hosted instance

Platforms with no public posting API, Skool being the current one, connect through the Nitty Music Social browser extension: it reads your existing session cookies for that platform and passes them to your backend, where they are stored encrypted and refreshed every 24 hours.

Connecting a channel this way is covered in Connect a channel. This page is the instance-side configuration: the extension ID, and building the extension yourself.

Using cookies to interact with platforms may violate their terms of service. Use this feature at your own risk.

Installation

1

Install the Extension

Build the browser extension from source:

cd apps/extension
pnpm build

Then load the apps/extension/dist folder as an unpacked extension in Chrome:

  1. Navigate to chrome://extensions/
  2. Enable Developer mode (top right toggle)
  3. Click Load unpacked and select the dist folder
2

Get the Extension ID

After installing the extension, you need its Extension ID:

  1. Go to chrome://extensions/ in Chrome
  2. Find the Nitty Music Social extension
  3. Copy the ID shown under the extension name (e.g., cidhffagahknaeodkplfbcpfeielnkjl)

If you installed from the Chrome Web Store, the ID is: cidhffagahknaeodkplfbcpfeielnkjl

3

Configure the Environment Variable

Add the extension ID to your Nitty Music Social environment variables:

EXTENSION_ID="cidhffagahknaeodkplfbcpfeielnkjl"

Restart Nitty Music Social after setting this variable.

Supported Platforms

The following platforms use the Chrome Extension for authentication:

Skool

Post to Skool communities

Self-Hosted Considerations

If you are self-hosting Nitty Music Social on a domain other than localhost or social.nittymusic.com, you need to build a custom extension with your domain in the externally_connectable manifest field.

Edit apps/extension/manifest.json and add your domain:

{
  "externally_connectable": {
    "matches": [
      "http://localhost/*",
      "https://localhost/*",
      "https://social.nittymusic.com/*",
      "https://your-domain.com/*"
    ]
  }
}

Then rebuild the extension and load it as an unpacked extension in Chrome.

Troubleshooting

  • “Extension not found”: Make sure the EXTENSION_ID environment variable is set and Nitty Music Social has been restarted.
  • “Extension not reachable”: The extension may be disabled. Check chrome://extensions/ and make sure Nitty Music Social is enabled.
  • “Could not get cookies”: You must be logged in to the platform in the same Chrome browser where the extension is installed.
  • Cookies expire: The extension automatically refreshes cookies every 24 hours. If a connection drops, try reconnecting the channel.