syncfotos 1.0.0__tar.gz

syncfotos-1.0.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: syncfotos
+Version: 1.0.0
+Summary: Eina per comparar, revisar i classificar fotografies i videos entre directoris.
+Author: SyncFotos
+License-Expression: 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
+
+# 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.
+* 🖼 Obrir una fotografia amb un editor extern.
+* 💬 Tooltips amb informació sobre el directori de destinació.
+
+---
+
+## Organització automàtica per data
+
+Si el fitxer té un nom com:
+
+```text
+PXL_20251129_080003803.TS.mp4
+```
+
+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.
+
+---
+
+## Requisits
+
+* Python 3.11 o superior
+* VLC Media Player instal·lat
+
+Llibreries Python:
+
+```bash
+pip install pillow python-vlc opencv-python
+```
+
+---
+
+## Execució
+
+```bash
+python sync_fotos.py
+```
+
+Per veure totes les opcions disponibles:
+
+```bash
+python sync_fotos.py --help
+```
+
+També es pot executar com a paquet (un cop instal.lat):
+
+```bash
+sync-fotos --help
+sync-fotos-gui
+sync-fotos-duplicats
+sync-fotos-fitxers-buits "D:\\Fotos"
+```
+
+---
+
+## Empaquetat i distribució
+
+Construcció local del paquet:
+
+```bash
+python -m pip install --upgrade build
+python -m build
+```
+
+Es generen dos artefactes a `dist/`:
+
+* `syncfotos-<versio>.tar.gz`
+* `syncfotos-<versio>-py3-none-any.whl`
+
+Instal.lació local de prova:
+
+```bash
+python -m pip install dist/syncfotos-*.whl
+```
+
+---
+
+## Publicació amb GitHub Actions
+
+El workflow [`Build and Publish`](.github/workflows/release.yml) fa:
+
+1. Build de wheel + sdist.
+2. Publicació d'artefactes del build.
+3. Publicació a PyPI quan fas push d'un tag `v*` (per exemple `v1.0.0`).
+
+Passos per activar-ho:
+
+1. A [`pyproject.toml`](pyproject.toml), canvia els URLs `OWNER/REPO` pel teu repositori real.
+2. A PyPI, crea el projecte `syncfotos` (o canvia el nom a `pyproject.toml` si ja existeix).
+3. Configura Trusted Publishing de PyPI per aquest repositori GitHub.
+4. Fes commit i push.
+5. Crea un tag de release:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+---
+
+## 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 finalitzar es mostra un resum de les accions realitzades.
+
+---
+
+## Llibreries utilitzades
+
+* argparse
+* pathlib
+* shutil
+* tkinter
+* Pillow
+* python-vlc
+* OpenCV
+* datetime
+* re
+
+---
+
+## Estructura del projecte
+
+```text
+syncFotos/
+│
+├── sync_fotos.py
+├── README.md
+├── .gitignore
+├── cache/
+└── ...
+```
+
+---
+
+## 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.
+* [ ] Generació d'un executable per a Windows.
+
+---
+
+## Captura de pantalla
+
+Es recomana afegir una o més captures de la interfície aquí.
+
+```markdown
+![Captura principal](docs/screenshot.png)
+```
+
+---
+
+## 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.

syncfotos-1.0.0/README.md

