Skip to content
omerfysPublic

About

Akıllı Masaüstü Robot Süpürgesi & Fizik Tabanlı Düzenleyici | Matter.js 2D Physics, Selection Box Regional Organizer, Electron & React 19

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Cleanfy — Akıllı Masaüstü Robot Süpürgesi & Fizik Tabanlı Düzenleyici

Windows 10 ve 11 için fizik simülasyonlu, LiDAR taramalı ve %100 güvenli masaüstü düzenleme robotu.
Masaüstünüz yaşayan bir oyun alanına dönüşsün: Matter.js çarpışma fiziği, Selection Box ile bölgesel dizilim, Türkçe sınıflandırma ve tek tıkla geri alma.

GitHub License GitHub Stars TypeScript React 19 Electron Matter.js Tailwind CSS 60 FPS Zero Data Loss


Cleanfy, Windows masaüstünü sıkıcı bir dosya listesinden çıkarıp yaşayan bir fizik ekosistemine dönüştüren açık kaynaklı bir masaüstü uygulamasıdır. Ekranda serbestçe dolaşan, engellerden kaçan ve döner fırçalarıyla tozu süpüren gerçekçi bir robot süpürge simülasyonu sunarken; arka planda masaüstündeki tüm dosyaları güvenli, geri alınabilir ve kural tabanlı bir hiyerarşiyle tertemiz klasörlere yerleştirir.

Başlangıç • Özellikler • Selection Box • Mimari • Güvenlik Garantisi • English Overview


Cleanfy Robot Physics & LiDAR Demo

▲ Gerçekçi 2.5D robot süpürge, LiDAR tarama lazeri, dönen fırçalar ve Matter.js sert cisim çarpışma fiziği


İçindekiler (Table of Contents)


Proje Vizyonu

Klasik masaüstü temizleyiciler ve düzenleme betikleri genellikle sıkıcı, ruhsuz ve riskli araçlardır. Bir butona basarsınız ve dosyalarınızın nereye gittiğini tam olarak göremeden kaybolur.

Cleanfy, bu deneyimi baştan aşağı yeniden tasarlar:

  1. Görsel & Kinetik Deneyim: Masaüstü simgeleriniz gerçek fiziksel nesneler haline gelir. Robot süpürge odanızı süpürür gibi masaüstünüzde devriye atar, LiDAR demetleriyle dosyaları tarar ve ön tamponuyla simgeleri yumuşakça iter.
  2. Kullanıcı Kontrolünde Doğal Dil Dizilimi: Selection Box aracı sayesinde ekranın istediğiniz bir köşesini (örneğin sağ üst veya sol sütun) fareyle seçip "buraya sadece oyunları koy" veya "buraya sadece klasörleri diz" diyebilirsiniz.
  3. Sıfır Risk & Güven: Dosyalar asla silinmez, üzerine yazılmaz; her adım SHA-256 özet doğrulamasıyla korunur ve tek tıkla eski haline geri döndürülebilir.

Özellikler (Features)

  • Gerçekçi 2D/2.5D Robot Süpürge Simülasyonu:
    • Bağımsız dönen üst LiDAR lazer kubbesi ve mavi tarama demeti.
    • Ön optik ve ultrasonik mesafe algılama sensörleri.
    • Yaylı ve esnek ön çarpışma tamponu (bumper).
    • Gövde altında sürekli dönen çift yan fırça ve dinamik zemin toz parçacıkları.
  • Matter.js 2D Sert Cisim Fiziği:
    • Gerçek kütle, sürtünme ve esneklik katsayıları.
    • Robot dosyalara çarptığında simgeler gerçekçi biçimde kayar ve birbirini iter.
    • İkonlar dik açılarını korur (angle = 0), yazıları ve rozetleri her zaman okunaklı kalır.
  • Selection Box & Bölgesel Düzenleme:
    • Ekranın herhangi bir noktasında dikdörtgen alan seçebilme.
    • Doğal dil Türkçe prompt desteği veya tek tıkla hazır kategori çipleri.
    • Hedef bölgeye uymayan dosyaları otomatik olarak bölge dışına kaydırma ve sadece istenen dosyaları nizami ızgaraya dizme.
  • Kompakt Glassmorphism Kontrol Menüsü:
    • Sağ üst köşede minimalist, gizlenebilir ve akıcı yay (spring) animasyonlu kontrol paneli.
    • İlk açılışta masaüstünü kapatmayan zarif rozet görünümü.
  • Akıllı Türkçe Kategori Tanıma:
    • 13 ana kategori ve onlarca alt klasör türü.
    • .url Steam / Epic / Riot oyun kısayollarını otomatik tespit eden oyun zekası.
  • Geri Alınabilir & SHA-256 Doğrulamalı İşlemler:
    • Yapılan tüm taşımalar tek tıkla geri alınabilir (UndoSession).
    • Çıktılar HTML, JSON ve Excel uyumlu CSV (UTF-8 BOM) olarak dışa aktarılabilir.

