Onsa

Apa ini

Onsa (音叉, garpu tala) adalah pemutar musik desktop untuk Windows dan Linux. Sasarannya orang yang menyimpan berkas musiknya sendiri dan ingin tahu apa yang sebenarnya terjadi pada suaranya. Identitas visualnya panel instrumen: aplikasi tampil seperti alat ukur yang jujur, dan strip jalur sinyal di bawah jendela menunjukkan tiap tahap yang benar-benar dilewati — format sumber, resample, ReplayGain, EQ, limiter, sampai backend output. Tiap tahap bisa dimatikan dari strip itu.

Tidak ada yang menghubungi internet kecuali dinyalakan sendiri. Semua fitur jaringan mati secara bawaan.

Yang ada di v1.4.0: pemutaran gapless dan crossfade, antrean yang bisa diurut ulang, playlist manual dan playlist pintar, rantai DSP yang terlihat, library dengan pencarian teks penuh dan folder sumber yang bisa dilepas atau dipindahkan, editor tag satuan dan massal, lirik dari tiga sumber, layar Sedang diputar yang panelnya bisa diatur, enam tema bawaan, bantuan di dalam aplikasi, dan dua bahasa antarmuka. Unduhan lewat yt-dlp kini berjalan beberapa sekaligus, dan program yang dibutuhkannya — yt-dlp, ffmpeg, Deno, fpcalc — diambil Onsa sendiri, hanya setelah disetujui dan sesudah cocok dengan checksum rilis resminya.

Berkas pemasangnya ada di halaman rilis v1.4.0, dibangun dan diunggah CI: Onsa_1.4.0_x64-setup.exe (11,79 MB) untuk Windows, serta .deb (18,93 MB) dan AppImage (89,92 MB) untuk Linux — paket Linux pertama Onsa. Paket Linux baru dicoba di WSL, belum di mesin Linux sungguhan.

Kode Onsa bisa dilihat di GitHub. Repo-nya sengaja belum berlisensi; keputusan lisensi ditahan sampai nanti.

Berikutnya

v1.4.1 menutup sisa M10b: antrean unduhan yang tetap ada sesudah Onsa ditutup, dan folder hasil unduhan yang bisa dipilih. Kodenya sudah masuk repo, tapi rilisnya belum ditandai.

Lalu M16 (v1.5 “Tampilan”): perombakan total enam tema bawaan, masing-masing dengan layout sendiri. Tema pembukanya bertema kokpit pesawat analog vintage. Konsep keenam tema sudah disetujui; skema temanya diperluas di luar warna — huruf, material permukaan, bingkai, gaya meter dan visualizer, dan animasi.

Tangkapan layar di halaman ini masih tampilan lama; diganti setelah M16 dirilis.

Mesin audio terpisah total dari tampilan

Prinsip utama arsitekturnya: mesin audio berjalan di thread sendiri dan tidak tahu apa-apa soal antarmuka. Antarmuka hanyalah remote control yang bicara lewat command dan event Tauri. Seberat apa pun antarmuka, pemutaran tidak boleh tersendat.

Pekerjaannya dibagi ke enam crate Rust yang batasnya dijaga:

Aturannya: onsa-audio tidak bergantung pada crate Onsa lain, dan modul fitur tidak saling bergantung. Semuanya disatukan hanya di src-tauri. Downloader, misalnya, tidak tahu apa-apa soal library — ia mengembalikan path berkas hasil, lalu src-tauri yang menyerahkannya.

Arah komunikasinya juga dipatok: command dari antarmuka ke backend (play, seek, set_eq, library_query), event dari backend ke antarmuka (posisi putar ≤ 10 Hz, frame analisis ≤ 60 Hz, progres, error). Cover art dilayani lewat custom protocol, bukan base64 di dalam event.

Keputusan yang dikunci sebelum kode ditulis

Spesifikasinya ditulis lebih dulu, sebelum baris kode pertama. Sebagian keputusan ditandai terkunci — tidak diubah tanpa persetujuan pemilik proyek:

