FanCaps

FanCaps turns videos into beautiful frame galleries — fully automated, fast, and built for collectors. Upload your source, choose your capture settings, and get a curated gallery with lightbox navigation, series grouping (SxxEyy/EP patterns), and admin tools for categories, permissions, and visibility.

This application comes without branding. If you deploy it publicly, we’d appreciate a short note letting us know where it’s being used.

Requirements

• Node.js 18+
• ffmpeg available in PATH

Setup

npm install
npm start

Open http://localhost:3000.

First-time setup

• Visit /setup to create the admin account (User ID 1).
• After that, registration is available at /register if Signup enabled is true in System settings.
• Admin can always create users in System → User management.

Web UI options

• FPS
• Max frames
• Output format (JPG/PNG)
• Quality (JPG)
• Scale/resize
• Start/end time
• Gallery title
• Privacy (public/private)
• Category

Processing behavior

• Upload progress is shown in the UI
• Capture progress updates live and redirects when complete
• Source video is deleted after frames are extracted
• Multiple uploads are processed sequentially via queue

Admin features

• System dashboard metrics (galleries, frames, users, queue)
• Audit mode (admins can view private galleries)
• Categories management (add/edit/delete, hide from guests)
• User management (create, reset password, lock/unlock, delete)
• Default capture settings + signup toggle

Views

• Galleries: /
• Groups (SxxEyy or Episode patterns): /groups
• System (admin): /admin/system

Environment

• PORT (default: 3000)
• FPS (default: 1)
• MAX_FILE_MB (default: 500)
• SESSION_SECRET (required for sticky sessions)

Storage

• uploads/ temporary upload staging
• galleries/<id>/ frames + manifest.json
• app.sqlite user + config database
• sessions.sqlite session store