v1.0.0
LeonXLAB Download
Dokumentasi Resmi

TSubathon
Docs & Reference

Integrasikan koin TikTok Live dan donasi Saweria ke timer subathon kamu secara real-time. Lengkap dengan overlay OBS, leaderboard, ending credits, dan webhook otomatis via ngrok.

Download TSubathon Baca Panduan Setup
Windows x64 Auto-update Gratis Selamanya
 Download

Download & Install

Unduh installer terbaru dan jalankan di Windows. Setup wizard akan otomatis terbuka saat pertama kali dijalankan.

TSubathon-Setup-1.0.0.exe Windows x64 — NSIS Installer Versi terbaru • Auto-update aktif setelah install
Download
Jika Windows SmartScreen muncul, klik "More info" lalu "Run anyway". App belum memiliki code signing certificate.
1
Download installer

Klik tombol Download di atas. File TSubathon-Setup-1.0.0.exe akan tersimpan di folder Downloads kamu.

2
Jalankan installer

Double-click file installer. Pilih direktori instalasi, lalu klik Install. Shortcut akan dibuat di Desktop dan Start Menu.

3
Setup awal

Pertama kali buka app, Setup Wizard akan tampil otomatis. Isi Admin Password, Ngrok Token, dan username TikTok kamu.

4
Mulai streaming!

Admin Panel akan terbuka di browser setelah setup selesai. Tambahkan overlay URL ke OBS, lalu mulai TikTok Live.

 Requirements

Requirements

Pastikan semua kebutuhan ini terpenuhi sebelum install.

Windows 10 / 11 x64 OS minimum Windows 10 64-bit. Windows 11 direkomendasikan.
Akun Ngrok (Gratis) Daftar gratis di ngrok.com untuk mendapatkan Auth Token.
Akun TikTok Live Minimal 1.000 followers untuk akses fitur TikTok Live.
Koneksi Internet Stabil Diperlukan untuk TikTok Live connector dan ngrok tunnel.
Port 9362 harus tersedia dan tidak dipakai aplikasi lain. Bisa diganti di setup jika konflik.
 Konfigurasi

Setup Wizard

Setup Wizard otomatis terbuka saat pertama kali app dijalankan. Isi 3 langkah berikut.

1
Admin Password & Port

Buat password minimal 6 karakter untuk login ke Admin Panel. Port default 9362 bisa diganti jika dibutuhkan.

2
Ngrok & TikTok

Masukkan Ngrok Auth Token dari dashboard ngrok.com. Username TikTok opsional — bisa diisi di Admin Panel nanti.

3
Konfirmasi & Launch

Review semua pengaturan, klik Mulai Aplikasi. Server dan ngrok tunnel akan otomatis berjalan.

Setup bisa diulang kapan saja melalui menu tray system Klik kanan icon TSubathon → Setup.
 Konfigurasi

Ngrok Setup

Ngrok membuat tunnel dari internet ke server lokal kamu, sehingga Saweria bisa mengirim notifikasi donasi.

1
Daftar akun gratis

Buka ngrok.com dan buat akun gratis. Tidak perlu kartu kredit.

2
Ambil Auth Token

Masuk ke Dashboard → Getting Started → Your Authtoken. Copy token yang terlihat.

3
Paste di Setup Wizard

Tempel token di field Ngrok Auth Token pada langkah 2 Setup Wizard. App akan otomatis mengkonfigurasi ngrok.

Domain tetap (opsional): Akun ngrok berbayar mendapat static domain. Masukkan di field "Ngrok Domain Tetap" agar URL Saweria webhook tidak berubah setiap restart.
 Konfigurasi

Saweria Webhook

Hubungkan Saweria agar setiap donasi otomatis menambah waktu timer subathon.

1
Buka Admin Panel