Keputusan desain, beserta alasannya

Tiap keputusan yang tidak jelas dari kode dicatat dengan tanggal, konteks, keputusan, dan alasan. Beberapa yang menentukan bentuk aplikasinya:

• Thread kontrol dan thread decode digabung. Spesifikasi menggambarnya terpisah; yang dibangun satu thread mesin yang memproses perintah di sela pengisian buffer. Alasannya paling sederhana dan tanpa lock antar-thread — saat pause, thread tidur di channel perintah sehingga CPU idle nol.
• Gapless dengan resampling memakai satu lane. Lagu berurutan dengan sample rate sama disambung di dalam satu lane yang memakai satu resampler, sehingga resampler melihat sinyal kontinu. Seek, skip, atau pergantian sample rate memulai lane baru.
• Pause dan seek memakai micro-fade 60 ms di callback output, sedangkan skip saat bermain memakai crossfade di dalam stream. Hasilnya pause terasa langsung, dan skip tetap mendapat crossfade yang diminta spesifikasi.
• Editan tag masuk ke overrides dulu; “tulis ke berkas” aksi terpisah. Tiga lapis — simpan di Onsa, tulis ke berkas, pindahkan berkas — dan pembatalan menuruni tangga yang sama. Lapisan yang paling sering dipakai jadi yang paling murah dibatalkan.
• Penulisan tag dibaca ulang sebelum menggantikan berkas aslinya. Salinan sementara ditulis lalu dibaca kembali; kalau isinya tidak sesuai, salinan itu dibuang dan berkas aslinya tidak pernah tersentuh. Ini bukan kehati-hatian teoretis: lofty kehilangan tag ID3v2 di dalam WAV pada penulisan kedua berturut-turut.
• Yang dekat dibaca ulang, yang jauh diingat. Lirik .lrc di sebelah lagu dan lirik di dalam tag dibaca tiap kali lagu berganti; hanya jawaban dari internet yang masuk cache. Membaca berkas teks kecil lebih murah daripada memutuskan apakah yang diingat masih benar.
• “Tidak ada liriknya” diingat, tetapi layanan yang tidak bisa dihubungi bukan jawaban. Menelan status HTTP membuat layanan yang tumbang tak bisa dibedakan dari layanan yang berkata tidak tahu — dan sebuah lagu bisa tercatat tak berlirik gara-gara jaringan buruk satu menit.
• Sumber rilis binary ditulis di kode, bukan diambil dari yang diunduh. URL, nama berkas di daftar checksum, dan perkiraan ukurannya tetap. Checksum diambil lebih dulu, baru berkasnya; yang tidak cocok tidak ditulis ke mana pun, bahkan tidak untuk dilihat.

Aturan yang tidak boleh dilanggar

Di callback output cpal dan jalur panas DSP: tidak ada alokasi memori, lock, I/O, logging, atau panic. Parameter masuk lewat atomics atau ring buffer lock-free, lalu diterapkan dengan smoothing. Semua buffer dialokasikan di muka. Bila ragu apakah sesuatu aman untuk real-time, anggap tidak aman dan pindahkan ke thread lain.

Pengaman yang berlaku sebelum apa pun menyentuh berkas orang:

• Batalkan bekerja per batch, bukan per langkah; tiap langkah dicatat dengan nilai sebelum dan sesudah, dan pembatalan berjalan mundur dari langkah terakhir.
• Cakupan folder diuji terhadap path yang sudah dirapikan, sehingga salinan/../asli/lagu.mp3 tidak bisa menyelinap dan folder bertetangga bernama mirip bukan bagian dari cakupan.
• Batas 50 berkas per sekali jalan, dengan langit-langit keras 500 — yang menentukan bukan kemampuan mesin melainkan kemampuan orang membaca ulang dan membatalkannya kalau ada yang salah.
• Usulan berkeyakinan di bawah 0,85 tetap ditampilkan untuk dibaca, tapi tidak satu pun field-nya tercentang.
• Rename selalu punya dry-run yang menyebutkan asal, tujuan, dan alasan sebuah berkas tidak bisa dipindah.

