Why integrate Murmelt?

Add a complete private messenger to your website or app with one iframe. Murmelt handles the client while users connect directly to the Nostr network.

  • No backend required

    No chat server, message database, or account API to build and operate.

  • End-to-end encrypted

    Messages and files are encrypted in the browser before they leave the device.

  • Ready to use

    Chats, groups, calls, profiles, and key management are already included.

  • Built on Nostr

    Users keep their identity and can choose the relays they connect to.

Integration guide

Choose your setup and follow the steps below.

  1. 1

    Embed Murmelt

    Add the Murmelt app route to your page. Camera and microphone permissions enable voice and video calls.

    HTML
    <iframe
      id="murmelt"
      src="https://app.murmelt.com"
      title="Private chat"
      allow="camera; microphone; clipboard-write"
      referrerpolicy="no-referrer"
      style="width:100%;height:min(760px,90vh);border:0;border-radius:16px"
    ></iframe>
  2. 2

    Configure the app

    Wait for the ready event, verify its origin, and send the optional app name, color scheme, interests, fast setup, and modules.

    JavaScript
    const frame = document.querySelector('#murmelt')
    const MURMELT_ORIGIN = 'https://app.murmelt.com'
    
    window.addEventListener('message', (event) => {
      if (!frame || event.origin !== MURMELT_ORIGIN) return
      if (event.source !== frame.contentWindow) return
      if (event.data?.type !== 'murmelt.brandingReady') return
    
      frame.contentWindow.postMessage(
        {
          type: 'murmelt.configure',
          version: 1,
          config: {
            appName: 'Your Community',
            colorScheme: 'pink',
            interests: ['#music'],
            fastSetup: true,
            modules: ['Chats', 'Random', 'Postings'],
          },
        },
        MURMELT_ORIGIN,
      )
    })
  3. 3

    Available options

    All fields are optional. Branding applies to the current iframe session; interests and fast setup apply only when a new profile is created, while modules control which parts of the app are available.

    appNamestring
    A visible name between 1 and 40 characters.
    colorScheme'purple' | 'pink'
    Use purple or pink.
    interestsstring[]
    Up to 10 hashtags with at most 32 characters each. Leading # characters are optional. Used for new profiles only.
    fastSetupboolean
    When true, profile creation shows only the required steps.
    modulesArray<'Chats' | 'Random' | 'Postings' | 'Reels' | 'UserList'>
    Modules available in the app. Accepted values: Chats, Random, Postings, Reels, and UserList.