Selection Box ile Bölgesel Özel Dizilim

Cleanfy, tüm masaüstünü toptan temizlemek yerine belirli bölgeleri özelleştirmenize olanak tanır:

Cleanfy Selection Box Demo

▲ Ekranda dikdörtgen alan çizimi, doğal dil istek ("Buraya sadece oyunları koy"), plan onaylama ve otomatik ızgara yerleşimi

  1. Sağ üst menüden Alan Seç & Özel Diz butonuna tıklayın.
  2. Farenizle masaüstünün istediğiniz köşesinde bir dikdörtgen çizin.
  3. Açılan Glassmorphism penceresinde hazır çiplerden (🎮 Sadece Oyunlar, 📁 Sadece Klasörler, 📦 Sadece Arşivler, ☕ Jar & Kodlar, vb.) birini seçin ya da doğal dille isteğinizi yazın.
  4. + Bu Alanı Plana Ekle dedikten sonra Planı Onayla & Diz butonuna tıkladığınızda dosyalarınız seçtiğiniz bölgeye nizami olarak yerleştirilir.

Mimari & Çalışma Prensibi

flowchart TD
    A["Windows Masaüstü Başlatma (Electron + PowerShell API)"] --> B["Gerçek Desktop Yolu Tespiti (OneDrive & Registry)"]
    B --> C["Dosya Tarama & Türkçe Kategori Sınıflandırma"]
    
    C --> D1["Matter.js 2D Fizik Motoru (Canvas 60 FPS)"]
    C --> D2["Robot Süpürge Yapay Zekası (LiDAR & Devriye Gezintisi)"]
    C --> D3["Glassmorphism Kontrol Paneli (HUD & Modallar)"]
    
    D3 --> E1["Plan Önizleme & Hariç Tutma"]
    D3 --> E2["Selection Box Bölgesel Düzenleme"]
    D3 --> E3["Güvenli Taşıma & SHA-256 Doğrulama"]
    
    E3 --> F1["Kutlama & Canlı İstatistikler"]
    E3 --> F2["Tek Tıkla Geri Alma (Undo)"]
    E3 --> F3["HTML / CSV / JSON Rapor Export"]
Loading

%100 Türkçe Klasör & Kategori Hiyerarşisi

Cleanfy, dosyaları rastgele klasörlere tıkmak yerine profesyonel bir arşiv düzeni oluşturur:

Masaüstü/
├── 📁 Fotoğraflar ve Görseller/        (jpg, jpeg, png, webp, gif, bmp, tiff, ico, heic, raw)
├── 📁 Videolar/                         (mp4, mkv, mov, avi, webm, wmv, flv, m4v)
├── 📁 Müzikler ve Sesler/               (mp3, wav, flac, aac, ogg, m4a, wma)
├── 📁 Belgeler/
│   ├── 📁 PDF Belgeleri/               (pdf)
│   ├── 📁 Word Belgeleri/              (doc, docx, odt)
│   ├── 📁 Tablolar ve Hesaplamalar/    (xls, xlsx, csv, ods, tsv)
│   ├── 📁 Metin Dosyaları/             (txt, md, rtf, log)
│   └── 📁 Diğer Belgeler/              (ppt, pptx, odp, epub, mobi)
├── 📁 Yazılımlar ve Kurulum Dosyaları/ (exe, msi, msix, bat, cmd, ps1, iso, img)
├── 📁 Sıkıştırılmış Dosyalar/           (zip, rar, 7z, tar, gz, bz2, xz)
├── 📁 Yazılım ve Kod Projeleri/
│   ├── 📁 Python Projeleri/            (py, pyw, ipynb)
│   ├── 📁 Web Projeleri/               (html, css, js, ts, jsx, tsx, vue, svelte, json)
│   ├── 📁 Java Projeleri/              (java, jar, class)
│   └── 📁 Diğer Kod Dosyaları/         (c, cpp, cs, rs, go, php, rb, sql, sh, yaml)
├── 📁 Tasarım ve Çizim Dosyaları/      (psd, ai, blend, svg, xd, fig, sketch, dwg)
├── 📁 Oyunlar ve Oyun Kısayolları/     (Steam, Epic, Riot, Roblox, Minecraft ve URL kısayolları)
├── 📁 İnternet Kısayolları/            (url, webloc)
├── 📁 Yedekleme Dosyaları/             (bak, old, backup, dump)
├── 📁 Geçici ve İncelenecek Dosyalar/  (tmp, temp, uzantısız dosyalar)
└── 📁 Diğer Dosyalar/                  (sınıflandırılamayan diğer uzantılar)

