# 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 fingerprint, mapping subfolders to albums, and providing a. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7537/folder2photos

## Description

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.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 12 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_c99b1b3ee8c31982
- GitHub: https://github.com/GeorgeAL78/folder2photos

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/7537/folder2photos), the self-hosted and open-source app directory.