Pengujian

Tidak ada berkas musik berhak cipta di repo. Fixture audio dibuat saat tes berjalan — sinus, sweep, noise, dan hening — beserta tag hasil tulisan tes sendiri. Mesin audio diuji lewat sink offline: dua berkas hasil potongan satu sinus kontinu diputar berurutan lalu dibandingkan dengan sinus utuh, dan tidak boleh ada diskontinuitas. Respons biquad diperiksa di beberapa frekuensi uji dengan toleransi ±0,1 dB.

Jumlah fungsi tes di pohon sumber pada tag v1.4.0, dihitung dari penanda #[test] dan #[tokio::test]:

Angka di atas adalah jumlah fungsi tes yang ada di sumber, bukan hasil satu kali jalan. CI menjalankan cargo fmt --check, cargo clippy -- -D warnings, cargo test, svelte-check, dan build aplikasi di matriks Windows dan Ubuntu.

Di luar tes otomatis, tiap milestone punya catatan verifikasi manualnya sendiri di docs/PROGRESS.md — untuk M8, misalnya, 43 pemeriksaan dari perintah, 22 dari jendela, 6 di jendela terkecil, dan 8 khusus kriteria selesai.

Milestone dan statusnya

Urutannya pernah diubah sekali: sesudah M7a yang dikerjakan adalah sebagian M10, lalu M8, dan M9 dilewati. Alasannya beserta utang yang timbul dicatat. Sesudah M8 tidak ada fitur baru yang masuk v1, dan v1.0.0 ditandai setelah biner rilis kedua sistem dijalankan dari keadaan benar-benar baru.

Tiga rilis sesudahnya juga tanpa fitur baru. v1.0.1 memperbaiki enam temuan dari sesi audit. v1.1.0 menambahkan bantuan di dalam aplikasi, supaya orang yang baru pertama membuka Onsa bisa memakainya tanpa bertanya kepada pemiliknya. v1.2.0 menyiapkan paket untuk tester: tiap jalur internet dibuktikan sekali terhadap layanan sungguhan, dan berkas pemasang Windows kini dibangun CI — karena build di mesin pemilik ternyata ikut menanam kunci AcoustID pribadinya ke dalam biner.

Fitur baru masuk lagi mulai v1.3.0 dan v1.4.0, keduanya mengikuti garis rilis yang diputuskan 25 September. Laporan tester tidak dijadikan gerbang rilis; yang datang masuk ke rilis patch berikutnya.

Batas yang diketahui

Ditulis apa adanya di README dan catatan rilis, bukan disembunyikan. Yang berlaku untuk v1.4.0:

• ffmpeg dan Deno opsional. Tanpa ffmpeg unduhan tetap berjalan, tapi audionya diambil apa adanya — tanpa tag dan sampul tertanam, dan konversi ke MP3 atau FLAC tidak tersedia. Tanpa Deno, sebagian format YouTube bisa tidak tersedia. Halaman Unduhan mengatakan keduanya.
• Antrean unduhan belum disimpan. Unduhan yang belum selesai hilang bila Onsa ditutup, dan hasilnya selalu masuk Unduhan di folder library pertama. Keduanya ditutup di v1.4.1.
• Sumber yang hanya menyediakan Opus ditolak dengan pesan, karena belum ada decoder Opus. Lebih baik ditolak di muka daripada berkasnya mendarat lalu tidak pernah muncul di library.
• Belum ada scrobble Last.fm.
• Linux baru dicoba di WSL, belum di mesin Linux sungguhan.
• Timing per kata sudah dibaca dan disimpan, tapi belum digambar per kata — barisnya yang menyala, bukan katanya.
• Ikon final belum ada, dan lisensi proyek sengaja ditahan.