Metadata-Version: 2.4
Name: syncfotos
Version: 0.1.21
Summary: Eina per comparar, revisar i classificar fotografies i videos entre directoris.
Author: SyncFotos
License: MIT
Project-URL: Homepage, https://github.com/AureliRoura/syncFotos
Project-URL: Repository, https://github.com/AureliRoura/syncFotos
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pillow>=10.0.0
Requires-Dist: python-vlc>=3.0.0
Requires-Dist: opencv-python>=4.8.0
Requires-Dist: numpy
Provides-Extra: similar
Requires-Dist: transformers; extra == "similar"

# SyncFotos

Aplicació en Python per sincronitzar, revisar i classificar fotografies i vídeos entre dos directoris.

L'objectiu és detectar els fitxers que existeixen al directori d'origen però no al de destinació i facilitar-ne la revisió abans de moure'ls a la ubicació definitiva.

---

## Característiques

* 📷 Visualització d'imatges.
* 🎥 Reproducció de vídeos integrada amb VLC.
* ⏯ Controls de reproducció (Play/Pausa i barra de progrés).
* 🔍 Comparació entre dos directoris.
* 📂 Detecció de fitxers inexistents al directori de destinació.
* 📁 Moure fitxers a una carpeta seleccionada.
* 📁 Moure fitxers a l'última carpeta utilitzada.
* 📅 Moure fitxers automàticament segons la data deduïda del nom.
* 🧩 Cerca de fotos semblants en moure una foto, amb selecció i ampliació.
* ✅ Marcar fotos del carrusel (màxim 30 visibles) perquè es moguin amb la foto actual al mateix destí.
* 🖼 Obrir una fotografia amb un editor extern.
* 💬 Tooltips amb informació sobre el directori de destinació.

## Comparació de fitxers

Per a imatges, SyncFotos calcula un SHA-256 dels píxels decodificats i orientats: ignora EXIF i altres diferències de codificació que no canvien la imatge visible. Per a vídeos i altres fitxers, compara el SHA-256 dels bytes originals.

Després d'actualitzar aquesta versió, el primer escaneig recalcula els hashes de les imatges per actualitzar la cache.

---

## Organització automàtica per data

Si el fitxer té un nom com:

```text
PXL_20251129_080003803.TS.mp4
2025-11-29 08.00.03.jpg
```

SyncFotos detecta la data (`2025-11-29`) i proposa moure'l a:

```text
2025/
└── 2025_11_29/
```

Si el nom del fitxer no conté una data reconeguda, aquesta opció no es mostra.

---

## Fotos semblants

Quan es mou una foto, SyncFotos busca entre les fotos pendents les que s'hi assemblen i les mostra en una finestra per decidir-ne el moviment. Cap foto surt marcada per defecte. Un clic sobre una miniatura l'amplia.

Criteris, per ordre:

1. Proximitat temporal (±10 minuts), segons l'EXIF, el nom del fitxer o la data de modificació.
2. Localització GPS (menys de 200 m), si les dues fotos en tenen.
3. Similitud d'embeddings (DINOv2 si està instal·lat; si no, un embedding simple).
4. Confirmació geomètrica amb SIFT i RANSAC per als casos dubtosos.

---

## Requisits

* Python 3.13 recomanat (el paquet requereix Python 3.11 o superior).
* VLC Media Player instal·lat, per reproduir vídeos a la interfície.

Les dependències Python (`Pillow`, `python-vlc`, `opencv-python` i `numpy`) s'instal·len automàticament amb el paquet.

---

## Instal·lació

Es recomana fer servir un entorn virtual o un entorn conda amb Python 3.13:

```bash
conda create -n syncfotos python=3.13
conda activate syncfotos
```

o bé:

```bash
py -3.13 -m venv .venv
.venv\Scripts\activate
```

En altres sistemes, substitueix `py -3.13` per `python3.13`.

### 1. Ús normal (des de PyPI)

```bash
python -m pip install syncfotos
```

### 2. Ús normal amb millor detecció de fotos semblants (DINOv2)

DINOv2 necessita `torch` i `transformers`. La variant de `torch` (CPU o GPU NVIDIA amb CUDA) depèn del maquinari i no es pot triar amb pip normal. Per això, després d'instal·lar el paquet, executa:

```bash
python -m pip install syncfotos
sync-fotos-instala-dino
```

L'ordre detecta una GPU NVIDIA i instal·la la variant adequada. Opcions:

```bash
sync-fotos-instala-dino --cpu                     # força CPU
sync-fotos-instala-dino --cuda                    # força CUDA
sync-fotos-instala-dino --index-url <URL>         # índex de PyTorch concret (per exemple cu126)
```

La primera vegada que s'usa, DINOv2 descarrega el model des de Hugging Face. Si no hi és, la cerca funciona igualment amb l'embedding simple i SIFT.

### 3. Des del codi font (desenvolupament)

```bash
git clone https://github.com/AureliRoura/SyncFotos.git
cd SyncFotos
python -m pip install -e .
```

El mode editable (`-e`) aplica els canvis del codi sense reinstal·lar. L'ordre s'ha d'executar des de la carpeta que conté `pyproject.toml`.

Per instal·lar una còpia normal, sense mode editable: `python -m pip install .`.

### 4. Des d'un wheel o sdist construït localment

```bash
python -m pip install dist/syncfotos-*.whl
```

### 5. Actualitzar o desinstal·lar

```bash
python -m pip install --upgrade syncfotos
python -m pip uninstall syncfotos
```

### Problemes habituals

* `sync-fotos` no es reconeix: l'entorn on has instal·lat el paquet no està activat, o s'ha instal·lat amb una versió de Python anterior a 3.11.
* `pip install -e .` diu que no troba `pyproject.toml`: no ets a la carpeta del projecte.
* Els vídeos no es reprodueixen: falta VLC Media Player.

---

## Execució

Un cop instal·lat, les ordres són directament al terminal:

```bash
# Interfície gràfica principal
sync-fotos-gui

# També obre la interfície gràfica si no es passen arguments
sync-fotos

# Comparació per terminal (origen i destinació són obligatoris)
sync-fotos "D:\Fotos\Origen" "D:\Fotos\Desti" --generar-sortida

La cerca de fotos semblants durant la revisió està activada per defecte. Per desactivar-la des del terminal, afegeix `--no-cercar-semblants`; a la finestra de configuració, desmarca **Cercar fotos semblants**.

# Eines addicionals
sync-fotos-duplicats
sync-fotos-fitxers-buits "D:\Fotos"
```

Per veure totes les opcions de la comparació:

```bash
sync-fotos --help
```

---

## Construcció i publicació a PyPI

La versió del paquet es determina a partir del tag Git `vX.Y.Z`. Cada publicació necessita un tag nou: no es pot reutilitzar una versió ja publicada.

### Construcció local

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
```

Es generen a `dist/` un paquet `.whl` i un arxiu `.tar.gz`.

### Pujada manual

```bash
python -m twine upload dist/*
```

Per fer abans una prova a TestPyPI:

```bash
python -m twine upload --repository testpypi dist/*
```

### Publicació automàtica amb GitHub Actions

El workflow [`Build and Publish`](.github/workflows/release.yml) construeix els artefactes i els publica a PyPI quan s'envia un tag `v*`.

Per activar-ho:

1. Comprova que el nom `syncfotos` estigui disponible a PyPI.
2. A la configuració de PyPI, afegeix aquest repositori GitHub com a Trusted Publisher, indicant l'usuari, el repositori i el workflow `.github/workflows/release.yml`.
3. Envia els canvis al repositori i crea i envia un tag de versió:

   ```bash
   git tag v1.0.0
   git push origin v1.0.0
   ```

El workflow publica la versió corresponent al tag. No cal cap token d'API de PyPI amb Trusted Publishing. No facis també una pujada manual de la mateixa versió.

---

## Flux de treball

1. Compara el directori origen amb el directori destinació.
2. Detecta els fitxers que falten.
3. Mostra cada fitxer (foto o vídeo).
4. L'usuari pot:

   * Moure'l a una carpeta.
   * Moure'l a l'última carpeta utilitzada.
   * Moure'l segons la data del nom.
   * Obrir-lo amb un editor.
   * Saltar-lo.

5. En moure una foto, es proposen les fotos semblants.
6. En finalitzar es mostra un resum de les accions realitzades.

---

## Llibreries utilitzades

* argparse
* pathlib
* shutil
* tkinter
* Pillow
* python-vlc
* OpenCV
* NumPy
* PyTorch i Transformers (opcionals, per a DINOv2)

---

## Estructura del projecte

```text
syncFotos/
├── pyproject.toml
├── README.md
├── src/syncfotos/
│   ├── core/    # lògica (sincronització, revisió, similitud)
│   ├── ui/      # interfícies gràfiques
│   └── tools/   # eines addicionals
└── .github/workflows/release.yml
```

---

## Funcionalitats previstes

* [ ] Configuració persistent.
* [ ] Selecció de l'editor d'imatges des de la interfície.
* [ ] Dreceres de teclat.
* [ ] Millorar la reproducció de vídeos.
* [ ] Suport per a més formats de noms de fitxer.
* [ ] Suport per a fotos HEIC.
* [ ] Generació d'un executable per a Windows.

---

## Llicència

Aquest projecte es distribueix sota la llicència MIT.

---

## Autor

Desenvolupat com a eina personal per facilitar l'organització de fotografies i vídeos.