Setelah app berjalan, Admin Panel terbuka otomatis. Lihat bagian Ngrok URL — copy URL tersebut (format: https://xxxx.ngrok-free.app).

2
Atur Webhook di Saweria

Login ke Saweria → Pengaturan → Alert & Overlay → Webhook. Masukkan URL:

Webhook URL
https://xxxx.ngrok-free.app/webhook/saweria
3
Token Rahasia (opsional)

Jika kamu mengaktifkan token di Saweria, masukkan token yang sama di field Saweria Webhook Token pada Setup Wizard.

 Konfigurasi

TikTok Live

TSubathon auto-connect ke TikTok Live kamu saat app dibuka.

1
Isi Username TikTok

Di Setup Wizard atau Admin Panel, masukkan username TikTok tanpa karakter @. Contoh: leonxlab.

2
Mulai TikTok Live terlebih dahulu

Pastikan kamu sudah live di TikTok sebelum menekan tombol Connect di Admin Panel. TSubathon perlu live aktif untuk bisa terhubung.

3
Monitor status koneksi

Status koneksi terlihat di Admin Panel. Jika putus, klik Reconnect atau restart app.

TikTok dapat sewaktu-waktu memblokir koneksi unofficial. Jika koneksi terus putus, coba ganti jaringan atau gunakan VPN.
 Referensi

Overlay URLs

Tambahkan URL berikut sebagai Browser Source di OBS atau TikTok Live Studio. Ganti PORT dengan port yang kamu gunakan (default: 9362).

Timer Overlay http://localhost:PORT/overlay.html Timer countdown utama subathon. Rekomendasi ukuran: 400x150px.
Leaderboard http://localhost:PORT/leaderboard.html Top supporter real-time. Rekomendasi ukuran: 320x480px.
Ending Credits http://localhost:PORT/ending.html Running text semua supporter saat subathon berakhir. Full screen.
Admin Panel http://localhost:PORT/admin.html Dashboard kontrol utama. Buka di browser biasa, bukan OBS.
Saat live di platform lain (mobile), gunakan URL ngrok sebagai gantinya: https://xxxx.ngrok-free.app/overlay.html
 Referensi

API Reference

Semua endpoint REST tersedia di base URL http://localhost:PORT. Endpoint admin membutuhkan JWT token di header.

Auth Header
// Semua request ke /api/admin/* wajib sertakan: Authorization: Bearer <jwt_token> // Dapatkan token via POST /api/admin/login
GET /health Cek status server
Endpoint untuk mengecek apakah server berjalan. Tidak butuh autentikasi. Response: {"status":"ok"}
POST /api/admin/login Login admin
Body: {"password":"your_password"}
Response: {"token":"eyJ..."}
Token berlaku selama sesi aktif.
GET /api/admin/state Status timer & subathon
Mengembalikan state lengkap: timer aktif, sisa waktu, status koneksi TikTok, dan URL ngrok saat ini. Butuh auth token.
POST /api/admin/timer/start Mulai timer
Mulai timer subathon. Body: {"duration":3600} (durasi dalam detik). Butuh auth token.
POST /api/admin/timer/stop Stop timer
Hentikan timer subathon. Butuh auth token. Semua overlay akan menampilkan state berhenti.
POST /webhook/saweria Saweria donation webhook
Endpoint yang dipanggil oleh Saweria saat ada donasi masuk. Dikirim otomatis oleh Saweria — tidak perlu dipanggil manual. Jika token diatur, verifikasi via header X-Saweria-Token.
WS ws://localhost:PORT Socket.IO real-time
Koneksi Socket.IO untuk update real-time ke overlay. Events yang di-emit: timer:update, leaderboard:update, donation:new, tiktok:status.
 Bantuan

Troubleshooting

Masalah umum dan cara mengatasinya.

Setup tidak muncul, langsung ke Admin Panel

Artinya konfigurasi sudah tersimpan dari sesi sebelumnya. Klik kanan icon di system tray → Setup untuk membuka kembali wizard.

Server gagal start / port sudah terpakai

Ganti port di Setup Wizard ke nomor lain (misal: 9363). Atau tutup aplikasi lain yang memakai port tersebut via Task Manager.

Ngrok URL tidak muncul di Admin Panel

Pastikan Ngrok Auth Token benar dan internet aktif. Coba restart app. Cek apakah token sudah kedaluwarsa di dashboard ngrok.com.

TikTok tidak bisa connect

Pastikan sedang live sebelum connect. Jika masih gagal, coba ganti koneksi internet atau gunakan VPN. TikTok membatasi koneksi unofficial dari beberapa ISP.

Donasi Saweria tidak masuk ke timer

Pastikan URL webhook di Saweria sudah benar dan ngrok aktif. Test dengan klik tombol "Test Webhook" di dashboard Saweria. Cek log di Admin Panel.

Build error: .ico must be at least 256x256

File electron/icon.ico terlalu kecil. Konversi ulang PNG ke ICO dengan ukuran minimal 256x256 menggunakan tools seperti IcoFX atau online converter.

 Bantuan

FAQ

Pertanyaan yang sering ditanyakan.

Apakah TSubathon gratis?
Ya, TSubathon sepenuhnya gratis dan akan terus gratis. Dikembangkan oleh LeonXLAB sebagai kontribusi untuk komunitas streamer Indonesia.
Apakah data saya aman?
Semua data tersimpan lokal di komputer kamu (SQLite database). TSubathon tidak mengirim data apapun ke server eksternal kecuali koneksi ke TikTok Live dan ngrok tunnel yang memang dibutuhkan untuk fungsi aplikasi.
Bisakah dipakai untuk platform selain TikTok?
Saat ini TSubathon mendukung TikTok Live (koin) dan Saweria (donasi). Dukungan untuk platform lain seperti YouTube atau Twitch sedang dalam pertimbangan untuk versi mendatang.
Berapa koin TikTok yang diperlukan untuk menambah waktu?
Konfigurasi konversi koin ke waktu dapat diatur di Admin Panel. Secara default, setiap pengiriman koin akan menambahkan waktu berdasarkan nilai koin tersebut. Kamu bisa menyesuaikan rasio konversinya.
Apakah bisa dipakai di Mac atau Linux?
Saat ini hanya tersedia untuk Windows x64. Build untuk Mac dan Linux belum tersedia secara resmi, namun kamu bisa mencoba menjalankan dari source code jika familiar dengan Node.js dan Electron.
Bagaimana cara reset semua data subathon?
Buka Admin Panel, pilih menu Reset. Ini akan menghapus data timer, leaderboard, dan log event. Database file ada di folder instalasi di sub-folder data/subathon.db.
Update otomatis bagaimana cara kerjanya?
Setiap kali app dibuka, TSubathon mengecek versi terbaru di server LeonXLAB. Jika ada update, akan muncul dialog untuk memilih download sekarang atau nanti. Update di-install saat app di-restart.
 Rilis

Changelog

Riwayat perubahan setiap versi.

v1.0.0
29 Mei 2026 — Rilis Pertama
  • NEW Timer subathon real-time dari koin TikTok
  • NEW Integrasi donasi Saweria via webhook
  • NEW Overlay timer untuk OBS/TikTok Live Studio
  • NEW Leaderboard supporter real-time
  • NEW Ending credits running text otomatis
  • NEW Auto-update via leonxlab.digital
  • NEW Setup Wizard step-by-step
  • NEW Ngrok tunnel otomatis
  • NEW System tray integration