Heimdall Sort 🛡️

En desktop-applikasjon for å sortere bilder til mappestrukturer og finne duplikater ved hjelp av perceptuell hashing.

Funksjoner

• 🖼️ Bildesortering: Organiser bilder i mappestrukturer basert på metadata, dato, eller manuell kategorisering
• 🎥 Videostøtte: Full støtte for sortering og visning av videofiler (.mp4, .mov, etc) med automatisk thumbnail-generering.
• 📎 Sidecar-støtte: Håndterer automatisk tilhørende metadata-filer (.xmp, .json, .aae) ved flytting, sletting og endring.
• 🔍 Duplikatdeteksjon: Finn duplikate og nesten-like bilder ved hjelp av:
  • Eksakt matching (fil-hash)
  • Perceptuell hashing (pHash, dHash, aHash)
  • Visuell likhetsammenligning side-om-side
• ⚡ Rask ytelse:
  • Rust-backend for effektiv bildebehandling
  • O(N log N) duplikatdeteksjon med BK-Tree 🌳
  • Persistent Caching av hasher for umiddelbar respons 🚀
  • Virtuell Scrolling for å håndtere titusenvis av bilder sømløst
• 🎨 Moderne UI: Responsivt "Premium Dark" brukergrensesnitt med Toast-notifikasjoner bygget med modulet CSS.

Teknologi

• Frontend: TypeScript, HTML, Modular CSS (Vite)
• Backend: Rust (via Tauri v2)
• Bildebehandling: image-rs, img_hash, ffmpeg (via sidecar)

Kom i gang

Forutsetninger

• Rust (via rustup)
• Node.js 18+
• Linux: sudo apt install libwebkit2gtk-4.1-dev build-essential libssl-dev libayatana-appindicator3-dev librsvg2-dev

Installasjon

git clone https://github.com/Hawk-on/HeimdallSort.git
cd HeimdallSort
npm install
npm run tauri dev

Bidra til prosjektet

Branching-strategi

Vi bruker en enkel branching-modell:

Branch	Formål
master	Stabil, produksjonsklar kode
dev	Aktiv utvikling, neste release
feature/*	Nye funksjoner (brancher fra dev)
fix/*	Bugfikser (brancher fra dev)

Workflow

1. Opprett feature branch fra dev:

   git checkout dev
   git pull origin dev
   git checkout -b feature/min-nye-funksjon

2. Gjør endringer og commit:

   git add .
   git commit -m "feat: beskrivelse av endring"

3. Push og lag Pull Request:

   git push -u origin feature/min-nye-funksjon
   gh pr create --base dev --title "feat: beskrivelse"

4. Etter godkjenning: Merge til dev

5. Release: dev merges til master når features er testet

Commit-konvensjoner

Vi følger Conventional Commits:

feat: ny funksjonalitet
fix: bugfiks
docs: dokumentasjonsendringer
refactor: kodeomstrukturering
test: tester
chore: vedlikehold (deps, config)

Prosjektstruktur

HeimdallSort/
├── src/                    # Frontend (TypeScript)
│   ├── app.ts              # Hovedapplikasjon
│   ├── main.ts             # Entry point
│   └── styles/             # CSS
├── src-tauri/              # Backend (Rust)
│   ├── src/
│   │   ├── commands/       # Tauri IPC kommandoer
│   │   └── services/       # Forretningslogikk
│   └── Cargo.toml
├── docs/                   # Dokumentasjon
└── .agent/workflows/       # AI-assistent workflows

Lisens

MIT