TABLE OF CONTENTS



The Media module allows you to manage images and videos used in BreeceCloud designs and connect external providers that automatically supply media files.
Typical use cases include:
  • Uploading marketing images
  • Managing promotional videos
  • Synchronizing media from external systems
  • Reusing media across installations



Media

  • Click 'Media' in the menu on the left side of the screen.

A list page opens as shown below.


1. Media - Overview


Typical Media Workflow

  1. Add a Provider or upload media manually.
  2. Verify the files appear in Images or Videos.
  3. Use the media in a Design.
  4. Sync providers when new content becomes available.
  5. Monitor Error Logs for synchronization issues.

  1. Overview – Default tab showing a summary of the Media library.
  2. Images – manage image files.
  3. Videos – manage video files.
  4. Providers – Tab listing all connected media providers.
  5. Media files icon/count – Shows media files,with sync status ( synced, unused).
  6. Error alert bar –  Shows errors (if present) found this week with provider icons and a "View error log" link.
  7. Providers – Preview cards for the connected providers.
  8. View all 7 providers – Link to see the full provider list.
  9. How to use media files – Step-by-step guide.



2. Media - Images

  • Click on the 'Images' tab , displays the following as shown below.

  1. Search bar : Search for a specific media file by name.
  2.  Select all : Selects all the files in the page.
  3. Add media button : Upload new image files.
  4. Filter bar:Filter images by:
    • Source: Manual upload or Synced
    • Scope: Local or Group
    • Usage: Used or Unused
    • Sort  : File extension, Source, Scope, Configuration name, Usages, Cache time.

       5.  Image grid : Each image card displays:

  • Thumbnail preview
  • File name
  • Usage status
  • Last synced status 
  • A three-dot menu for additional actions
  • A small icon indicating scope (Local vs. Group)

Note:

Local - Media is only available in the current Installation.
Group - Media is available across all Installations within the Group.

2.1 Images -Row actions

  • Click on the (⋮) row actions of a image.

Opens 4 actions - Details, Edit, Download, Delete. 






2.1.1 Details

  • Click on the image or click on the (⋮) row actions of a image.

A slide-in opens as shown below.

  1. Download : Option to download the image file.
  2. Delete : Option to delete the image file.
  3. Media details fields: displays the info about Media Name, Source, Dimensions, Configuration Name, Cache Time, File Extension, Scope, Usages.


2.1.2 Edit

  • Click on the (⋮) row actions of a image.
  • Click 'Edit'.


A slide-in opens as shown below.





2.1.3 Download

  • Click 'Download'.

Downloads the Image so you can review or reuse the image.

                 

  • Click 'Download'.

Downloads the Image so you can review or reuse the image outside the system. 




2.1.4 Delete

  • Click 'Delete'.




A confirmation message appears as shown below.

  •   Type' Delete'.
  • Click 'Confirm'.                   

Removes the image from the list page, permanently deleting it from the Installation.




2.2 +Add Image

  • Click '+Add image'.


Opens a slide-in as shown below.

  1. File  : Drag & drop or choose a file to upload (PNG, JPG, GIF, BMP).
  2. File name : Enter a name for the Image file.
  3. Add more  : Keep dialog open to upload multiple image files.
  4. Add  : Uploads the file.
  5. Cancel : Closes without adding.

After adding, image is added and can be seen the list page of Images.




3. Media - Videos

  • Click on the 'Videos' tab , displays the following as shown below.

  1. Search bar – Search for a specific video by name.
  2. Select all : Selects all the video files in the page.
  3. Add video : Upload a new video file.
  4. Filter bar: Filter videos by:
    • Source: Stream or File
    • Scope: Local or Group
    • Sort : Filepath, Type, Scope
  5. Video card– Each entry shows:
    • Thumbnail placeholder (clapperboard icon)
    • Video name 
    • Source URL 
    • Scope icon (Group or Local)
    • Three-dot menu for additional actions



3.1 Videos - Row actions

  • Click on the (⋮) row actions of a video.

Opens 3 actions - Details, Edit, Delete.




3.1.1 Details

  • Click on the video or click on the (⋮) row actions of a video.

