Mengenal Chrisnov Media Toolkit: Downloader dan Converter Media Ringan untuk Windows, Linux, dan macOS

Saya sedang mengembangkan sebuah aplikasi kecil bernama Chrisnov Media Toolkit. Aplikasi ini berawal dari kebutuhan sederhana: punya downloader media yang ringan, mudah dipakai, dan tidak membuat pengguna non-teknis harus berurusan langsung dengan command line.

Dalam proses pengembangan, fiturnya berkembang. Selain downloader berbasis yt-dlp, aplikasi ini sekarang juga punya audio converter dan video converter berbasis FFmpeg. Jadi, untuk tahap beta awal ini, Chrisnov Media Toolkit sudah bisa dipakai sebagai alat bantu harian untuk download, ekstrak audio, convert audio, dan convert video lokal.

Saat ini aplikasi masih dalam tahap internal beta, dengan build terbaru: v0.1.0-beta.5

Mulai dari versi v0.1.0-beta.3, build Windows tersedia dalam dua varian:

Varian	Ukuran	FFmpeg	Cocok untuk
Lite	~55 MB	Perlu install sendiri	Pengguna yang sudah familiar dengan terminal
Bundled	~161 MB*	Sudah termasuk	Pengguna awam yang ingin langsung pakai

*Ukuran Bundled bisa bervariasi tergantung versi FFmpeg yang digunakan saat build.

Download Chrisnov Media Toolkit

Mulai versi v0.2.0-beta.1 source code tersedia di GitHub dan bisa download aplikasinya langsung dari GitHub Release.

Download beta Windows x64 (Lite):

https://dl.chrisnov.com/app/windows/chrisnov-media-toolkit-v0.1.0-beta.5-windows-x64-lite.zip
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-windows-x64-lite.zip

Download beta Windows x64 (Bundled):

https://dl.chrisnov.com/app/windows/chrisnov-media-toolkit-v0.1.0-beta.5-windows-x64-bundled.zip
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-windows-x64-bundled.zip

Download beta Linux x64 (Lite):

https://dl.chrisnov.com/app/linux/chrisnov-media-toolkit-v0.1.0-beta.5-linux-x64-lite.tar.gz
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-linux-x64-lite.tar.gz

Download beta macOS-ARM64 (Lite, unsigned):

https://dl.chrisnov.com/app/macos/chrisnov-media-toolkit-v0.1.0-beta.5-macos-arm64-lite.zip
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-macos-arm64-lite.zip

Download beta macOS-x86_64 Intel Mac (Lite, unsigned):

https://dl.chrisnov.com/app/macos/chrisnov-media-toolkit-v0.1.0-beta.5-macos-x86_64-lite.zip
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-macos-x86_64-lite.zip

Checksum SHA256 tersedia dengan menambahkan .sha256 di akhir setiap URL download. Mulai versi v0.2.0-beta.1 checksum SHA256 tersedia di GitHub Releases.

Walaupun belum rilis publik, fitur utamanya sudah fungsional dan sedang diuji di Windows 11. Target awalnya adalah cross-platform untuk Windows, Linux Mint, dan macOS.

Fitur Utama

Chrisnov Media Toolkit saat ini punya empat tab utama:

1. Downloader
2. Audio Converter
3. Video Converter
4. History

Downloader

Fitur Downloader memakai yt-dlp, jadi mendukung YouTube dan banyak situs lain yang juga didukung oleh yt-dlp.

Fitur yang sudah tersedia:

• Download video dari URL.
• Mode Audio only untuk mengambil audio saja.
• Pilihan resolusi: Best, 1080p, 720p, 480p, 360p.
• Pilihan container video: mp4, mkv, webm.
• Pilihan format audio: mp3, m4a, opus.
• Pilihan bitrate audio: 96 sampai 320 kbps.
• Batch queue untuk banyak URL.
• Playlist support.
• Skip duplicate memakai download archive.
• Drag-and-drop URL atau file teks berisi daftar URL.
• Clean title untuk membersihkan tag seperti Official Music Video, Video Lirik, dan sejenisnya.

Audio Converter

Audio Converter dipakai untuk mengubah file audio lokal atau mengambil audio dari file video lokal.

Fitur yang sudah tersedia:

• Input audio dan video lokal.
• Output: mp3, m4a, opus, flac, wav.
• Add files dan Add folder.
• Batch conversion.
• Pilihan CBR/VBR untuk format lossy.
• Pilihan bitrate.
• Pilihan sample rate.
• EBU R128 loudness normalization.
• Peak normalize.
• Trim silence.
• Progress real-time dari FFmpeg.
• Cancel yang menghentikan proses FFmpeg dengan lebih aman.