Note

Sıfır dosyası olan kategoriler için asla boş klasör açılmaz. Masaüstünüzde önceden var olan kişisel klasörlerinize asla izinsiz dokunulmaz.


Kesin Güvenlik & Veri Bütünlüğü Garantisi

  1. Silme API'si Bulunmaz: Kod tabanında dosya silme (fs.unlink, rmdir, trash) veya Geri Dönüşüm Kutusu'na atma işlevi kesinlikle yer almaz.
  2. SHA-256 İçerik Doğrulaması: Dosya taşınmadan önce ve taşındıktan sonra sağlama toplamı (hash) hesaplanır; 1 bayt bile uyuşmazsa işlem derhal durdurulur.
  3. Üzerine Yazmama Koruması: Hedef klasörde aynı isimde dosya varsa üzerine yazılmaz; otomatik olarak dosya (1).ext, dosya (2).ext şeklinde güvenle adlandırılır.
  4. Masaüstü Dizin Sınırı (No Path Traversal): Taşıma işlemleri kesinlikle kullanıcının Masaüstü diziniyle sınırlandırılmıştır.

Hızlı Başlangıç & Kurulum

Gereksinimler

  • İşletim Sistemi: Windows 10 veya Windows 11 (64-bit)
  • Node.js: v18+ (Önerilen: Node.js 20 veya 22 LTS)

1. Depoyu Klonlayın

git clone https://github.com/omerfys/Cleanfy.git
cd Cleanfy

2. Bağımlılıkları Yükleyin

npm install

3. Tek Tıkla Başlatın (Windows)

Klasördeki start.bat dosyasına çift tıklayarak uygulamayı derlenmiş .exe sürümüyle anında çalıştırabilirsiniz:

start.bat

4. Geliştirici Modunda Çalıştırma (Canlı Yenileme)

npm start

5. Windows EXE Olarak Paketleme

npm run package

Çıktı dosyası release/win-unpacked/Cleanfy Robot Süpürge.exe dizininde oluşturulur.


Glassmorphism Kontrol Paneli

Cleanfy Multi-Screen & HUD Drag Demo

▲ Sürüklenebilir minimalist Glassmorphism HUD ve Ekran 1, Ekran 2, Ekran 3 çoklu monitör geçişi

Sağ üst köşedeki kompakt panel üzerinden tüm operasyonları yönetebilirsiniz:

Buton / Eleman İşlev
Tara Masaüstünü anlık olarak tarar, simgeleri fizik dünyasına aktarır.
Başlat Güvenli temizlik sürecini başlatır; robot her dosyaya giderek taşır.
Duraklat / Devam Temizlik sürecini istediğiniz saniyede duraklatıp devam ettirir.
Durdur Temizliği durdurur ve robotu serbest dolaşma moduna geçirir.
Alan Seç & Özel Diz Ekranda kutu çizerek belirli dosya tiplerini o alana toplar.
Plan Dosyaları tek tek inceleyebileceğiniz ve hariç tutabileceğiniz önizleme modalı.
Rapor Yapılan taşımaların geçmişini ve dosya yollarını gösteren detaylı rapor.
Geri Al Son temizlik oturumunda taşınan tüm dosyaları anında eski yerine döndürür.

Geri Alma (Undo) & Raporlama

Cleanfy Preview Plan & Undo Demo

