photosync-tool 0.1.0__tar.gz

photosync_tool-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0 - 2026-04-30
+
+- Initial PyPI packaging foundation.
+- PySide6 desktop GUI for local photo sync and blur review workflows.
+- Headless/background sync support.
+- SQLite library index for file metadata, sync events, blur scores, and future AI metadata.

photosync_tool-0.1.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include README.md
+include CHANGELOG.md
+include RELEASE.md
+
+exclude photo_manager_config.json
+exclude photo_manager_index.sqlite3*
+exclude photo_manager_sync_log.csv
+exclude photo_manager_service.log
+exclude blur_candidates*.csv
+exclude *.decisions.csv
+
+global-exclude __pycache__/*
+global-exclude *.py[cod]

photosync_tool-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: photosync-tool
+Version: 0.1.0
+Summary: Local desktop tool for organizing, syncing, indexing, and reviewing photos.
+Author: Filipluke
+Project-URL: Homepage, https://github.com/Filipluke/PhotoSyncTool
+Project-URL: Repository, https://github.com/Filipluke/PhotoSyncTool
+Project-URL: Issues, https://github.com/Filipluke/PhotoSyncTool/issues
+Keywords: photos,sync,desktop,pyside6,blur-detection,sqlite
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6
+Requires-Dist: Pillow
+Requires-Dist: opencv-python
+Requires-Dist: numpy
+Requires-Dist: Send2Trash
+Requires-Dist: watchdog
+Requires-Dist: pywin32; platform_system == "Windows"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# Photo Manager Pro
+
+A local tool for organizing photos and videos. The app provides a PySide6 GUI, one-shot synchronization, background folder watching, and tools for detecting heavily blurred photos.
+
+## Current Features
+
+- Sort files from a source folder into year-based folders.
+- Detect dates from EXIF with fallback to `mtime` or `ctime`.
+- Copy files with verification by fast fingerprint or full SHA256.
+- Optionally delete source files after successful synchronization.
+- Background sync mode powered by `watchdog`.
+- CSV synchronization log.
+- Blur scanning with OpenCV.
+- Local SQLite metadata index for files, sync events, blur scores, and future AI data.
+- Automatic background sync after the app starts.
+- Option to open the app on Windows startup.
+
+## Running
+
+```powershell
+py -m pip install -r requirements.txt
+py photo_manager_gui.py
+```
+
+`photo_manager_gui.py` is a lightweight launcher. The main application lives in `photo_manager_qt.py`.
+
+After the first PyPI release, the app can also be installed as:
+
+```powershell
+python -m pip install photosync-tool
+photo-manager-pro
+```
+
+## Library Index
+
+The app maintains a local SQLite index named `photo_manager_index.sqlite3` in the selected photo root folder. It is intentionally local and disposable: it can be rebuilt from the library, sync logs, and blur CSVs.
+
+The index currently stores:
+
+- Media file paths, size, timestamps, year, dimensions, status, and optional quick hashes.
+- Sync events from batch sync, background sync, and the headless service.
+- Blur scores imported from `blur_tool.py`.
+- Placeholder storage for future AI captions, tags, and embeddings.
+
+In the GUI, use `Library Index -> Rebuild Index` to scan the current root folder, or `Import Blur CSV` to load existing blur scan results. Batch sync, background sync, the Windows service, blur scan, and blur auto-delete now update the index automatically.
+
+## Startup And Background Work
+
+The GUI has two separate startup options:
+
+- `Autostart background on launch` starts folder watching after the app launches.
+- `Open on Windows startup` adds an entry to `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`, so the app starts when the current user logs in.
+
+This is not a full Windows service yet. The target design should split out a separate `photo_manager_service.py` process that reads the same `photo_manager_config.json`, runs without a window, and can be installed with `pywin32` or `NSSM`.
+
+## Schedule
+
+The GUI includes a `Sync hours` field. It accepts one or more hour ranges:
+
+- `0-24` means all day.
+- `8-18` means synchronization only during working hours.
+- `22-7` means an overnight window that crosses midnight.
+- `8-12,14-18` means multiple windows in one day.
+
+In background sync mode, files detected outside the allowed window are queued and processed when the window opens again. The next step is a full calendar or weekly schedule view, for example:
+
+- Weekdays.
+- Hour ranges when synchronization is allowed.
+- Separate windows for sync and AI/blur analysis.
+- A "pause until hour X" mode.
+- Restricting heavy work to nighttime.
+
+Technically, the current hour field should eventually evolve into JSON with a list of time windows and task types.
+
+## Local Or API AI
+
+AI could add practical features such as:
+
+- Photo tagging: people, documents, food, landscapes, screenshots, animals, cars.
+- Captions for search.
+- Semantic duplicate and near-duplicate detection.
+- Photo quality scoring: sharpness, exposure, closed eyes, motion blur.
+- Private or sensitive content detection before automatic moves.
+- OCR for screenshots and documents.
+- Automatic albums, such as vacations, university, work, or documents.
+
+I would not start with full Torch as a hard application dependency. A better path:
+
+1. Start with an API backend or ONNX Runtime as an optional backend.
+2. Use the SQLite index as the cache for tags, captions, embeddings, and review decisions.
+3. For local models, use `onnxruntime` with CLIP/SigLIP embeddings for similarity and search.
+4. Add `torch` later as an optional `requirements-ai.txt` package only when training or GPU-heavy models become necessary.
+
+Torch is powerful, but heavy. For a desktop app that should remain stable and easy to run, ONNX Runtime or an external API will usually be less painful.
+
+## Suggested Roadmap
+
+- Real service/headless mode.
+- Work schedule and pause controls.
+- Background task queue with retry.
+- SQLite-backed search and gallery views.
+- Duplicate view with thumbnails.
+- Thumbnails and a fast gallery in the GUI.
+- Search by date, folder, tags, and AI captions.
+- Dedicated safe-delete panel with recycle bin and decision history.
+- Synchronization report export.
+- Optional AI panel: backend, model, batch size, GPU/CPU, embeddings cache.

photosync_tool-0.1.0/README.md

@@ -0,0 +1,107 @@
+# Photo Manager Pro
+
+A local tool for organizing photos and videos. The app provides a PySide6 GUI, one-shot synchronization, background folder watching, and tools for detecting heavily blurred photos.
+
+## Current Features
+
+- Sort files from a source folder into year-based folders.
+- Detect dates from EXIF with fallback to `mtime` or `ctime`.
+- Copy files with verification by fast fingerprint or full SHA256.
+- Optionally delete source files after successful synchronization.
+- Background sync mode powered by `watchdog`.
+- CSV synchronization log.
+- Blur scanning with OpenCV.
+- Local SQLite metadata index for files, sync events, blur scores, and future AI data.
+- Automatic background sync after the app starts.
+- Option to open the app on Windows startup.
+
+## Running
+
+```powershell
+py -m pip install -r requirements.txt
+py photo_manager_gui.py
+```
+
+`photo_manager_gui.py` is a lightweight launcher. The main application lives in `photo_manager_qt.py`.
+
+After the first PyPI release, the app can also be installed as:
+
+```powershell
+python -m pip install photosync-tool
+photo-manager-pro
+```
+
+## Library Index
+
+The app maintains a local SQLite index named `photo_manager_index.sqlite3` in the selected photo root folder. It is intentionally local and disposable: it can be rebuilt from the library, sync logs, and blur CSVs.
+
+The index currently stores:
+
+- Media file paths, size, timestamps, year, dimensions, status, and optional quick hashes.
+- Sync events from batch sync, background sync, and the headless service.
+- Blur scores imported from `blur_tool.py`.
+- Placeholder storage for future AI captions, tags, and embeddings.
+
+In the GUI, use `Library Index -> Rebuild Index` to scan the current root folder, or `Import Blur CSV` to load existing blur scan results. Batch sync, background sync, the Windows service, blur scan, and blur auto-delete now update the index automatically.
+
+## Startup And Background Work
+
+The GUI has two separate startup options:
+
+- `Autostart background on launch` starts folder watching after the app launches.
+- `Open on Windows startup` adds an entry to `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`, so the app starts when the current user logs in.
+
+This is not a full Windows service yet. The target design should split out a separate `photo_manager_service.py` process that reads the same `photo_manager_config.json`, runs without a window, and can be installed with `pywin32` or `NSSM`.
+
+## Schedule
+
+The GUI includes a `Sync hours` field. It accepts one or more hour ranges:
+
+- `0-24` means all day.
+- `8-18` means synchronization only during working hours.
+- `22-7` means an overnight window that crosses midnight.
+- `8-12,14-18` means multiple windows in one day.
+
+In background sync mode, files detected outside the allowed window are queued and processed when the window opens again. The next step is a full calendar or weekly schedule view, for example:
+
+- Weekdays.
+- Hour ranges when synchronization is allowed.
+- Separate windows for sync and AI/blur analysis.
+- A "pause until hour X" mode.
+- Restricting heavy work to nighttime.
+
+Technically, the current hour field should eventually evolve into JSON with a list of time windows and task types.
+
+## Local Or API AI
+
+AI could add practical features such as:
+
+- Photo tagging: people, documents, food, landscapes, screenshots, animals, cars.
+- Captions for search.
+- Semantic duplicate and near-duplicate detection.
+- Photo quality scoring: sharpness, exposure, closed eyes, motion blur.
+- Private or sensitive content detection before automatic moves.
+- OCR for screenshots and documents.
+- Automatic albums, such as vacations, university, work, or documents.
+
+I would not start with full Torch as a hard application dependency. A better path:
+
+1. Start with an API backend or ONNX Runtime as an optional backend.
+2. Use the SQLite index as the cache for tags, captions, embeddings, and review decisions.
+3. For local models, use `onnxruntime` with CLIP/SigLIP embeddings for similarity and search.
+4. Add `torch` later as an optional `requirements-ai.txt` package only when training or GPU-heavy models become necessary.
+
+Torch is powerful, but heavy. For a desktop app that should remain stable and easy to run, ONNX Runtime or an external API will usually be less painful.
+
+## Suggested Roadmap
+
+- Real service/headless mode.
+- Work schedule and pause controls.
+- Background task queue with retry.
+- SQLite-backed search and gallery views.
+- Duplicate view with thumbnails.
+- Thumbnails and a fast gallery in the GUI.
+- Search by date, folder, tags, and AI captions.
+- Dedicated safe-delete panel with recycle bin and decision history.
+- Synchronization report export.
+- Optional AI panel: backend, model, batch size, GPU/CPU, embeddings cache.

photosync_tool-0.1.0/RELEASE.md

@@ -0,0 +1,48 @@
+# Release Guide
+
+This project is prepared for PyPI publishing through GitHub Actions and PyPI Trusted Publishing.
+
+## PyPI Pending Publisher
+
+On PyPI, go to `Account settings -> Publishing -> Add a new pending publisher -> GitHub` and use:
+
+- PyPI Project Name: `photosync-tool`
+- Owner: `Filipluke`
+- Repository name: `PhotoSyncTool`
+- Workflow name: `publish.yml`
+- Environment name: `pypi`
+
+The project name is the value from `pyproject.toml` and must match exactly. Pending publishers do not reserve names, so the first successful upload creates the project.
+
+## GitHub Environment
+
+In GitHub, create an environment named `pypi`:
+
+1. Open `Settings -> Environments`.
+2. Create `pypi`.
+3. Optionally add required reviewers before deployment.
+
+## Local Verification
+
+```powershell
+python -m pip install -e ".[dev]"
+python -m build
+python -m twine check dist/*
+```
+
+## Publish
+
+1. Update `version` in `pyproject.toml`.
+2. Update `CHANGELOG.md`.
+3. Commit and push to `main`.
+4. Create a GitHub Release for a matching tag, for example `v0.1.0`.
+5. The `.github/workflows/publish.yml` workflow builds and uploads the package to PyPI.
+
+## Install After Release
+
+```powershell
+python -m pip install photosync-tool
+photo-manager-pro
+```
+
+Before a public release, choose and add a project license if this package should be open source.