Fitur Add folder berguna untuk kasus seperti convert satu folder album atau koleksi file audio sekaligus.

Video Converter

Video Converter dipakai untuk convert video lokal ke format umum.

Fitur yang sudah tersedia:

• Input: mp4, mkv, webm, avi, mov, wmv, flv, ts, m4v.
• Output: mp4, mkv, webm.
• Preset kualitas:
  • Keep quality
  • Balanced
  • Smaller file
• Add files dan Add folder.
• Batch conversion.
• Opsi Keep original audio when possible.
• Fallback otomatis ke AAC/Opus kalau audio asli tidak kompatibel dengan container output.
• Progress real-time dari FFmpeg.
• Cancel conversion.

Kenapa Dibuat?

Saya ingin aplikasi yang ringan dan langsung ke fungsi utama. Banyak aplikasi media converter komersial terasa besar atau terlalu banyak fitur yang tidak selalu diperlukan. Untuk kebutuhan dasar seperti download video, ambil audio, convert folder album, atau convert video pendek, aplikasi sederhana seperti ini lebih nyaman.

Selain itu, aplikasi ini dirancang agar tetap ramah untuk laptop low-spec. Pengujian awal dilakukan di mesin dengan spesifikasi sederhana, dan hasilnya cukup ringan untuk workflow harian.

Panduan Penggunaan di Windows

Mayoritas pengujian awal difokuskan di Windows 10/11 dan Linux Mint, jadi build Windows dan Linux menjadi prioritas pertama.

Pilih Varian yang Sesuai

Sebelum mulai, pilih varian yang sesuai dengan kebutuhan:

• Bundled — Pilihan paling mudah. FFmpeg sudah termasuk di dalam aplikasi, jadi langsung bisa dipakai tanpa setup tambahan. Cocok untuk pengguna yang tidak ingin berurusan dengan terminal atau instalasi manual. Langsung lanjut ke langkah Jalankan Aplikasi.
• Lite — Ukuran file lebih kecil, tapi membutuhkan FFmpeg terinstall terpisah di komputer. Cocok untuk pengguna yang sudah familiar dengan terminal dan ingin menghemat ukuran download. Ikuti langkah Siapkan FFmpeg di bawah terlebih dahulu.

1. Siapkan FFmpeg (Khusus Varian Lite)

Langkah ini hanya diperlukan jika menggunakan varian Lite. Jika menggunakan varian Bundled, lewati langkah ini dan langsung ke Jalankan Aplikasi.

FFmpeg adalah program terpisah yang dibutuhkan untuk proses merge video/audio dan conversion. Untuk varian Lite, FFmpeg perlu diinstall di komputer terlebih dahulu.

Cara Membuka Windows Terminal

Jika belum pernah membuka terminal di Windows, berikut caranya:

1. Tekan tombol Windows di keyboard (tombol dengan logo Windows, biasanya di kiri bawah keyboard, di antara tombol Ctrl dan Alt).
2. Ketik Terminal atau PowerShell.
3. Klik Terminal atau Windows PowerShell yang muncul di hasil pencarian.
4. Bisa juga via klik kanan di tombol Windows dan pilih Terminal (Admin)

Akan terbuka jendela hitam atau biru tua dengan kursor yang berkedip. Di sinilah perintah diketik.

Install FFmpeg via winget

Ketik perintah berikut di terminal, lalu tekan Enter:

winget install Gyan.FFmpeg

Tunggu sampai proses instalasi selesai. Jika diminta persetujuan, ketik Y lalu tekan Enter.

Setelah install selesai, tutup terminal lalu buka ulang terminal baru agar sistem mengenali FFmpeg yang baru diinstall.

Verifikasi Instalasi

Untuk memastikan FFmpeg sudah terinstall dengan benar, ketik di terminal:

ffmpeg -version

Jika berhasil, akan muncul informasi versi FFmpeg. Jika muncul pesan error seperti ffmpeg is not recognized, coba restart komputer terlebih dahulu, lalu ulangi perintah di atas.

Alternatif: Install via Chocolatey

Jika winget tidak tersedia di komputer (misalnya pada Windows 10 versi lama), FFmpeg juga bisa diinstall menggunakan Chocolatey:

1. Install Chocolatey terlebih dahulu dari https://chocolatey.org/install.
2. Buka terminal sebagai Administrator (klik kanan Terminal → Run as administrator).
3. Ketik:

choco install ffmpeg

2. Jalankan Aplikasi

Setelah download file .exe yang sesuai (Lite atau Bundled):

1. Buka folder tempat file didownload (biasanya folder Downloads).
2. Double-click file .exe tersebut.
3. Jika muncul peringatan Windows protected your PC dari SmartScreen:

• Klik More info.
• Klik Run anyway.
• Peringatan ini normal untuk aplikasi baru yang belum memiliki sertifikat digital. Aplikasi ini aman digunakan.

Tidak perlu install Python atau program tambahan lainnya. Aplikasi langsung berjalan dari file .exe.

3. Download Video

Langkah dasar:

1. Buka tab Downloader.
2. Paste URL video (klik kanan → Paste, atau tekan Ctrl+V).
3. Klik Add to queue.
4. Pilih resolusi dan container.
5. Pilih output folder jika perlu.
6. Klik Start.

Untuk download audio saja:

1. Centang Audio only.
2. Pilih format audio, misalnya mp3 atau m4a.
3. Pilih bitrate.
4. Klik Start.

Secara default, folder output akan otomatis pindah ke Music saat Audio only aktif, dan kembali ke Videos saat mode video.

4. Convert Audio atau Ekstrak Audio dari Video

Langkah dasar:

1. Buka tab Audio Converter.
2. Klik Add files… atau Add folder….
3. Pilih output format, misalnya mp3, m4a, flac, atau wav.
4. Atur bitrate, sample rate, atau normalization jika perlu.
5. Pilih output folder.
6. Klik Convert.

Jika input berupa file video, aplikasi akan mengambil audionya saja.

5. Convert Video

Langkah dasar:

1. Buka tab Video Converter.
2. Klik Add files… atau Add folder….
3. Pilih output format: mp4, mkv, atau webm.
4. Pilih quality preset.
5. Biarkan Keep original audio when possible aktif jika ingin proses lebih efisien.
6. Klik Convert.

Untuk penggunaan umum, preset Balanced adalah pilihan aman.

Panduan Singkat untuk Ubuntu-based Distros

Untuk Ubuntu-based distros (Linux Mint, Pop!_OS, Zorin, Kubuntu, Lubuntu, etc.), tersedia build Lite dalam format .tar.gz. Varian ini tidak menyertakan FFmpeg, jadi FFmpeg tetap perlu diinstall dari package manager sistem.

Download:

https://dl.chrisnov.com/app/linux/chrisnov-media-toolkit-v0.1.0-beta.5-linux-x64-lite.tar.gz
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-linux-x64-lite.tar.gz

Install FFmpeg:

sudo apt update
sudo apt install ffmpeg

Ekstrak file download, misalnya dari folder Downloads:

cd ~/Downloads
tar -xzf chrisnov-media-toolkit-v0.2.0-beta.1-linux-x64-lite.tar.gz
chmod +x chrisnov-media-toolkit-lite
./chrisnov-media-toolkit-lite

Jika aplikasi tidak terbuka dari file manager, jalankan dari terminal seperti contoh di atas agar pesan error bisa terlihat. Untuk tahap beta ini, build Linux tetap perlu diuji langsung di Linux Mint karena dependency desktop/Qt bisa berbeda antar distro.

Catatan: PyInstaller harus dijalankan di OS target. Jadi build Windows dibuat di Windows, build Linux dibuat di Linux, dan build macOS dibuat di macOS.

Panduan Singkat untuk macOS

Build macOS tersedia sebagai .app yang dibungkus ZIP. Untuk tahap beta ini, build macOS masih Lite dan unsigned, jadi FFmpeg perlu diinstall terpisah dan macOS mungkin menampilkan peringatan keamanan saat pertama kali dibuka.

Download:

https://dl.chrisnov.com/app/macos/chrisnov-media-toolkit-v0.1.0-beta.5-macos-arm64-lite.zip
https://github.com/chrisnov-it/Chrisnov-Media-Toolkit/releases/download/v0.2.0-beta.1/chrisnov-media-toolkit-v0.2.0-beta.1-macos-arm64-lite.zip

Install FFmpeg via Homebrew:

brew install ffmpeg

Setelah ZIP diekstrak, jika macOS menolak membuka aplikasi karena belum ditandatangani, gunakan klik kanan pada aplikasi lalu pilih Open. Ini normal untuk build beta internal yang belum melalui Apple notarization.

