Automate Photo Timestamps with ShiftPicDate-GUI: Quick Setup & Tips

Troubleshooting ShiftPicDate-GUI: Common Errors and How to Resolve Them

1. App won’t start / crashes on launch

• Possible causes: missing dependencies, corrupted install, incompatible OS version, or permission issues.
• Fixes:
  1. Reinstall the latest release for your OS from the official distribution.
  2. Check system requirements and install any required runtime (e.g., appropriate Python version or GUI runtime).
  3. Run the app as administrator (Windows) or with sudo if instructed (Linux/macOS) to test permission issues; avoid running routinely as root.
  4. Start from a terminal/console to capture error output and search logs for stack traces to identify missing libraries.

2. Images not listed / empty file list

• Possible causes: wrong input folder, unsupported file types, hidden files, or filters applied in UI.
• Fixes:
  1. Confirm the selected folder contains JPEG/HEIC/PNG files (ShiftPicDate-GUI typically works with formats carrying EXIF).
  2. Remove file filters in the UI or change filter to include all supported extensions.
  3. Verify files aren’t hidden or on a network drive with restricted access; copy a sample image to a local folder and try again.
  4. Ensure files have readable EXIF metadata; use a metadata viewer (exiftool) to confirm.

3. Date shift has no effect / EXIF date not updated

• Possible causes: write permissions, read-only files, sidecar XMP used, or camera-specific metadata handling.
• Fixes:
  1. Ensure files are writable (remove read-only attribute on Windows; chmod u+w on Unix).
  2. Check whether the app writes changes to sidecar files (XMP); enable in settings if you want in-place EXIF edits or check for a “write to files” toggle.
  3. Test with one image and confirm change using exiftool or the OS photo info panel.
  4. For HEIC or proprietary formats, confirm app supports writing EXIF; if not, convert to JPEG or use a compatible tool.

4. Time zone adjustments wrong / off by hours

• Possible causes: misunderstanding of shift direction, daylight saving time, or app treating shifts as absolute vs. timezone-aware.
• Fixes:
  1. Verify whether the GUI expects a positive value to move timestamps forward or backward; experiment with a test image.
  2. If shifting across DST boundaries, apply an extra hour where appropriate.
  3. Use explicit UTC offsets where supported (e.g., +02:00) rather than local timezone names.
  4. Check for a “preserve timezone” option; toggle it if available.

5. Batch processing stops or skips files

• Possible causes: problematic file with corrupt metadata, file path length limits, or resource/timeouts.
• Fixes:
  1. Run batch on smaller subsets to identify problematic files.
  2. Rename files with long paths or move to a shorter path root.
  3. Inspect skipped files with exiftool for corrupt tags and repair or exclude them.
  4. Increase any timeout or memory settings if the app exposes them.

6. Errors writing to SD card or external drives

• Possible causes: filesystem is read-only (e.g., camera SD formatted as exFAT with permission quirks), or drive mounted with noexec/nosuid.
• Fixes:
  1. Copy images to a local drive, perform edits, then copy back.
  2. Remount with correct permissions or unlock write protection on the SD card.
  3. Ensure the user account has write access to that mount point.

7. Unicode/filename encoding problems

• Possible causes: non-UTF-8 filenames, Windows vs. Unix encoding differences.
• Fixes:
  1. Rename files to ASCII or UTF-8 compatible names for batch runs.
  2. Update OS locale settings or run the app in an environment that supports UTF-8.

8. GUI freezes when processing large batches

• Possible causes: UI thread blocked by synchronous processing.
• Fixes:
  1. Use smaller batch sizes or run in command-line/batch mode if provided.
  2. Look for a “background processing” or “run in background” setting.
  3. Monitor CPU/RAM; close other heavy apps.

9. App reports dependency or codec missing

• Fixes:
  1. Install suggested codec or library (HEIC/HEIF libraries, ffmpeg, libimage-exiftool-perl) per the app’s docs.
  2. Use packaged builds (AppImage, DMG, or bundled installer) that include dependencies.

10. Log files not helpful / need more diagnostics

• Steps:
  1. Start app from terminal to capture stdout/stderr.
  2. Enable verbose or debug mode in settings if present; reproduce the issue and save logs.
  3. Share log excerpts with maintainers when filing an issue (include app version, OS, sample file, and exact steps).

Quick checklist before filing a bug

• Confirm app version and OS.
• Reproduce on a small sample.
• Capture logs and exact error messages.
• Include a sample image (or anonymized metadata) and steps to reproduce.
• Try latest release or nightly build to rule