syncfotos 0.1.6__tar.gz

syncfotos-0.1.6/.github/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Build and Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install build backend
+        run: python -m pip install --upgrade build
+
+      - name: Build wheel and sdist
+        shell: bash
+        run: |
+          if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
+            export SETUPTOOLS_SCM_PRETEND_VERSION="${GITHUB_REF_NAME#v}"
+            echo "Using tag version: ${SETUPTOOLS_SCM_PRETEND_VERSION}"
+          fi
+          python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

syncfotos-0.1.6/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.py[cod]
+
+.venv/
+venv/
+
+.vscode/
+.idea/
+
+build/
+dist/
+
+.DS_Store
+Thumbs.db
+
+*.log
+
+dest/
+source/
+cache/

syncfotos-0.1.6/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: syncfotos
+Version: 0.1.6
+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-0.1.6/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-0.1.6/duplicats.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python3
+import sys
+
+from pathlib import Path
+
+from src.syncfotos.tools.duplicats import DuplicatsApp
+
+
+if __name__ == "__main__":
+    cache_arg = sys.argv[1] if len(sys.argv) > 1 else None
+    DuplicatsApp(cache_arg)

syncfotos-0.1.6/fitxers_buits.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+from src.syncfotos.tools.fitxers_buits import main
+
+
+if __name__ == "__main__":
+    main()

syncfotos-0.1.6/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=69", "setuptools-scm>=8", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "syncfotos"
+dynamic = ["version"]
+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"]
+
+[tool.setuptools_scm]
+tag_regex = "^v(?P<version>\\d+\\.\\d+\\.\\d+.*)$"
+fallback_version = "0.0.0"
+local_scheme = "no-local-version"

syncfotos-0.1.6/setup.cfg

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

syncfotos-0.1.6/src/syncfotos/__init__.py

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

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

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

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

@@ -0,0 +1,135 @@
+from __future__ import annotations
+
+import json
+import platform
+import subprocess
+from collections import defaultdict
+from datetime import datetime
+from pathlib import Path
+import ctypes
+
+
+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":
+        shell32 = ctypes.windll.shell32
+        kernel32 = ctypes.windll.kernel32
+
+        class SHELLEXECUTEINFO(ctypes.Structure):
+            _fields_ = [
+                ("cbSize", ctypes.c_ulong),
+                ("fMask", ctypes.c_ulong),
+                ("hwnd", ctypes.c_void_p),
+                ("lpVerb", ctypes.c_wchar_p),
+                ("lpFile", ctypes.c_wchar_p),
+                ("lpParameters", ctypes.c_wchar_p),
+                ("lpDirectory", ctypes.c_wchar_p),
+                ("nShow", ctypes.c_int),
+                ("hInstApp", ctypes.c_void_p),
+                ("lpIDList", ctypes.c_void_p),
+                ("lpClass", ctypes.c_wchar_p),
+                ("hkeyClass", ctypes.c_void_p),
+                ("dwHotKey", ctypes.c_ulong),
+                ("hIconOrMonitor", ctypes.c_void_p),
+                ("hProcess", ctypes.c_void_p),
+            ]
+
+        info = SHELLEXECUTEINFO()
+        info.cbSize = ctypes.sizeof(SHELLEXECUTEINFO)
+        info.fMask = 0x00000040  # SEE_MASK_NOCLOSEPROCESS
+        info.lpVerb = "open"
+        info.lpFile = str(path)
+        info.nShow = 1
+
+        if not shell32.ShellExecuteExW(ctypes.byref(info)):
+            raise OSError(f"No s'ha pogut obrir '{path}'")
+
+        return info.hProcess
+    elif system == "Darwin":
+        return subprocess.Popen(["open", str(path)])
+    else:
+        return subprocess.Popen(["xdg-open", str(path)])
+
+
+def stop_opened_app(handle):
+    if handle is None:
+        return
+
+    if hasattr(handle, "poll"):
+        try:
+            if handle.poll() is None:
+                handle.terminate()
+                try:
+                    handle.wait(timeout=1)
+                except Exception:
+                    handle.kill()
+        except Exception:
+            pass
+        return
+
+    if platform.system() == "Windows":
+        kernel32 = ctypes.windll.kernel32
+        try:
+            kernel32.TerminateProcess(ctypes.c_void_p(handle), 0)
+        except Exception:
+            pass
+        try:
+            kernel32.CloseHandle(ctypes.c_void_p(handle))
+        except Exception:
+            pass
+
+
+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"