Catatan penting: build macOS ini belum sempat saya tes langsung karena saya tidak punya mesin Mac. Jika kamu menggunakan macOS dan bersedia mencoba, feedback akan sangat membantu, terutama soal apakah aplikasi bisa dibuka, apakah FFmpeg terdeteksi, dan apakah fitur download/conversion berjalan normal.

Tips dan Catatan untuk Pengguna Mac

Berikut beberapa hal yang perlu diperhatikan saat menjalankan Chrisnov Media Toolkit di macOS, terutama untuk pengguna MacBook atau iMac lama (2015–2020) yang menjalankan macOS Monterey atau Ventura.

Panduan lengkap khusus untuk pengguna Mac Intel keluaran 2015-2020 bisa dilihat di dokumentasi GitHub.

Persyaratan Sistem

• macOS 12 Monterey atau lebih baru (macOS 13 Ventura dan 14 Sonoma juga didukung). Untuk MacBook Air 2015, versi macOS tertinggi yang didukung adalah Monterey.
• FFmpeg terinstall di sistem (install via brew install ffmpeg).
• Sekitar 250 MB ruang kosong untuk aplikasi yang sudah diekstrak.
• Koneksi internet untuk download video dan update metadata dari yt-dlp.

Apple Silicon vs Intel: Pilih File yang Tepat

Download file zip sesuai arsitektur Mac kamu:

• *-macos-arm64-lite.zip — untuk Apple Silicon (M1, M2, M3, M4, dst.). Ini Mac dari tahun 2020 ke atas, termasuk MacBook Air M1, MacBook Pro M2, iMac M1, Mac mini M2, dst.
• *-macos-x86_64-lite.zip — untuk Intel Mac dari tahun 2015–2020, seperti MacBook Air 2015–2020, MacBook Pro 2015–2020, iMac 2015–2020, Mac mini 2014–2018. Mac Intel tidak bisa menjalankan file arm64.

Cara cek arsitektur Mac: klik menu Apple di pojok kiri atas, lalu pilih About This Mac. Baris “Chip” atau “Processor” menunjukkan arsitektur Apple Silicon (M1/M2/dst.) atau Intel.

Peringatan Keamanan Saat Pertama Kali Buka

Aplikasi ini unsigned (belum melalui Apple notarization), jadi macOS akan menampilkan peringatan keamanan saat pertama kali dibuka. Ini normal untuk build beta internal. Ada dua cara untuk mengizinkannya:

1. Cara cepat: klik kanan (atau Control-klik) pada file Chrisnov Media Toolkit.app di Finder → pilih Open dari menu konteks. macOS akan menampilkan dialog peringatan, klik Open lagi untuk konfirmasi. Setelah ini, aplikasi akan jalan normal double-click di kemudian hari.
2. Cara manual: coba buka aplikasi dengan double-click seperti biasa. macOS akan menolak dengan pesan “Chrisnov Media Toolkit.app cannot be opened”. Buka System Settings → Privacy & Security, scroll ke bawah, klik Open Anyway di samping pesan tentang aplikasi ini, lalu klik Open di dialog konfirmasi.

Verifikasi SHA256

Setiap file zip rilis memiliki checksum SHA256 yang bisa diverifikasi untuk memastikan file tidak corrupt atau termodifikasi. Di Terminal:

shasum -a 256 -c chrisnov-media-toolkit-v0.2.0-beta.1-macos-arm64-lite.zip.sha256

Output harus diakhiri dengan OK. Untuk Intel Mac, ganti nama file menjadi *-macos-x86_64-lite.zip dan *.sha256 di perintah yang sama.

Troubleshooting

• “Chrisnov Media Toolkit.app is damaged” — buka Terminal, jalankan: xattr -cr "/Applications/Chrisnov Media Toolkit.app" (sesuaikan path jika install di tempat lain), lalu coba buka lagi.
• “FFmpeg not found” di dalam aplikasi — pastikan FFmpeg sudah terinstall: brew install ffmpeg, lalu restart aplikasi.
• Download gagal dengan error SSL/HTTPS — yt-dlp kadang tertinggal dari perubahan di sisi situs. Update yt-dlp via Homebrew: brew upgrade yt-dlp, atau jalankan manual di Terminal.
• Aplikasi crash saat convert video — codec HEVC (H.265) di macOS butuh lisensi tambahan. Coba format output MP4 dengan codec H.264, atau install ffmpeg-full via brew install ffmpeg --with-openh264.

