๐Ÿผ PaciTime Docs

What everything on the dashboard actually does. If you just want to get set up, start with Getting Started.

๐Ÿš€ Getting Started

The short version, if you don't want to read the rest.

  1. Log in with Twitch โ€” this creates your dashboard, timer, and a private overlay link automatically.
  2. Create a Twitch Channel Points reward with a title that exactly matches your Overlay Title setting (default Paci Time), case doesn't matter.
  3. Copy your Overlay URL from the top of the dashboard and add it as a Browser Source in OBS โ€” see Adding it to OBS.
  4. Redeem the reward on stream (or hit the +60s Test button on the dashboard) to see it work.
  5. Tune the numbers under Timer Rules and style it under Overlay Appearance to taste.

โš™๏ธ How the timer works

The mental model underneath all the settings below.

PaciTime is one countdown timer per channel. Various Twitch events โ€” a channel points redemption, bits, subs, resubs, gift subs, raids โ€” each add a configurable number of seconds to it. While seconds remain, the timer counts down and the overlay shows it; at zero, it stops and hides itself. An admin/mod can also add, subtract, pause, resume, or reset the timer manually from the dashboard.

Only the Channel Points redemption is tied to a specific reward name. Bits, subs, resubs, gift subs, and raids are detected automatically via Twitch EventSub โ€” nothing to configure to "turn them on" besides setting their seconds above 0.

โฑ๏ธ Timer Rules settings

Everything under the "Timer Rules" card on your dashboard.

