Mosavid

Mosavid, tek bir görseli binlerce küçük parçadan oluşan bir mozaik olarak yeniden kurup bunu video halinde üreten bir Python aracı. Projeyi, klasik photomosaic fikrini yalnızca statik çıktı veren bir betik olmaktan çıkarıp izlenebilir, paylaşılabilir ve sosyal medya odaklı bir üretim aracına dönüştürmek için hazırladım.

Neyi çözüyor?

Photomosaic üretmek tek başına ilginç olsa da çoğu araç burada duruyor. Mosavid’de odak noktası yalnızca son görüntü değil, mozaiğin nasıl oluştuğunu da görsel olarak anlamlı hale getirmekti.

Bu yüzden proje:

• statik mozaik çıktı üretebiliyor
• mozaiğin adım adım kurulduğu oluşum videoları hazırlayabiliyor
• aynı içeriği hızlandırılmış, karşılaştırmalı ve hazır ayar akışlarına uyarlayabiliyor
• farklı en-boy oranı ihtiyaçlarını tek bir CLI altında toplayabiliyor

Ana kullanım senaryoları

Oluşum videosu (satisfying)

Karoları sırayla yerleştirip izleme hissini öne çıkaran çıktı üretir. Spiral, rastgele ya da satır satır gibi yerleşim stratejileri ile birlikte farklı animasyon tipleri kullanılabiliyor.

Hızlandırılmış video (timelapse)

Mozaiğin oluşumunu hedef süreye sığdıran hızlandırılmış bir çıktı üretir. Özellikle demo ve kısa ürün tanıtımı videoları için pratik bir mod.

Karşılaştırma videosu (comparison)

Orijinal görsel ile mozaik sonucu aynı akışta gösterir. Önce/sonra mantığıyla ilerlediği için özellikle sunum ve vitrin kullanımına uygun.

Statik görsel ve videodan videoya

Araç yalnızca video üretmekle sınırlı değil. İstenirse doğrudan mozaik görsel oluşturabiliyor veya video girişindeki her kareyi mozaikleyerek videodan videoya çıktı verebiliyor.

Öne çıkan tarafları

• Tek araç içinde birden fazla üretim modu sunması
• Komut satırı seviyesinde animasyon tipi, yerleşim sırası, çözünürlük ve en-boy oranı kontrolü vermesi
• Sosyal medya odaklı hazır ayar yaklaşımıyla kısa denemeleri hızlandırması
• quick-test akışıyla maliyetli render sürecine girmeden hızlı önizleme sağlaması
• Hazır karo görsel havuzu ile ilk kullanımı kolaylaştırması

Kısa örnekler

# Paketi kur
pip install mosavid

# Mozaik oluşumunu video olarak üret
mosavid satisfying \
  --input examples/1.jpg \
  --output mosaic.mp4 \
  --animation drop_in \
  --order spiral \
  --tiles-per-second 5 \
  --stride 10

# Hızlı test üret
mosavid quick-test -i examples/1.jpg

Teknik yapı

Proje, photomosaic üretimini tek parça bir betik yerine alt modüllere ayıran daha düzenli bir yapıyla ilerliyor.

• core/: karo yükleme, renk eşleme ve mozaik yerleşim mantığı
• generators/: oluşum, hızlandırılmış ve karşılaştırmalı çıktı üreticileri
• effects/: animasyonlar, geçişler, ilerleme göstergesi ve metin yerleştirme katmanı
• audio/: arka plan müziği ve ses efektleri
• config/: hazır ayarlar ve varsayılan seçenekler

Bu yapı sayesinde aynı mozaik motoru farklı video modlarında tekrar kullanılabiliyor. Kullanım deneyimi tek bir CLI altında kalırken çıktı biçimleri modüler olarak ayrılıyor.

Dikkat çekici ürün kararları

• Çoklu çıktı modu: Aynı çekirdek sistem üzerinden farklı formatlarda içerik üretilebiliyor
• Hazır ayar yaklaşımı: Kullanıcıyı onlarca parametreyle baş başa bırakmadan kısa yol sunuyor
• En-boy oranı desteği: 16:9, 9:16 ve 1:1 formatları doğrudan destekliyor
• Yerleşim algoritmaları: Sadece görsel kaliteyi değil animasyon hissini de etkileyen önemli bir karar alanı açıyor

Bağlantılar

• GitHub deposu: github.com/aliyilmazco/mosavid
• Sürüm: v1.0.0

Not

Mosavid, yaratıcı kodlama ile araç ergonomisini birleştiren bir yan proje. Teknik olarak görüntü işleme, eşleme ve render akışına dayanıyor; ürün tarafında ise hızlı deneme, tekrar üretilebilir çıktı ve paylaşılabilir kısa video üretimi üzerine kuruluyor.