Kalau ada masalah lain, silakan kontak lewat halaman Contact dengan menyertakan versi macOS, arsitektur (Apple Silicon / Intel), dan pesan error lengkap.

Catatan Beta

Build ini masih beta, jadi hasil di setiap sistem bisa berbeda tergantung:

• Versi Windows atau Linux.
• Ketersediaan FFmpeg (khusus varian Lite).
• Driver dan codec sistem.
• Perbedaan behavior yt-dlp untuk situs tertentu.
• Antivirus atau security policy Windows.

Untuk saat ini build dibuat tanpa UPX. Ukuran file memang sedikit lebih besar, tetapi ini lebih aman untuk mengurangi risiko false positive antivirus. Dalam pengujian, UPX hampir tidak mengurangi ukuran binary, jadi tidak layak dipakai untuk build beta ini.

Dua Varian Build Windows

Mulai dari beta ini, build Windows tersedia dalam dua varian:

• Lite — Ukuran lebih kecil (~53 MB). Tidak menyertakan FFmpeg. Pengguna perlu menginstall FFmpeg sendiri melalui terminal. Cocok untuk pengguna teknis yang sudah familiar dengan command line.
• Bundled — Ukuran lebih besar (~161 MB atau lebih). Sudah menyertakan FFmpeg dan FFprobe di dalam file .exe. Pengguna tidak perlu install apa pun selain mendownload dan menjalankan file. Cocok untuk pengguna awam.

Secara fungsionalitas, keduanya identik. Perbedaannya hanya pada apakah FFmpeg sudah termasuk di dalam paket atau tidak.

Perbaikan Bug: Konversi Audio ke Format Opus

Pada versi sebelumnya, konversi audio ke format Opus bisa gagal jika sample rate input tidak kompatibel. Ini terjadi karena encoder Opus (libopus) hanya mendukung sample rate tertentu: 8000, 12000, 16000, 24000, dan 48000 Hz. Jika file input menggunakan sample rate 44100 Hz (standar CD), konversi akan error.

Masalah ini sekarang sudah diperbaiki. Aplikasi secara otomatis menyesuaikan sample rate ke 48000 Hz (standar Opus) jika sample rate asal tidak didukung.

Changelog Singkat

Beberapa perubahan penting di build beta terbaru:

• Menambahkan build macOS x86_64 (Intel) Lite untuk Mac Intel 2015–2020 yang menjalankan macOS 12 Monterey atau lebih baru. Build Intel menggunakan runner macos-15-intel di GitHub Actions dan dipublikasikan berdampingan dengan build Apple Silicon di setiap rilis.
• Workflow build-macos.yml sekarang memakai matrix dengan dua runner paralel: macos-latest (ARM64) dan macos-15-intel (x86_64). Keduanya selesai dalam waktu kurang dari 2 menit per leg.
• Pinned majors untuk GitHub Actions diperbarui: actions/checkout v4 → v5, actions/setup-python v5 → v6, actions/upload-artifact v4 → v6 (v6 diperlukan karena v5 masih men-pin Node 20). Peringatan deprecation Node 20 sekarang hilang dari log CI.
• docs/OLD-MAC-WORKAROUND.md ditulis ulang: prebuilt x86_64 zip sekarang menjadi opsi yang direkomendasikan, opsi source-run berpindah ke urutan kedua.
• Menambahkan build Linux x64 Lite dalam format .tar.gz.
• Menambahkan build macOS Lite dalam format .app.zip unsigned.
• Menyediakan build Windows Lite dan Bundled dengan nama file versi yang lebih konsisten.
• Memperbaiki clean title untuk download playlist dan file yang sudah selesai saat proses playlist dibatalkan.
• Memperbaiki konversi Opus dengan menyesuaikan sample rate otomatis ke 48000 Hz jika diperlukan.
• Menambahkan checksum SHA256 untuk file download agar pengguna bisa memverifikasi hasil unduhan.
• Download History tab yang mencatat hasil download baik yang sukses maupun yang gagal.

Penutup

Chrisnov Media Toolkit masih dalam tahap awal, tapi fondasinya sudah cukup kuat untuk pengujian internal. Fokusnya bukan menjadi aplikasi media super kompleks, melainkan alat yang ringan, jelas, dan praktis untuk kebutuhan download serta convert media sehari-hari.

Untuk tahap berikutnya, saya akan lanjut menguji build Windows, Linux, dan macOS dari GitHub Actions, lalu memperbaiki UX berdasarkan hasil penggunaan nyata.