@@ -0,0 +1,198 @@
+# 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.
+* 🖼 Obrir una fotografia amb un editor extern.
+* 💬 Tooltips amb informació sobre el directori de destinació.
+
+---
+
+## Organització automàtica per data
+
+Si el fitxer té un nom com:
+
+```text
+PXL_20251129_080003803.TS.mp4
+```
+
+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.
+
+---
+
+## Requisits
+
+* Python 3.11 o superior
+* VLC Media Player instal·lat
+
+Llibreries Python:
+
+```bash
+pip install pillow python-vlc opencv-python
+```
+
+---
+
+## Execució
+
+```bash
+python sync_fotos.py
+```
+
+Per veure totes les opcions disponibles:
+
+```bash
+python sync_fotos.py --help
+```
+
+També es pot executar com a paquet (un cop instal.lat):
+
+```bash
+sync-fotos --help
+sync-fotos-gui
+sync-fotos-duplicats
+sync-fotos-fitxers-buits "D:\\Fotos"
+```
+
+---
+
+## Empaquetat i distribució
+
+Construcció local del paquet:
+
+```bash
+python -m pip install --upgrade build
+python -m build
+```
+
+Es generen dos artefactes a `dist/`:
+
+* `syncfotos-<versio>.tar.gz`
+* `syncfotos-<versio>-py3-none-any.whl`
+
+Instal.lació local de prova:
+
+```bash
+python -m pip install dist/syncfotos-*.whl
+```
+
+---
+
+## Publicació amb GitHub Actions
+
+El workflow [`Build and Publish`](.github/workflows/release.yml) fa:
+
+1. Build de wheel + sdist.
+2. Publicació d'artefactes del build.
+3. Publicació a PyPI quan fas push d'un tag `v*` (per exemple `v1.0.0`).
+
+Passos per activar-ho:
+
+1. A [`pyproject.toml`](pyproject.toml), canvia els URLs `OWNER/REPO` pel teu repositori real.
+2. A PyPI, crea el projecte `syncfotos` (o canvia el nom a `pyproject.toml` si ja existeix).
+3. Configura Trusted Publishing de PyPI per aquest repositori GitHub.
+4. Fes commit i push.
+5. Crea un tag de release:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+---
+
+## 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 finalitzar es mostra un resum de les accions realitzades.
+
+---
+
+## Llibreries utilitzades
+
+* argparse
+* pathlib
+* shutil
+* tkinter
+* Pillow
+* python-vlc
+* OpenCV
+* datetime
+* re
+
+---
+
+## Estructura del projecte
+
+```text
+syncFotos/
+│
+├── sync_fotos.py
+├── README.md
+├── .gitignore
+├── cache/
+└── ...
+```
+
+---
+
+## 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.
+* [ ] Generació d'un executable per a Windows.
+
+---
+
+## Captura de pantalla
+
+Es recomana afegir una o més captures de la interfície aquí.
+
+```markdown
+![Captura principal](docs/screenshot.png)
+```
+
+---
+
+## 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.

syncfotos-1.0.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "syncfotos"
+version = "1.0.0"
+description = "Eina per comparar, revisar i classificar fotografies i videos entre directoris."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+  { name = "SyncFotos" }
+]
+dependencies = [
+  "pillow>=10.0.0",
+  "python-vlc>=3.0.0",
+  "opencv-python>=4.8.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/AureliRoura/SyncFotos"
+Repository = "https://github.com/AureliRoura/SyncFotos"
+
+[project.scripts]
+sync-fotos = "syncfotos.sync_cli:main"
+sync-fotos-gui = "syncfotos.sync_gui:main"
+sync-fotos-duplicats = "syncfotos.tools.duplicats:main"
+sync-fotos-fitxers-buits = "syncfotos.tools.fitxers_buits:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

syncfotos-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

syncfotos-1.0.0/src/syncfotos/__init__.py

@@ -0,0 +1 @@
+"""Paquet principal de SyncFotos."""

syncfotos-1.0.0/src/syncfotos/core/__init__.py

@@ -0,0 +1,13 @@
+"""Nucli de lògica de SyncFotos."""
+
+from .sync_core import (
+	cache_path_for,
+	count_files,
+	data_a_path,
+	load_cache,
+	load_validated_cache,
+	scan_directory,
+	save_cache,
+)
+from .sync_outputs import build_missing_and_present, write_deletion_script, write_missing_report
+

syncfotos-1.0.0/src/syncfotos/core/duplicats_core.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+import json
+import os
+import platform
+import subprocess
+from collections import defaultdict
+from datetime import datetime
+from pathlib import Path
+
+
+IMAGE_EXTS = {".jpg", ".jpeg", ".png", ".bmp", ".gif", ".webp", ".tiff", ".tif"}
+VIDEO_EXTS = {".mp4", ".avi", ".mov", ".mkv", ".webm", ".m4v", ".3gp", ".flv", ".wmv", ".mts", ".m2ts", ".ts"}
+
+
+def load_cache(path: Path):
+    with open(path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def find_duplicate_groups(cache_data, root_dir: Path):
+    """
+    Retorna una llista de tuples (checksum, [rel_path, rel_path, ...])
+    per a cada grup de fotos/vídeos duplicats trobats a la cache.
+
+    Només es consideren fitxers amb extensions d'imatge o vídeo, i
+    només els que realment existeixen al disc en aquest moment.
+    """
+    fitxers = cache_data.get("fitxers", {})
+    media_exts = IMAGE_EXTS | VIDEO_EXTS
+    by_checksum = defaultdict(list)
+    missing_count = 0
+
+    for rel_path, info in fitxers.items():
+        if Path(rel_path).suffix.lower() not in media_exts:
+            continue
+        checksum = info.get("checksum")
+        if not checksum:
+            continue
+        if not (root_dir / rel_path).exists():
+            missing_count += 1
+            continue
+        by_checksum[checksum].append(rel_path)
+
+    groups = []
+    for checksum, paths in by_checksum.items():
+        if len(paths) >= 2:
+            groups.append((checksum, sorted(paths)))
+    return groups, missing_count
+
+
+def open_with_default_app(path: Path):
+    """Obre un fitxer amb l'aplicació per defecte del sistema."""
+    system = platform.system()
+    if system == "Windows":
+        os.startfile(str(path))  # type: ignore[attr-defined]
+    elif system == "Darwin":
+        subprocess.Popen(["open", str(path)])
+    else:
+        subprocess.Popen(["xdg-open", str(path)])
+
+
+def format_size(size_bytes):
+    if size_bytes >= 1024 * 1024:
+        return f"{size_bytes / 1024 / 1024:.1f} MB"
+    if size_bytes >= 1024:
+        return f"{size_bytes / 1024:.1f} KB"
+    return f"{size_bytes} B"
+
+
+def format_mtime(mtime):
+    try:
+        return datetime.fromtimestamp(mtime).strftime("%Y-%m-%d  %H:%M:%S")
+    except Exception:
+        return "Desconegut"

syncfotos-1.0.0/src/syncfotos/core/review_ops.py

@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from pathlib import Path
+import shutil
+
+
+@dataclass
+class ReviewState:
+    idx: int = 0
+    last_dir: Path | None = None
+    mogudes: int = 0
+    saltades: int = 0
+    historial: list[tuple[Path, Path]] = field(default_factory=list)
+
+
+def create_review_state(target_root: Path) -> ReviewState:
+    return ReviewState(last_dir=target_root)
+
+
+def unique_destination(dest_dir: Path, source_name: str) -> Path:
+    dest_file = dest_dir / source_name
+    if not dest_file.exists():
+        return dest_file
+
+    stem = Path(source_name).stem
+    suffix = Path(source_name).suffix
+    index = 1
+    while dest_file.exists():
+        dest_file = dest_dir / f"{stem}_{index}{suffix}"
+        index += 1
+    return dest_file
+
+
+def move_missing_file(source_root: Path, rel_path: Path, dest_dir: Path, state: ReviewState) -> tuple[Path, Path]:
+    full_path = source_root / rel_path
+    dest_dir.mkdir(parents=True, exist_ok=True)
+    dest_file = unique_destination(dest_dir, full_path.name)
+    shutil.move(str(full_path), dest_file)
+    state.historial.append((full_path, dest_file))
+    state.last_dir = dest_dir
+    state.mogudes += 1
+    state.idx += 1
+    return full_path, dest_file
+
+
+def restore_recent_moves(selected_moves: list[tuple[Path, Path]], state: ReviewState) -> list[tuple[Path, Path]]:
+    restored: list[tuple[Path, Path]] = []
+    for orig, dest in selected_moves:
+        orig.parent.mkdir(parents=True, exist_ok=True)
+        target_name = orig
+        if target_name.exists():
+            stem = orig.stem
+            suffix = orig.suffix
+            index = 1
+            while target_name.exists():
+                target_name = orig.parent / f"{stem}_{index}{suffix}"
+                index += 1
+        shutil.move(str(dest), target_name)
+        restored.append((orig, dest))
+
+    for orig, dest in restored:
+        try:
+            state.historial.remove((orig, dest))
+        except ValueError:
+            pass
+        state.mogudes -= 1
+        state.idx = max(0, state.idx - 1)
+
+    return restored