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
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
Configure the app
Wait for the ready event, verify its origin, and send the optional app name, color scheme, interests, fast setup, and modules.
JavaScriptconst 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
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.