▲ Masaüstü Düzenleme Planı inceleme, onaylama ve işlem sonrası tek tıkla Geri Al (Undo) güvencesi

  • Oturum Bazlı Geri Alma: Temizlik işlemi tamamlandığında oturum kaydı hafızaya alınır. Geri Al butonuna bastığınızda taşınan tüm dosyalar güvenle orijinal masaüstü konumlarına geri çekilir.
  • Dışa Aktarma Formatları:
    • HTML Raporu: Renkli, filtrelenebilir ve yazdırmaya hazır görsel rapor.
    • CSV Raporu: Microsoft Excel ile tam uyumlu Türkçe karakter destekli UTF-8 BOM CSV çıktısı.
    • JSON Raporu: Otomasyonlar ve log arşivleri için standart JSON verisi.

Sıfır Donma & Optimize Edilmiş Fizik Motoru

  • 60 FPS Hardware-Accelerated Canvas: HTML5 Canvas 2D üzerinde GPU hızlandırmalı pürüzsüz çizim döngüsü.
  • Fail-Safe Render Döngüsü: Çizim fonksiyonu try/catch/finally koruması altındadır; beklenmeyen anlık istisnalar render akışını asla durdurmaz.
  • Akıllı Çarpışma Filtreleme: Dosyalar zemin sürtünmesiyle dengelenir, gereksiz takılmaları önleyen akıllı robot rota algoritması devrededir.

Sıkça Sorulan Sorular (FAQ)

1. Cleanfy dosyalarımı silebilir veya kaybedebilir mi? Kesinlikle hayır. Cleanfy'ın kaynak kodunda hiçbir dosya silme komutu bulunmaz. Tüm işlemler SHA-256 sağlamasıyla kontrol edilen güvenli taşıma işlemidir ve tek tıkla geri alınabilir.
2. Masaüstündeki mevcut klasörlerime ne olur? Önceden oluşturduğunuz kullanıcı klasörlerine kesinlikle dokunulmaz. Cleanfy yalnızca sahipsiz ve dağınık dosya/kısayolları düzenler.
3. OneDrive masaüstüm varsa çalışır mı? Evet. Cleanfy, Windows Kayıt Defteri (Registry) ve özel PowerShell tespit mekanizmasıyla OneDrive masaüstü yönlendirmelerini otomatik olarak tanır.
4. Selection Box ile seçtiğim alanı nasıl sıfırlarım? Sağ üst menüde beliren "Sıfırla" butonuna tıklayarak özel alana sabitlenen dosyaları anında serbest bırakabilirsiniz.

English Overview

Cleanfy is an intelligent, physics-driven desktop organization tool and robot vacuum simulator designed for Windows 10 & 11. Built with Electron, React 19, TypeScript, and Matter.js, it turns your cluttered desktop into an interactive physics sandbox while categorizing and moving files into clean, organized Turkish directories with zero risk of data loss.

Key Highlights:

  • Kinetic Physics Engine: Files act as physical bodies that react to the robot's bumper, brushes, and momentum.
  • Selection Box Regional Organizer: Drag a selection rectangle anywhere on the screen and instruct the robot to gather specific file types (games, folders, code, archives) into that precise area.
  • Strict Zero-Data-Loss Safety: No deletion APIs, SHA-256 verification before and after moving, collision-safe renaming (file (1).ext), and single-click Undo.
  • Compact Glassmorphism HUD: Sleek top-right controller that stays out of your way until summoned.

SEO Anahtar Kelimeler (SEO Index)

Cleanfy • Desktop Organizer • Masaüstü Robot Süpürge • Windows Desktop Cleaner • Matter.js Physics • Electron Desktop App • React 19 • TypeScript • Canvas 2D Simulation • Interactive Vacuum Robot • Selection Box Organizer • Otomatik Dosya Düzenleyici • Güvenli Masaüstü Temizleyici • Omerfy • Creative Coding • Zero Data Loss • Undo Desktop Organization


Lisans & Yazar

Bu proje MIT Lisansı altında açık kaynak olarak sunulmuştur.

Geliştirici: @omerfys
GitHub Deposu: https://github.com/omerfys/Cleanfy

Projeyi beğendiyseniz GitHub üzerinden yıldız vermeyi unutmayın!

About

Akıllı Masaüstü Robot Süpürgesi & Fizik Tabanlı Düzenleyici | Matter.js 2D Physics, Selection Box Regional Organizer, Electron & React 19

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages