Gift Counter
Count chosen gifts against targets with on-stream progress bars, an optional countdown, actions when a target is reached, and a contributor rank.
What the Gift Counter does
The Gift Counter only counts the gifts you pick. Each gift gets a target value, and the widget shows "current / target" with a progress bar. You can add a countdown for a timed challenge, and show a contributor rank at the bottom (total progress across all gifts plus the avatars of the top senders).
It fits gift goals and challenges such as "1,000 Roses" or "collect this gift within 10 minutes".
Where to find it: Extras → Gift Counter (in the Data group). Each live room has one Gift Counter.
Counter Settings
The Counter Settings card on the right has three parts, and changes save automatically.
Timer Settings
Choose Disabled, 10min, 30min or Custom (in seconds, at least 10). Countdown changes take effect the next time you start.
Display Settings
| Setting | What it does |
|---|---|
| Progress Display | Value + Percentage, Value Only or Percentage Only |
| After Target Reached | What happens once a gift reaches its target — see the table below |
| Show Gift Name | Whether the widget shows gift names |
| Show Gift Value | Whether the widget shows each gift's diamond price |
| Show Contributor Rank | Whether the widget shows the contributor rank at the bottom: total progress of all shown gifts, plus avatars of the top 3 viewers by gift value |
The After Target Reached options only affect the gift that reached its target:
| Option | Effect |
|---|---|
| Stop Counting | That gift stays at full progress and stops counting (marked Reached in the list); other gifts and the countdown carry on |
| Continue Counting | Keeps counting past the target |
| Reset Counter | After about 3 seconds that gift's count goes back to 0 and a new cycle starts; gifts sent during those 3 seconds count toward the new cycle |
| Increase Target by 1 Tier | Adds the initial target again, e.g. 100 → 200 → 300 |
| Double Target | Doubles the target, e.g. 100 → 200 → 400 |
| Hide | After about 3 seconds that gift is removed from the widget and stops counting |
While counting is in progress or paused, Timer Settings and After Target Reached can't be changed.
Gift Management
- Click + Add Gift to pick from the gift list; the same gift can't be added twice. New gifts start with a target of 100.
- Drag the handle on the left to reorder; the widget follows this order.
- Click a gift's icon to swap it for another gift; if that gift already has counts, you'll be asked to confirm.
- You can edit the gift name directly — this is the name shown on the widget.
- Click the "current / target" button to open Value Adjustment, where you can change the Current Value by hand (with +1, +10 and +100 shortcuts) and the Target Value.
- The eye button shows or hides that gift on the widget. Hidden gifts still count, but are left out of the contributor rank's total progress.
- The trash button deletes the gift. If you add a deleted gift back later, it comes back with its count and target from before.
During the stream
Gifts come from the live room, so click Start Collecting in the bottom bar first.
- Start: the status changes to In Progress and counting begins; if a countdown is set, it starts too. You need at least one gift in the list to start.
- Pause: counting and the countdown both stop; clicking Start again continues from the remaining time.
- When the countdown runs out: the status changes to Finished and counting stops. Clicking Start again restarts the countdown from the set duration; existing counts are kept.
- Reset: after you confirm, all gift counts and the contributor rank are cleared, targets return to their initial values, hidden gifts are shown again, and the status returns to Idle.
Gifts are only counted while the status is In Progress; combo gifts count each gift.
Adding it to OBS
With the Gift Counter page open, Widget Link: in the bottom bar shows the current room's link. Click Copy Link and add it as a browser source as described in Widgets and OBS; 700 × 600 or larger is recommended. Widget links contain an access credential — don't share them publicly.
The widget gets its data through our server, so OBS can run on any computer. Counting happens in the client, so keep the client running and collecting during the stream.
Notes
- Gifts that aren't in the list are not counted.
- Data is per live room; after switching rooms you see the other room's counter.