adri
Siapa bilang streaming YouTube harus selalu dimulai secara manual? Dengan schedule streaming otomatis lewat GitHub Cron, kamu bisa menyiapkan jadwal tetap, menghemat waktu, dan tetap konsisten mengisi konten. Ide ini cocok banget buat kreator yang punya rutinitas harian atau mingguan, misalnya live coding setiap Senin‑Rabu, atau sesi Q&A setiap akhir pekan.
Dalam artikel ini, kita bakal kupas tuntas cara mengatur jadwal streaming otomatis menggunakan GitHub Actions yang dipicu oleh cron expression. Mulai dari menyiapkan repositori, menulis skrip sederhana, sampai men-debug jika ada yang nggak berjalan sesuai rencana. Semua langkah dibahas dengan bahasa santai, jadi kamu nggak perlu jadi ahli DevOps untuk mengikutinya.
Selain itu, ada beberapa tips mengelola komentar YouTube Live pakai bot di GitHub yang akan membantu kamu menjaga interaksi tetap bersih dan terkontrol selama siaran. Jadi, siap-siap catat poin-poin pentingnya, ya!
Kenapa Pakai GitHub Cron untuk Schedule Streaming?
GitHub Actions menyediakan fitur Scheduled Workflows yang menggunakan cron syntax—format penjadwalan yang sudah lama dipakai di Linux. Ada beberapa keunggulan yang bikin pilihan ini menarik:
- Gratis untuk repositori publik dan cukup murah untuk privat (hanya beberapa dolar per jam eksekusi).
- Terintegrasi penuh dengan ekosistem GitHub, jadi tidak perlu server tambahan.
- Scalable—bisa menambahkan lebih banyak job atau action lain (seperti mengirim notifikasi Slack) tanpa mengubah infrastruktur.
- Keamanan terjaga—kredensial API YouTube disimpan sebagai secret, tidak pernah ter‑expose ke publik.
Persiapan Awal Sebelum Membuat Cron Job
1. Buat Akun Google API & Dapatkan OAuth Token
Streaming ke YouTube memerlukan OAuth 2.0 token dengan scope https://www.googleapis.com/auth/youtube.force-ssl. Ikuti langkah berikut:
- Buka Google Cloud Console dan buat proyek baru.
- Aktifkan YouTube Data API v3 di bagian Library.
- Buat OAuth consent screen (pilih External, isi nama aplikasi, email, dan domain bila ada).
- Di Credentials, pilih “Create OAuth client ID”, pilih “Desktop app”. Simpan
client_iddanclient_secret. - Gunakan OAuth Playground atau script Python untuk menghasilkan
refresh_token. Token ini yang akan dipakai di GitHub Secrets.
2. Siapkan Repository GitHub
Buat repositori baru (bisa private) dengan struktur sederhana:
.
├─ .github/
│ └─ workflows/
│ └─ schedule-stream.yml
├─ scripts/
│ └─ start_stream.py
└─ README.md
Folder .github/workflows tempat menyimpan file YAML yang mendefinisikan action. Script start_stream.py akan mengirim request ke YouTube Live API untuk memulai siaran.
3. Tambahkan Secret ke GitHub
Masuk ke Settings → Secrets and variables → Actions, lalu tambahkan:
YT_CLIENT_IDYT_CLIENT_SECRETYT_REFRESH_TOKENYT_TITLE(judul default streaming)YT_DESCRIPTION(deskripsi default)
Semua nilai ini akan dipanggil di workflow dengan sintaks ${{ secrets.YT_CLIENT_ID }}, sehingga aman dari publik.
Membuat Skrip Python untuk Memulai Streaming
Sekarang waktunya menulis kode yang akan dipanggil oleh GitHub Action. Berikut contoh sederhana menggunakan google-auth dan google-api-python-client:
#!/usr/bin/env python3
import os
import google.auth.transport.requests
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
def get_credentials():
creds = Credentials(
None,
refresh_token=os.getenv('YT_REFRESH_TOKEN'),
client_id=os.getenv('YT_CLIENT_ID'),
client_secret=os.getenv('YT_CLIENT_SECRET'),
token_uri='https://oauth2.googleapis.com/token',
scopes=['https://www.googleapis.com/auth/youtube.force-ssl']
)
request = google.auth.transport.requests.Request()
creds.refresh(request)
return creds
def create_live_broadcast(youtube):
body = {
'snippet': {
'title': os.getenv('YT_TITLE', 'Live Stream Otomatis'),
'description': os.getenv('YT_DESCRIPTION', 'Streaming otomatis via GitHub Cron')
},
'status': {
'privacyStatus': 'public' # bisa 'private' atau 'unlisted'
},
'contentDetails': {
'enableClosedCaptions': True,
'enableContentEncryption': False,
'enableDvr': True,
'enableEmbed': True,
'recordFromStart': True
}
}
insert_response = youtube.liveBroadcasts().insert(
part=','.join(body.keys()),
body=body
).execute()
return insert_response['id']
def bind_stream(youtube, broadcast_id, stream_id):
youtube.liveBroadcasts().bind(
part='id,contentDetails',
id=broadcast_id,
streamId=stream_id
).execute()
def main():
creds = get_credentials()
youtube = build('youtube', 'v3', credentials=creds)
# Buat broadcast baru
broadcast_id = create_live_broadcast(youtube)
# Buat stream (jika belum ada)
stream_body = {
'snippet': {'title': 'Stream via GitHub'},
'cdn': {
'frameRate': '30fps',
'resolution': '720p',
'ingestionType': 'rtmp'
}
}
stream_response = youtube.liveStreams().insert(
part=','.join(stream_body.keys()),
body=stream_body
).execute()
stream_id = stream_response['id']
# Bind broadcast dengan stream
bind_stream(youtube, broadcast_id, stream_id)
print(f"Broadcast ID: {broadcast_id}")
print(f"Stream ID: {stream_id}")
print("Streaming siap! Salin URL RTMP dan mulai streaming menggunakan OBS atau encoder lain.")
if __name__ == '__main__':
main()
Skrip ini akan membuat broadcast baru, membuat stream (RTMP endpoint), dan menghubungkannya. Setelah selesai, kamu hanya perlu menyalakan OBS dengan URL RTMP yang diberikan—atau, kalau ingin otomatis penuh, kamu bisa menambahkan step selanjutnya yang memanggil OBS lewat CLI di server cloud.
Menulis Workflow GitHub Actions dengan Cron
Berikut contoh file .github/workflows/schedule-stream.yml yang menjalankan skrip di atas setiap hari pukul 07:00 UTC (atau sesuaikan dengan zona waktu kamu):
name: Schedule YouTube Live
on:
schedule:
- cron: '0 7 * * *' # 07:00 UTC tiap hari
jobs:
start-live:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.11'
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install google-auth google-auth-oauthlib google-api-python-client
- name: Run streaming script
env:
YT_CLIENT_ID: ${{ secrets.YT_CLIENT_ID }}
YT_CLIENT_SECRET: ${{ secrets.YT_CLIENT_SECRET }}
YT_REFRESH_TOKEN: ${{ secrets.YT_REFRESH_TOKEN }}
YT_TITLE: ${{ secrets.YT_TITLE }}
YT_DESCRIPTION: ${{ secrets.YT_DESCRIPTION }}
run: python scripts/start_stream.py
Catatan penting:
- Format cron di GitHub Actions menggunakan UTC. Jika kamu berada di WIB (UTC+7), ubah cron menjadi
'0 0 * * *'untuk jam 07:00 WIB. - Pastikan runner memiliki akses internet (default sudah). Kalau kamu butuh firewall khusus, pertimbangkan self‑hosted runner.
- Jika streaming kamu membutuhkan subtitle otomatis, kamu dapat menambahkan step yang memanggil tutorial mengupload subtitle otomatis setelah broadcast dibuat.
Pengujian & Debugging
1. Jalankan Workflow Secara Manual
GitHub Actions menyediakan tombol “Run workflow” di halaman Actions. Pilih branch dan jalankan untuk memastikan semua secret dan dependensi ter‑load dengan benar.
2. Periksa Log
Setelah job selesai, klik pada job tersebut untuk melihat log lengkap. Jika ada error “Invalid Credentials”, periksa kembali refresh_token dan pastikan token belum kedaluwarsa.
3. Validasi RTMP URL
Skrip akan menampilkan URL RTMP di output. Copot ke clipboard, buka OBS, buat “Custom Streaming Server”, dan paste URL beserta stream key. Mulai streaming di OBS, dan lihat di YouTube Dashboard apakah broadcast berubah status menjadi “LIVE”.
Menambahkan Fitur Tambahan
Notifikasi ke Slack atau Discord
Setelah broadcast berhasil dibuat, kamu bisa menambahkan step yang mengirim pesan ke Slack menggunakan slackapi/slack-github-action. Contohnya:
- name: Notify Slack
uses: slackapi/[email protected]
with:
payload: |
{
"text": "🔴 Live streaming dimulai! Broadcast ID: ${{ steps.start-live.outputs.broadcast_id }}",
"attachments": [
{
"title": "Tonton Sekarang",
"title_link": "https://www.youtube.com/watch?v=${{ steps.start-live.outputs.broadcast_id }}"
}
]
}
env:
SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
Integrasi dengan CI Pipeline untuk Transcoding
Kalau kamu ingin menyiapkan video pra‑rekaman yang akan diputar saat live, pertimbangkan CI pipeline untuk transcoding. Misalnya, build video 1080p, upload ke bucket Cloud Storage, lalu gunakan URL tersebut sebagai “premiere” di YouTube Live.
Gunakan GitHub Copilot untuk Menulis Skrip Lebih Cepat
Bila kamu belum familiar dengan API YouTube, GitHub Copilot dapat membantu men-generate kode boilerplate. Cukup beri komentar “Create YouTube live broadcast” dan Copilot akan menyarankan seluruh blok kode.
Tips & Trik agar Jadwal Streaming Berjalan Tanpa Kendala
- Gunakan cron expression yang jelas. Misalnya, ‘30 15 * * 5’ berarti setiap Jumat jam 15:30 UTC.
- Monitor quota API. YouTube Data API memiliki batas kuota harian; hindari membuat broadcast berulang-ulang dalam satu hari.
- Simpan backup token. Refresh token kadang dapat dicabut; simpan salinan di vault pribadi.
- Uji zona waktu. Selalu cek konversi UTC ke lokal dengan
date -udi terminal atau layanan online. - Automasi notifikasi ke tim atau subscriber agar mereka tahu kapan live dimulai.
Kasus Penggunaan Nyata
Berikut tiga contoh skenario dimana schedule streaming otomatis memberi nilai tambah signifikan:
- Live Coding Harian—Seorang developer mengatur broadcast setiap hari kerja jam 19:00 WIB. Dengan cron, tidak perlu mengingat menyalakan OBS manual; cukup menyiapkan preset di OBS yang otomatis terhubung ke URL RTMP yang dibuat tiap hari.
- Webinar Mingguan—Tim marketing mengadakan webinar tiap Selasa pukul 10:00 WIB. Workflow dapat menambahkan step untuk mengupload slide PDF ke YouTube sebagai “presentation” sebelum siaran dimulai.
- Streaming Event Besar—Saat peluncuran produk, perusahaan mengatur serangkaian sesi live selama tiga hari berturut‑turut. Cron memastikan tiap sesi dimulai tepat waktu tanpa harus menugaskan operator tambahan.
Langkah Ringkas dari A sampai Z
- Daftar Google Cloud, aktifkan YouTube Data API, dapatkan OAuth client dan refresh token.
- Buat repo GitHub, struktur folder, dan tambahkan secret untuk kredensial.
- Tulis skrip Python (
start_stream.py) yang membuat broadcast & stream. - Buat file workflow
schedule-stream.ymldengan cron expression sesuai kebutuhan. - Uji workflow secara manual, periksa log, dan pastikan URL RTMP berfungsi di OBS.
- Tambahkan notifikasi Slack/Discord, atau step upload subtitle otomatis bila diperlukan.
- Deploy dan biarkan cron menjalankan streaming secara otomatis.
Dengan mengikuti rangkaian langkah di atas, kamu tidak hanya menghemat waktu, tapi juga memberi kesan profesional pada audience. Jadwal yang konsisten meningkatkan engagement, karena penonton tahu kapan harus menonton. Dan yang terpenting, semua ini dilakukan tanpa harus mengeluarkan biaya server khusus—cukup manfaatkan kekuatan GitHub Actions yang sudah ada.
Jika kamu masih ragu tentang keamanan token atau ingin menambah fitur lain, jangan ragu untuk eksplorasi lebih lanjut. Misalnya, menghubungkan Google Cloud Function dengan GitHub untuk mengatur webhook yang memicu streaming berdasarkan event lain, seperti perubahan pada spreadsheet jadwal.
Semoga panduan ini membantu kamu mengotomatisasi schedule streaming YouTube dengan mudah dan menyenangkan. Selamat mencoba, dan semoga live-mu selalu lancar tanpa harus terjaga semalaman menyiapkan siaran!