Base Paci Seconds default 300
How many seconds one redemption of your Channel Points reward adds to the timer.
Timer Goal default 0 = off
Optional target in seconds. When set, the overlay shows a progress bar and plays a small celebration ring animation the moment the timer reaches or passes it. Doesn't cap or stop the timer โ€” it just marks the milestone.
Bits Per Increment / Bits Add Seconds
For every Bits Per Increment bits cheered in one go, add Bits Add Seconds. E.g. 100 / 30 means every 100 bits cheered adds 30s โ€” a 250-bit cheer adds 60s (2 full increments; remainders don't carry over between separate cheers).
Sub Tier 1 / 2 / 3 Seconds
Seconds added for a brand-new subscription at each tier (Tier 1/2/3 = the $4.99/$9.99/$24.99 tiers).
Resub Tier 1 / 2 / 3 Seconds
Seconds added when an existing sub renews or continues their streak. Twitch fires a separate event for this from a brand-new sub, so it's a separate set of numbers โ€” set these to 0 if you only want to reward new subs, not renewals.
Gift Sub Seconds (each)
Seconds added per individual gifted sub. A 5-pack gift bomb adds 5ร— this amount in one shot.
Raid Base Seconds / Raid Seconds Per Viewer default 0 / 0
When someone raids your channel: Raid Base Seconds is a flat bonus, and Raid Seconds Per Viewer multiplies by however many viewers came with the raid. Both default to 0, so raids add nothing until you set at least one of them.
Max Timer Seconds (cap)
The timer can never exceed this, no matter how many things add to it at once. Think of it as a safety ceiling for a chaotic bits/sub train.
Allow stacking while running
If on, a new add (redemption, bits, sub, etc.) while the timer is already counting down extends it further. If off, those events are ignored while the timer is already running โ€” only useful once it's back at zero.
Require Paci to start (bits/subs extend only)
If on, bits/subs/resubs/gift subs/raids can only add time to an already-running timer โ€” they can't start one from zero. Only the Channel Points redemption can start the timer fresh. Useful if you want the redeem to be the deliberate "kick it off" action and everything else to just pile on top.
Allow Shared Paci Time
When you're in a Twitch Shared Chat session (a multi-streamer collab), this lets the other linked streamers' redemptions/bits/subs also add to your timer, and vice versa โ€” so a collab group can run one shared timer instead of everyone's own separate one. Off by default means your timer only reacts to your own channel's events even during a collab.

๐ŸŽจ Overlay Appearance settings

Everything under the "Overlay Appearance" card โ€” how the overlay actually looks on stream.

Overlay Title
The text the overlay displays (uppercased automatically โ€” "Paci Time" becomes "PACI TIME" on stream, plus a suffix like "BOOST" when something adds time).
This also has to match your Channel Points reward name (case-insensitive) โ€” it's the one setting that does double duty. If you rename it here, rename your Twitch reward to match too, or redemptions will stop starting the timer.
Background Color / Opacity
The pill/box color behind the text, and how see-through it is (0 = fully transparent, 100 = fully solid).
Text Color
Color of the title, timer digits, and sub-label text.
Accent Color
Used for the goal-progress bar fill and the celebration ring animation when you hit your Timer Goal.
Font
System (clean default), Rounded, Mono, or Serif. All are safe local font stacks โ€” nothing loads over the network, so it can't flicker or fail to load in OBS.
Corner Style
Pill (fully rounded, the default look), Rounded (soft corners), or Square (sharp corners). You can also drag to any custom radius if you want something in between.
Icon (emoji)
Replaces the ๐Ÿผ with any emoji or short symbol you want.
Background Image URL
Optional custom image behind the overlay text โ€” must start with https:// (plain http:// links are rejected for security). Your Background Color becomes a tint layer over the image, so lower its opacity to let more of the image show through.
Background Image Blur
Softens the background image so overlay text stays readable on top of a busy picture. Only affects the image, never the text.

Changes here don't go live until you hit Save Overlay Theme โ€” the preview above the button updates instantly as you edit, but that's local to your dashboard only.

๐Ÿ‘ฅ Team / roles / invites

Who can do what if you bring on mods to help run this.

RoleCan do
viewerSee the dashboard and live timer state. Read-only โ€” can't change anything.
modEverything viewer can, plus pause/resume/reset/add/subtract the timer.
adminEverything mod can, plus edit Timer Rules and Overlay Appearance, and invite more team members.
ownerYou. Full access, same as admin, tied to the actual Twitch account the timer belongs to.

Invite links are created from the Team card, expire after 24 hours, and are single-use. Someone opening the link gets a page confirming which channel and role they're accepting before continuing through Twitch login.

๐Ÿ› ๏ธ Live State / admin controls

The buttons under "Live State" on the dashboard, for mods and up.

Reset Timer
Instantly zeroes the timer and stops it.
+60s Test / +300s Test
Manually adds time โ€” handy for testing your overlay without waiting for a real redemption.
-60s / -300s
Manually removes time, floored at 0 (won't go negative). Useful for correcting an accidental over-add.
Pause / Resume
Freezes the countdown in place without losing the remaining time, and un-freezes it.
Force Refresh Overlays
Tells any open overlay browser sources to reload immediately โ€” useful right after changing Overlay Appearance if you don't want to wait or manually refresh OBS.

๐Ÿ“‹ Team Activity Log

Admin/Owner only โ€” a record of who changed what on your dashboard.

Separate from the "Recent Activity" feed above (which shows Twitch events like redemptions and bits), this log tracks account-level changes: updated Timer Rules, updated Overlay Appearance, invites created, team roles changed, and manual timer adjustments โ€” each tagged with who did it and when. Useful once you've handed dashboard access to mods, so you know what changed without having to ask.

๐Ÿ’œ Plans

Free covers everything else on this page. Supporter adds a bit more on top.

Free
Everything documented above โ€” timer, overlay, one active theme, team invites, activity logs. No feature on this page is held back on Free.
Supporter
Adds saved overlay presets โ€” save your current look under a name (e.g. "Chill Stream", "Event Mode") and switch between up to 5 saved presets instantly from the Overlay Appearance card, instead of re-entering every color/font/icon setting by hand each time you want a different look. Switching presets updates your live overlay immediately.

Payment isn't self-serve yet โ€” Supporter is currently granted manually. See the Plan card on your dashboard to get in touch.

๐Ÿ“บ Adding it to OBS

Or Streamlabs, or any other software that supports Browser Sources โ€” the steps are the same.

  1. Copy your Overlay URL from the top of the dashboard โ€” it's private, tied to a secret key, so don't share it publicly.
  2. In OBS: Sources โ†’ + โ†’ Browser Source, paste the URL in.
  3. Set the size to roughly 500 ร— 120 as a starting point โ€” the overlay sizes itself to its content, so this is just canvas room.
  4. Check "Shutdown source when not visible" off and transparency on if your software has that option โ€” the overlay background is already handled by your Overlay Appearance settings.
  5. The overlay stays hidden automatically whenever the timer is at 0, so it's safe to leave the source active on every scene.
โ† Back to Dashboard ยท Terms ยท Privacy ยท Home