braiNOTES, ders PDF'leri üzerine el yazısı not almayı tek bir browser sekmesine taşıyor — hesap ya da kurulum gerekmiyor

Hacker News'te görücüye çıkan braiNOTES adlı açık kaynaklı proje, el yazısı not almayı sıradan bir browser sekmesinin içindeki ders slaytlarına taşıyor. Projenin GitHub deposuna göre kurulacak bir şey de, oluşturulacak bir hesap da yok: defterler, sayfalar ve yüklenen PDF'ler kullanıcının kendi makinesinde kalıyor, arada hiçbir sunucu bulunmuyor.

Uygulama ne yapıyor

Proje kendisini, dersler göz önünde bulundurularak oluşturulmuş, OneNote veya GoodNotes gibi kalemle öncelikli not uygulamalarının tarayıcı tabanlı karşılığı olarak tanımlıyor. Ders slaytları notlarınızın yanındaki bir panelde durabilir ya da PDF doğrudan üzerine yazdığınız kağıt olabilir. Bir slaytın bölümleri de deftere kesilip yapıştırılabilir.

Araç seti dijital el yazısının temellerini kapsıyor: tamamı basınca duyarlı tükenmez kalem, dolma kalem, marker, kurşun kalem ve fosforlu kalem araçları; boş, çizgili, kareli ve noktalı kağıtlar; kenarları olmadan kaydırılan whiteboard'lar. Sayfalar ayrıca görsel, şekil ve metin barındırabilir; lasso mevcut mürekkebi taşır, silgi onu kaldırır, laser pointer ise sunumlar sırasında işinize yarar. Tek tuşlu kısayollar araçlar arasında geçiş yapar, geri kalanı Ctrl+K altındaki komut paleti halleder.

Bitmiş çalışma, özgün slayt sayfaları gömülü ve el yazısının vektör grafik olarak üstüne katmanlanmış halde PDF olarak dışa aktarılır; tek tek sayfalar PNG görsel olarak da kaydedilebilir. Tüm defterler yedekleme ya da paylaşım için .brainotes dosyaları olarak paketlenebilir — depo, bunların defter verisini sayfa başına bir JSON dosyası olmak üzere ekli PDF'leri ve resimleri barındıran sıradan zip arşivleri olduğunu açıklıyor. Durum tarayıcının IndexedDB deposunda tutulduğu ve her değişiklikten kısa süre sonra otomatik kaydedildiği için, depoya göre uygulama bir kez açıldıktan sonra çevrimdışı çalışmaya devam ediyor.

Mürekkep hattı nasıl çalışıyor

README ayrıca mühendisliğin büyük kısmının bulunduğu render yaklaşımını belgeliyor. Vuruşlar, kalem koordinatlarını ve basınç verilerini dolgu konturlarına dönüştüren perfect-freehand kütüphanesinden geliyor ve kalem hareket ettiği anda çiziliyorlar. Gürültülü pointer girdisine sıkça uygulanan bir yumuşatma tekniği olan one-euro filtresi, titrek el yazısını gerçek zamanlı olarak yumuşatıyor; kalem kalkınca daha hafif bir yeniden işleme turu devreye giriyor.

Duyarlı kalabilmek için mürekkep önbelleğe alınmış canvas tile'larına boyanıyor ve yalnızca gerçekten değişen tile'lar yeniden çiziliyor. PDF'ler bir web worker içinde pdf.js tarafından render ediliyor ve yalnızca o an görünen sayfalar, mevcut zoom seviyesinde rasterleştiriliyor.

Kaputun altında Svelte

Stack, TypeScript ile yazılmış, SvelteKit'in static adapter'ını kullanan Svelte 5. PDF okumayı pdf.js, PDF yazımını pdf-lib'in bir çatalı olan pdfme üstleniyor; idb IndexedDB'yi sarıyor, dosyalar ise fflate ve browser-fs-access ile ele alınıyor. Proje MIT lisanslı; pnpm ile çalıştırılabilen testler ve tip kontrolleri içeriyor ve düz bir statik site olarak derleniyor — yani bir üniversite ya da herhangi bir kişi kendi kopyasını self-host edebilir. Barındırılan bir örnek halihazırda notes.swimmingbrain.dev adresinde çalışıyor.

Neden önemli

Ders PDF'leri üzerine el yazısı ile not almak, büyük ölçüde hesap isteyen, başka birinin bulutuna senkronize olan ücretli ve kurulum gerektiren uygulamaların alanıydı. braiNOTES tüm iş akışının — basınca duyarlı mürekkep, PDF render etme, otomatik kaydetme, çevrimdışı kullanım ve vektör dışa aktarma — standart browser API'leriyle client-side çalışabileceğini gösteriyor. Bu, kısıtlı donanımdaki öğrenciler için kurulum engelini kaldırıyor ve gizlilik sorusunu sorulmadan yanıtlıyor: sunucu yoksa, notlar oradan sızamaz.

Açık .brainotes formatı ve MIT lisansı ayrıca çalışmaların kaybolabilecek ya da şartlarını değiştirebilecek bir servisin içinde sıkışıp kalmadığı anlamına geliyor. Geliştiriciler için proje, gecikmeye duyarlı çizim uygulamaları için canvas-tile-plus-worker deseninin kompakt ve okunabilir bir örneği; öğrenciler için ise slayt dosyasının kendisi kadar hızlı açılan ücretsiz bir ders aracı.