SimplePhotos - Simple Photo Hub

中文

A web application for browsing and managing your photos and videos organized in a folder structure. Powered by a Python (FastAPI) backend and a React (TypeScript, Vite) frontend.

This project was initially created as a personal solution for managing my photos through a folder-based structure. It also served as an interesting experiment in AI-assisted programming, where AI tools handled a significant portion of the coding, allowing me to focus on product design, workflow, and final adjustments.

Key Features

• Folder Browsing: Easily navigate and view your photo and video folders.
• Multimedia Support: Supports common image and video formats.
• Quick Preview: Instantly display images; videos show their first frame.
• Easy Access: Simple API endpoints for convenient frontend access.

Tech Stack

• Backend: Python, FastAPI, SQLite, SQLAlchemy, Pillow, pyheif, ExifRead
• Frontend: React (TypeScript), Vite

Quick Start

services:
  simplephotos:
    image: lzyyauto/simplephotos:latest
    ports:
      - "5173:5173"
    volumes:
      - /path/to/your/data:/app/data
    environment:
      - NODE_ENV=production
      - LANG=zh_CN.UTF-8
      - LC_ALL=zh_CN.UTF-8
      - DATA_ROOT=/app/data
      - SCAN_WORKERS=4
      - SCAN_CHUNK_SIZE=20

volumes:
  data:
    driver: local

Future Outlook

• No immediate plans for future development.

Contribution

Contributions are welcome, including code, issues, and suggestions.