Folder2Photos

Folder2Photos is a self-hosted web app that watches a local folder and automatically uploads new photos and videos to Google Photos, skipping duplicates by…

  • Backup
  • Cloud
  • Media Applications
Folder2Photos is a self-hosted web app that watches a local folder and automatically uploads new photos and videos to Google Photos, skipping duplicates by fingerprint, mapping subfolders to albums, and providing a dashboard, REST API, and Model Context Protocol (MCP) endpoint for scripts and AI assistants.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

42/100 Fair

Maintained
72last commit 12 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
0
Open issues
0
Last commit
2026-11-09
License
MIT
Activity
rising

Checked 12 days ago - source: GitHub (GeorgeAL78/folder2photos)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 12 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Google OAuth setup Requires your own Google Cloud OAuth client of the Desktop app type with the Google Photos Library API enabled. Folder2Photos uses rclone for the actual upload. source
  • Initial folder behavior By default, only files added after the start date, usually install day, are uploaded; existing files can be marked skipped. source
  • First-run folder behavior Files already present in the watched folder are not uploaded by default unless dated on or after the start date, which defaults to the install day; you can mark all current files as skipped. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Where does Folder2Photos store its history and Google login?

Keep the /config volume for settings, upload history, and rclone.conf with the Google login. The upload history is stored as SQLite under /config.

Which port should I expose for the web interface?

Expose port 8080, for example mapping host port 8080 to container port 8080. Then open the web interface at that server address and port.

What happens if I point the app at an existing folder?

On first start, only files dated from that day onward are uploaded. You can change the date or mark everything currently in the folder as skipped.

How are albums created from folders?

Photos directly in the watched folder go to the Google Photos library. Photos in a subfolder go to an album named after that subfolder, and this behavior can be turned off.

Can I control Folder2Photos from scripts or AI assistants?

Yes, it has REST endpoints under /api/v1 and an MCP endpoint at /mcp. API and MCP requests require an Authorization Bearer token, and you can set a fixed token with API_TOKEN.

Answers sourced from github.com

Community

No community discussions collected yet.