A slide-in opens as shown below.

  1. Delete : Select to remove the video 
  2. Video: Click play to preview the video. 
  3. Details : Shows the video name, filepath, type, and scope. 
  4. Edit: Edit the video name, filepath, and thumbnail.




3.1.2 Edit

  • Click on the (⋮) row actions of a video.

Opens 3 actions - Details, Edit, Delete.

  • Click 'Edit'


A slide-in opens as shown below:

1. Video name : Enter a name for the video. 

2. Filepath / URL : Enter the file or live-stream URL. 

3. Thumbnail (optional) : Upload a preview image.

4. Save : Saves your changes. Cancel discards them.



3.1.3 Delete

  • Click on the (⋮) row actions of a video.

Opens 3 actions - Details, Edit, Delete.

  • Click 'Delete'

A confirmation message appears as shown below.


  •   Type' Delete'.
  • Click 'Confirm'.                   

Removes the video from the list page, permanently deleting it from the Installation.



3.2 +Add Video

  • Click '+Add video'


A slide-in opens as shown below:

1. Video name : Enter a name for the video. 

2. Filepath / URL : Enter the file or live-stream URL. 

3. Thumbnail (optional) : Upload a preview image.

4. Save : Saves your changes. Cancel discards them.


4. Providers

Providers are the sources or platforms from which media is integrated or imported.

  • Click on the 'Providers' tab , displays the following as shown below.


1. Search : Filter the list by provider name.

2. Add provider : Adds a new provider (available as a tile or button).

3. Provider count : Total providers listed




4.1 Providers - Row actions

  • Click on the (⋮) row actions of a provider.

A list page opens as shown below.


1. Details : Opens the provider's details.

2. Edit : Edits the provider settings.

3. Sync now : Starts a sync immediately.

4. Delete : Removes the provider.

5. Error logs : Shows the provider's error history.




4.1.1 Details

  • Click on the (⋮) row actions of a provider.
  • Click 'Details'.




A slide-in opens as shown below.

1. Options menu (⋯) : Sync now or Delete.

2. Provider summary : Shows the provider name, type, linked media count, and last sync.

3. Configuration : Shows connection, credentials, caching, and file extensions.

4. Edit : Edit the configuration settings.




4.1.2 Edit

  • Click on the (⋮) row actions of a provider.
  • Click 'Edit'.



A slide-in opens as shown below.

1. Configuration name : Source name shown in the media list.

2. Connection : Host and port.

3. Directory : Folder to sync from.

4. Credentials : Saved user. Click Change credentials to update.

5. Caching : Not cached (always latest) or Cached for 1 day.

6. File extensions : File types to sync.

7. Save : Saves changes. Cancel discards them.




4.1.3 Sync now

  • Click on the (⋮) row actions of a provider.
  • Click 'Sync now'.


A snack bar message pops up saying ' Sync started for 'xxxx'.




4.1.4 Delete

  • Click on the (⋮) row actions of a provider.
  • Click 'Delete'.



A confirmation message appears as shown below.

  • Type' Delete'.
  • Click 'Confirm'.                   

Removes the provider from the list page, permanently deleting it from the Installation.



4.1.5 Error logs

  • Click on the (⋮) row actions of a provider.
  • Click 'Error logs'.


A list page opens as shown below:

1. Search : Find a specific error entry.

2. Filter : Narrow the list by provider type.

3. Provider type tabs : Filter by SFTP, FTP, FINFO, Perfion, Qbank, NewI.It, or GeneralUrl.

4. Time : When the error occurred. Click to sort.

5. Provider / Provider name : The provider type and its configured name.

6. Error type : Error category, e.g. NOT_FOUND, SETTINGS, BAD_REQUEST, UNKNOWN.

7. Message : Details of the error.

8. Row menu (⋮) : Click Details to open a slide-in with that entry's details. 



4.2 +Add provider

  • Click '+Add provider'


Opens a slide-in as shown below.

There are 7 types of providers. 

A click on the provider opens a slide-in .

Fill in the mandatory fields and save.

The added provider can be seen in the list page of the providers.



5. Group Installation

The process is the same for Group Installation — the only difference is where you start. 

Navigate to Group Installation and add images, videos, and providers exactly as described above for Installation(sections 1-4)