Skip to content

Indexing your originals

Info

If you're using PhotoPrism for the first time, make sure your photo and video collection is properly configured as originals folder. See installation instructions in Getting Started for details. When starting with an empty folder, you need to add or upload files first.

  1. Go to Library using the main navigation

  2. Select a sub-folder or keep the default to index all files

  3. Select Complete Rescan to re-index all originals, including already indexed and unchanged files

  4. Press Start to start indexing

Screenshot

Tip

You may use WebDAV for adding files to the originals folder. This is especially helpful if PhotoPrism is running on a remote server.

Tip

A NSFW detector can be enabled to automatically flag pictures as private which may have offensive content. Note that this is only somewhat reliable.

Ignoring directories and files

Create a .ppignore file in the same directory that the directories or files you want to ignore. Then put configuration in this file, see the following examples:

# ignore a directory by its name
foo
# ignore all files
*.*
# ignore all files with gif extension
*.gif
# ignore videos which name start with MVI
MVI_*.MOV
# or
MVI_*.*

Names will be ignored in the directory and all subdirectories. An * character will act as a wildcard.

When should "Complete Rescan" be selected?

If selected, all files in the originals folder will be re-indexed, including already indexed and unchanged files. This may be necessary after upgrading, especially to new major versions.

Automatic Indexing

The Indexer is triggered automatically 15 Minutes after the originals folder has been edited via WebDAV. 15 Minutes is the default value, it can be changed using the respective config option.