Use the HTML Client¶
The HTML client is a browser-based interface for accessing your video catalog without installing the Fast Video Cataloger desktop application. It lets you browse, search, play, tag, rate, and upload videos from any device with a modern web browser. This is useful when you want to give team members or reviewers quick access to your catalog without requiring them to install software.
Accessing the HTML Client¶
The HTML client is served by the built-in HTTP server. To use it, the server must be running. See Host Video from a Web Server for setup instructions.
Open a web browser and navigate to the server address, for example http://YourComputer:8754. The HTML client loads automatically.

Note
The server address is displayed when you first set up the server using the Share Video Catalog wizard and can also be found on the Info screen in the desktop application when connected to a server, as shown above.
Logging In¶
If authentication is enabled on the server, a login screen appears when you open the HTML client. Enter your Username and Password, then click Login.
Your session is saved in the browser so you do not need to log in again until the session expires. To end your session, click the Logout link in the status bar at the bottom of the left panel.
If authentication is not configured on the server, you are taken directly to the video list with full access.
User Roles¶
There are three user roles that control what you can do in the HTML client:
- Admin -- Full access to all features including viewing, editing, and uploading.
- Editor -- Can view videos and also edit metadata (tags, ratings) and upload new videos.
- Viewer -- Read-only access. Can browse, search, and play videos but cannot modify anything.

User roles are configured on the server. See Authentication for details on setting up users and roles.
Browsing Videos¶
The HTML client uses a two-panel layout. The left panel shows a scrollable list of all videos in the catalog. Each video item displays a thumbnail, the video title, duration, and star rating.
Click a video in the list to select it. The right panel updates to show the full details for that video.
The status bar at the bottom of the left panel shows the total number of videos in the catalog. You can collapse the left panel by clicking the collapse button in the status bar to give the detail view more space, and expand it again using the button on the left edge.
The full screen button (⛶) in the status bar hides the browser's address bar and tabs, so the client uses the whole screen. Click it again or press Esc to leave. Safari on iPhone cannot show a whole page full screen, so the button is not shown there; the player's own full screen button still works.
Searching Videos¶
Use the Search field at the top of the left panel. Type your search term and press Enter or click the Search button. The status bar displays the number of matches found. The arrow at the right end of the field picks what to search, and the field's grey text says which search is picked:
- Videos finds videos by their title, description and keywords.
- Spoken words finds what is said in transcribed videos. Each line found is listed with its video and time.
- Scenes finds scenes by describing what is in the picture, such as a dog on a beach. It needs visual search on the server; see Visual search.
- People finds the videos with a person in the cast.
Click a spoken line or a scene to play its video from that moment.
Clear the search field and search Videos again to return to the full video list.
Filtering by Tags¶
Below the search field, the Filter by Tags section lists all tags in the catalog along with the number of videos tagged with each. Click a tag to filter the video list to only videos with that tag. Selected tags are highlighted. Click a selected tag again to remove the filter.
You can select multiple tags and combine them with a text search to narrow down results further. Tags belong to videos, so the tag filter is only there when Videos is the search picked; the other searches do not use it.
Tip
Click the arrow after the search field to expand or collapse the tag list.
Viewing Video Details¶
When you select a video, the right panel shows:
- Title -- The video title, or the filename if no title is set.
- Duration -- The length of the video.
- Description -- A preview of the video description.
- Rating -- The current star rating.
- Tags -- All tags assigned to the video, shown as colored labels.
- Thumbnails -- A scrollable row of scene thumbnails with timestamps, showing key frames from the video.
Playing Videos¶
Click the Video Player header in the detail panel to expand the built-in video player. The player uses HTML5 video with standard browser controls for play, pause, seek, volume, and fullscreen.
You can also click any scene thumbnail to start playback from that point in the video. The currently playing scene is highlighted with a gold border.
Videos a browser cannot play¶
A browser plays MP4, MOV and WebM files with common codecs such as H.264. Other files, for example WMV, AVI, MKV, DV, ProRes and most camera originals, play from a proxy: a smaller H.264 copy that the server makes and keeps. The original file is not changed, and the desktop program always plays the original.
When you select such a video, the player shows This video has to be prepared before it can play in the browser. Click Prepare video, or click a scene thumbnail. Preparing a whole video takes roughly a tenth of its length, so the server first prepares 15 seconds from the scene you clicked (or from the start), and the player plays that after a few seconds. While it plays, the time bar covers those 15 seconds only. Click another scene to jump there, and when they end the next 15 seconds follow. When the whole video is ready the player switches to it at the place you are watching. Preparing only happens once per video: the next time, and for everyone else, the video plays at once.
The administrator of the server can have new videos prepared as soon as they are indexed, so nobody waits at the first play: Make a proxy as soon as a video is indexed in Server Setup.
If preparing fails, the player says why and offers Try again. Blackmagic RAW files cannot be prepared and do not play in the browser. On Windows Server and the N editions of Windows, preparing fails until the H.264 encoder is added to Windows: see System requirements.
The server administrator sets where proxies are kept, how much disk space they may use and whether they are made as soon as a video is indexed: see Proxies in ServerConfig.xml. When the space runs out, the proxies that have gone longest without being played are removed, and are made again the next time someone plays those videos.
Tagging Videos¶
If you have an Editor or Admin role, you can add and remove tags on videos.
To add a tag, type in the tag input field below the existing tags and click the + button. As you type, a dropdown shows matching suggestions from existing tags in the catalog. Use the arrow keys to navigate suggestions and press Enter to select one, or type a new tag name and press Enter to create it.
To remove a tag, click the x button next to the tag name.
Rating Videos¶
If you have an Editor or Admin role, you can rate videos using the five-star rating display in the detail panel. Hover over the stars to preview a rating, then click to set it. Click the clear button next to the stars to remove the rating.
Uploading Videos¶
If you have an Editor or Admin role, click the green + button next to Search to open the upload dialog.
- Click the file selection area to choose a video file from your device.
- Enter a Title for the video. The filename is used as a default if you leave this blank.
- Optionally enter a Description.
- Optionally enter Tags as a comma-separated list (e.g.,
interview, 2024, project-alpha). - Click Upload to start the upload.
A progress bar shows the upload status. Once the upload completes, the dialog closes automatically and the new video appears in the video list.
Note
Uploaded videos are indexed automatically using the indexing settings configured on the server. To change how thumbnails are generated or how often key frames are captured, adjust the settings in the desktop application on the machine running the server.
To cancel, click Cancel or press Escape.
See Also¶
- Host Video from a Web Server -- Set up the built-in HTTP server.
- Share a Catalog Using the Server -- Share your catalog with other users.
- Connect to Server -- Connect the desktop application to a server.
- REST API -- Access the catalog programmatically.