Stream App Help

Stream is a personal photo management tool designed for NAS users. It is just a management interface and does not store your photo data, so using Stream will not affect your original data. You can stop using Stream at any time without losing any data.

Currently, Stream supports Photoprism, Immich and local photo albums.

Media Source Tested Version
Immich v1.118.2
Photoprism Build 240915-e1280b2fb
Local Photos iOS 18

Due to limited resources, we are only able to test a limited range of versions. If you encounter any issues with media source support, please provide feedback through the app’s settings page.

Currently supported operations include Favorite, Archive, Restore, Private, Unprivate, Delete, and Approve. The table below shows the corresponding operations in different types of media sources:

Stream Photoprism Immich Local Photos
Favorite Favorite Favorite Favorite
Archive / Restore Archive / Restore Archive / Unarchive (not supported)
Private / Unprivate Private / Unprivate (not supported) Hide
Delete Delete 1 Delete 1 Delete
Approve Approve 2 (not supported) (not supported)

Stream combines and displays photos from different media sources. When you perform operations like private, archive, or delete on merged photos, you are actually performing batch operations on the original media sources.

By default, Stream merges photos based on basic information such as file name, capture time, and file resolution using simple rule matching. You can also enable hashing to improve merging accuracy. However, keep in mind that enabling hashing will increase the time and power consumption of merging operations.

Stream caches thumbnails and partial photo metadata to provide a better user experience. If you have a large number of photos, it may occupy a significant amount of cache space. However, you can safely clear the cache data because Stream will automatically download it when needed.

  1. Enable Vector Search in settings. Note, this requires Thumbnail Auto-Download to be enabled and it may consume more battery power.
  2. Download the two AI models: image encoder and text encoder.
  3. Once the models are ready, tap Run Job to start index creation.
  4. Upon every app cold-start, the Indexer runs automatically after a few seconds.

The Vector Search feature matches based on the similarity of image content. Make sure to input descriptions that are as relevant to the image content as possible.

For example:

  • If you’re searching for a book cover, you might input book with a blue cover
  • If you’re looking for a specific type of dog, your description could be fluffy golden retriever

Remember, the more descriptive and accurate your input, the better your search results will be.

Note
At present, only English description is supported.
Note
If this feature causes a crash, try to Reset Index in the Index section.

  1. You can enable the “Archive instead of delete” feature in Photoprism/Immich settings. This is useful for read-only media sources. ↩︎ ↩︎

  2. Photoprism marks low-quality photos as pending approval, which need to be manually approved to display normally in the album. ↩︎