Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Setting and using [EN]

MjKey edited this page Dec 2, 2025 · 3 revisions

🎮 Setting Up and Using DonatonTimer

📥 Installation

Method 1: Installer (Recommended)

  1. Go to Releases
  2. Download DonatonTimer_v3.0.0_Setup.exe
  3. Run the installer and follow the instructions

⚙️ Configuring Donation Services

DonationAlerts

  1. Open SettingsServicesDonationAlerts
  2. Enable the service with the toggle
  3. Enter your token or paste the widget URL
  4. If needed, select socket server (socket/socket1-5)
  5. Click Save

Where to get the token:

DonatePay

  1. Open SettingsServicesDonatePay
  2. Enable the service
  3. Enter your API token
  4. Click Save

Where to get the token:

Donate.Stream

  1. Open SettingsServicesDonate.Stream
  2. Enable the service
  3. Enter widget URL
  4. Click Save

⏱️ Timer Configuration

Donation to Time Conversion

In timer settings, specify "Minutes per amount" — how much currency equals 1 hour of time.

Example: if you set 60, a 60₽ donation will add 1 hour to the timer.

Setting Initial Time

  1. Click Set Time button on the main screen
  2. Enter hours, minutes, and seconds
  3. Click Set

🖥️ OBS Setup

Adding Timer Overlay

  1. In OBS, add a Browser Source
  2. Set URL: http://localhost:8080/timer
  3. Set dimensions (recommended: 400x100)
  4. Apply custom CSS from the style generator

Setting Up Dock Panel

  1. In OBS, go to DocksCustom Browser Docks
  2. Add a new panel with URL: http://localhost:8080/mini
  3. Now you can control the timer directly from OBS

🎨 CSS Style Generator

  1. Open Style Generator from the navigation menu
  2. Choose a preset or customize manually:
    • Font (Google Fonts)
    • Text size
    • Colors (separate for hours, minutes, seconds)
    • Background and border
    • Animations
  3. Click Copy CSS
  4. Paste CSS into Browser Source settings in OBS

📱 Mobile Control

  1. Click the QR Code button on the main screen
  2. Scan the QR code with your phone
  3. The web control panel will open

⚠️ Phone and computer must be on the same Wi-Fi network!


🔊 Sound Notifications

  1. Open SettingsSounds
  2. Enable Sound Notification
  3. Place sound files (.mp3, .wav, .ogg) in the sound/ folder
  4. Click Refresh Sounds
  5. Enable Random Sound for variety

🔧 Default URLs

URL Purpose
http://localhost:8080/timer Timer overlay for OBS
http://localhost:8080/dashboard Web control panel
http://localhost:8080/mini Mini version for dock panel

🔌 Default Ports

Port Purpose
8080 HTTP server
4040 WebSocket

Ports can be changed in SettingsTimerPort Settings


📁 Data Location

Settings are saved in:

%APPDATA%\MerryJoyKeyStudio\DonatonTimer\data.json

Logs are written to logs.txt next to the application (if logging is enabled).


❓ Troubleshooting

Service won't connect

  • Verify the token is correct
  • Make sure the service is enabled
  • Check your internet connection

OBS doesn't show the timer

  • Make sure the application is running
  • Check the URL in Browser Source
  • Try refreshing the browser cache in OBS

Phone won't connect

  • Verify devices are on the same network
  • Try using IP address instead of localhost

💬 Support

If you have questions — create an Issue on GitHub

Clone this wiki locally

AltStyle によって変換されたページ (->オリジナル) /