> For the complete documentation index, see [llms.txt](https://streamdotfun.gitbook.io/streamdotfun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://streamdotfun.gitbook.io/streamdotfun/configuration/donations-widget.md).

# Donations Widget

The Donation Widget lets you receive donations with a customizable transaction structure, triggering a Text-to-Speech message that plays live on your stream. Here's how you can configure each setting:

### 1. Configure Your Details

Connect your token deployer's wallet to verify you are the actual creator of the token.&#x20;

{% hint style="danger" %}
We only check your public wallet address and will never ask for your private keys or passwords
{% endhint %}

This step is required as a safety measure to prevent impersonation. It ensures that no one else can create a fake donation page using your token. By verifying ownership you protect your token and your community from misuse.

<div align="center"><figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FZmEMuA0M1A8F2FN6s6J7%2FScreenshot%202025-07-24%20at%2012.34.08.png?alt=media&amp;token=8ed78b44-8138-4bec-80e1-6e4911b731a6" alt=""><figcaption></figcaption></figure></div>

The following information will be fetched automatically using your wallet's public address.

If you've deployed multiple tokens with the same wallet, make sure to choose the correct one from the **"Select Your Token"** dropdown.

Set your **Minimum Donation Amount** in SOL. This is the lowest amount users will be able to send.\
The minimum value allowed is **0.01 SOL**.

The **Custom Donation URL Name** will appear in your donation link.\
Viewers will send donations through the link `streamdotfun.com/donate-me/CUSTOMNAME`\
This field lets you set the custom name that connects directly to your token.

{% hint style="info" %}
Make sure to hit "Save Settings" after filling all the fields out
{% endhint %}

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FOFKuCcD3jj4TPoKvHKxr%2FScreenshot%202025-07-24%20at%2012.38.35.png?alt=media&amp;token=29d8422f-60d9-4112-91b1-9ba3c2237c84" alt=""><figcaption></figcaption></figure>

### 2. Choose Color and Style

In this section, you can customise the **look** of your widget that will pop up on stream once the donation is received.

There are three style options to choose from:

* **Light**
* **Dark**
* **Bright**

Each style changes the overall appearance of the widget.

You can also enable the **"Add background opacity"** option, which applies a semi-transparent background behind the widget. This helps the widget stand out on complex or bright stream layouts.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FU9cHo0CSbIVgviJwyKr4%2FScreenshot%202025-07-10%20at%2001.14.25.png?alt=media&amp;token=6ecb84dc-38ea-4539-99fd-be517cc9e0cf" alt=""><figcaption></figcaption></figure>

### 3. Transaction Structure

Current donation fee structure:

* 80% goes directly to the streamer’s wallet
* 10% is used to buy and burn the streamer’s token
* 10% is used to buy and burn the $STREAM token

We’re working on an upcoming update that will let streamers customise the split between their wallet share and their token’s buy-and-burn amount.

The 10% fee allocated to $STREAM will remain fixed as a service fee.

All on-chain activity is processed through and can be verified via the **streamdonations.sol** wallet.

### 4. Donation Widget URL

This section provides the **Widget URL**, which you’ll use to display your Donation Widget in your streaming software (like OBS, Streamlabs, or XSplit).&#x20;

{% hint style="info" %}
To ensure the Text-to-Speech messages are heard on stream, enable “Control audio via OBS” and set the widget’s audio to “Monitor and Output” in your OBS settings.
{% endhint %}

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FgEJSISVkhGEqQfWDwW7U%2FScreenshot%202025-07-10%20at%2001.18.55.png?alt=media&amp;token=767de13d-0464-4ec2-9f56-6c57a3822418" alt="" width="361"><figcaption></figcaption></figure>

### 5. Donate Me Page URL

**This section provides a unique URL that opens your personal "Donate Me" page, where viewers can send donations directly to your stream.**

Share this link with your community to make it easy for them to interact.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FNLRA3HSpw0XE9g480uq4%2FScreenshot%202025-07-10%20at%2001.19.50.png?alt=media&amp;token=47dafbb2-09d9-41f3-8252-7996a0baa07c" alt="" width="365"><figcaption></figcaption></figure>

Once you’re ready, move on to the next part for the integration guide.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Integration with OBS</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FdTj0HIeBHqYOpRwJhhQd%2Fobs.png?alt=media&amp;token=d8d3e0cb-cf27-4c98-b2d9-cd03dd0f72fb">obs.png</a></td><td><a href="/streamdotfun/integration/obs.md">OBS</a></td></tr><tr><td>Integration with StreamLabs</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FKrC1CBLLdMVeyw6TKwdf%2FStreamlabs.png?alt=media&amp;token=0319effa-88c9-40f7-83d4-10e69a78c6bb">Streamlabs.png</a></td><td><a href="/streamdotfun/integration/streamlabs.md">StreamLabs</a></td></tr><tr><td>Integration with XSplit</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2F2pg7q3VsH96ulbm4M3IQ%2FXsplit.png?alt=media&amp;token=dc849d05-daba-40e4-98d2-ec91d7bb13f8">Xsplit.png</a></td><td><a href="/streamdotfun/integration/xsplit.md">XSplit</a></td></tr></tbody></table>
