Manual Instalasi & Pemakaian - JTV Player
JTV Player adalah pemutar TV online berbasis web yang mendukung:
- Playlist M3U (file .m3u yang berisi daftar channel)
- Stream HLS (.m3u8) dengan
hls.js
- Stream DASH (.mpd) dengan
dash.js
- File video langsung (mp4/webm/ogg) via player HTML5
- Favorit, remove playlist per sumber, kosongkan semua
- Tab sumber (jika playlist dari 2 link atau lebih)
- Perbesar/perkecil tampilan player & Picture-in-Picture
Penting tentang codec: “Codec lengkap untuk semua format” tidak mungkin dijamin 100% hanya dari sisi web player,
karena dukungan codec ditentukan oleh browser & perangkat. Solusi ini sudah menambahkan engine HLS/DASH yang paling umum,
dan sisanya mengikuti kemampuan browser.
1) Isi ZIP
index.html (aplikasi utama)
assets/app.js (logika playlist, favorit, player)
assets/styles.css (tampilan)
proxy.php (proxy umum: mengatasi CORS, dipakai untuk segmen/asset)
hls.php (proxy khusus HLS: rewrite m3u8 agar segmen/variant ikut lewat proxy)
README_ID.html (manual ini)
2) Cara Upload ke Hosting
A. Hosting biasa (cPanel) - disarankan
- Login ke cPanel → File Manager
- Masuk ke folder:
public_html/ (atau folder domain/subdomain Anda)
- Upload file ZIP ini
- Extract ZIP di dalam
public_html/
- Pastikan file
index.html ada di root folder itu
Selesai. Buka domain Anda, misalnya: https://domainanda.com/
B. Hosting statis (Netlify/Vercel/GitHub Pages)
Bisa jalan juga, tetapi fitur proxy PHP tidak tersedia. Jika playlist/stream Anda butuh proxy (CORS), gunakan hosting yang mendukung PHP atau buat proxy sendiri.
3) Cara Pakai
- Buka website JTV Player
- Tempel URL playlist (contoh: file .m3u) atau URL stream (.m3u8 / .mpd)
- Klik Tambah
- Jika tidak muncul karena CORS/redirect, centang Gunakan proxy PHP lalu coba tambah lagi
- Klik channel di daftar playlist untuk memutar
4) Favorit
- Klik ikon ☆ untuk menambah favorit → menjadi ⭐
- Centang Favorit saja untuk menampilkan hanya channel favorit
5) Remove Playlist Satuan & Kosongkan Semua
- Remove satuan: klik tab sumber lalu tekan tombol ✕ pada tab
- Kosongkan semua: klik tombol Kosongkan Playlist
6) Player: Perbesar/Kecilkan, PiP, Fullscreen
- 🔎 Perbesar/perkecil area video
- 🪟 Picture-in-Picture (jika browser mendukung)
- ⛶ Fullscreen
7) Navigasi & Shortcut Keyboard
- Space: play/pause
- F: fullscreen
- P: Picture-in-Picture
- ← / →: mundur/maju 10 detik
- R: reload stream
8) Mengatasi Masalah Umum
Hosting mengembalikan 403 saat akses proxy (ModSecurity/WAF)
- Jika Network menunjukkan request ke
proxy.php berstatus 403, seringnya itu diblokir firewall hosting (ModSecurity) karena parameter ?url=http....
- Versi ini memakai parameter
u= (base64url) untuk menghindari blokir tersebut.
- Jika masih 403, cek di DevTools → klik request → lihat Response Headers. Jika server yang membalas adalah hosting Anda (Apache/LiteSpeed), berarti WAF masih memblokir dan Anda perlu whitelist rule atau pakai VPS.
Playlist tidak bisa dimuat (CORS / redirect)
- Centang Gunakan proxy PHP
- Pastikan file
proxy.php dan hls.php ikut ter-upload di folder yang sama dengan index.html
- Proxy HLS melakukan rewrite URL segmen agar stream yang pakai path relatif tetap bisa diputar.
Channel tidak bisa diputar / codec tidak mendukung
- Coba browser lain: Chrome/Edge/Android Chrome biasanya paling kompatibel
- Beberapa stream memakai DRM atau codec khusus yang tidak bisa diputar di browser
Proxy disalahgunakan (keamanan)
- Aktifkan allowlist domain pada
proxy.php (lihat bagian komentar)
9) Backup / Pindah Perangkat
- Klik Export untuk mengunduh backup JSON
- Gunakan Import untuk memuat kembali data
Versi: 1.0