Setting and using [EN]

🎮 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 Settings → Services → DonationAlerts
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:

• Go to DonationAlerts
• Copy the token from widget settings

DonatePay

1. Open Settings → Services → DonatePay
2. Enable the service
3. Enter your API token
4. Click Save

Where to get the token:

• Go to DonatePay dashboard
• Copy the API key

Donate.Stream

1. Open Settings → Services → Donate.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 Docks → Custom 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 Settings → Sounds
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 Settings → Timer → Port 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