VMS Manual

This is the manual for the Blue Billywig VMS. This manual will explain the publish-manage-convert-analyze cycle of our VMS. If you have chosen for an extra module, you can find that manual separately on the support site. Because it is a web-based application the VMS functionalities are used through a web-browser. This way the most up to date version of the VMS is always present. Most browsers are supported. We recommend a monitor with 1280 by 1024 pixels minimum.

This manual should answer all of the questions. For any remaining questions send an e-mail to support@bluebillywig.com.

Getting started - Logging on

Go to the url provided by mail. This url will look like publication.bbvms.com, where publication is your publication name.

Note: Do not type "www." in front of the url, this will not lead to the vms.

Logging in

Figure 2.1 Logging in

Underneath the password box there is a link which will enable you to retrieve the password if forgotten. Fill in the supplied username and password and press login.


Main screen

The main screen will now appear.

Main screen

Figure 3.1 Main screen

The header after login consists of Blue Billywig logo at the left, and your company logo on the right. Next to the customer logo, there is a dropdown menu.

VMS Header

Figure 3.2 VMS Header

The main menu is where "Usage statistics", "Settings" and the "Log out" button can be found.

Top dropdown menu

Figure 3.3 Top dropdown menu

3.1 Main menu Items

3.1.1 Usage statistics

Usage statistics

Figure 3.4 Usage statistics

Clicking on the top right button, where the account name of the currently logged in user is shown, will open a menu. Now click on the Usage statistics button. This screen contains the number of clips that are uploaded, as well as the number of stored clips. The number of stored clips is cumulative.


3.1.2 Settings


Figure 3.5 Settings

Clicking on the top right button, where your account name is shown, will open a menu. Now click on the settings button. This screen contains 5 different settings, namely: Social channels, User profile, Block hosts, Miscellaneous and User management.


Note: The User management menu is only enabled if the user that is logged in is an admin user. Social channels

Social Channels

Figure 3.6 Social Channels

This screen contains the social channels that are already configured and will be used to create new social channels. At this moment there are 3 social channels, namely: Twitter, Facebook and YouTube. Social channels will be explained extensively in Social Channels. User profile

User profile

Figure 3.7 User profile

This screen will show basic information about the user logged in at this moment. This is also the place to change the password. Block hosts

Block hosts

Figure 3.8 Block hosts

With this option it is possible to prevent external sites to embed video's. Type in the website you want to block in the upper bar and click the + button next to it. This will add the website to the list. Clicking the save button will complete this action. It is also possible to block a domain like "www.example.com/video" or just a single page like "www.example.com/video.html". Miscellaneous


Figure 3.9 Miscellaneous

Here the commercial "kill switch" resides. When allow all commercials to be shown is selected, it will show commercials that are selected in the playout. If there is no need to show commercials select disable all commercials. It is also possible to change the deeplink. User management

User management

Figure 3.10 User management

For administrators it is possible to manage users, reset passwords and add users.


3.2 Left Menu

Left menu

Figure 3.11 Left menu

The menu on the left has many options which will be described in the following sections.


3.3 Upload and Encode


Figure 3.12 Upload

Use the go button to upload a video file or a document. By pressing the down arrow, a dropdown menu will be shown. Creatives can be uploaded by selecting Upload Creative(s). The creatives are additional assets for a video (eg. images, commercials, audio, text and documents).


3.3.1 Upload youtube video

Upload Youtube

Figure 3.13 Upload Youtube

Search a youtube video to upload using your browser. The figure above shows the youtube watch url. The watch url in this example is: https://www.youtube.com/watch=?v=3oXpc-59Cdo. Press the down arrow located next to Upload Mediaclip(s), and select Import youtube. Paste the youtube watch url, and press go. Now the youtube import will start. After the import has been finished, the video is shown in the clips overview.


Social Channels

Dropdown menu

Figure 4.1 Dropdown menu

To create a Social Channel, go to the settings menu. Click on the customer name at the top right of the screen. After the click select Settings in the dropdown menu.


4.1 Step 1 - Create social Channel


Figure 4.2 Settings

Start creating a Social Channel by clicking on one of the logo's below label 1 (Create new social channel).


4.2 Step 2 - Authorization

Important note: For setting up authorisation to work with social networks like YouTube it's important you use a secure (ssl/https) connection to the VMS.

Please check if the address bar in your browser shows a URL that starts with https://

Give for personal reference only, the social channel a name in the Account description text box, then click Add. An authorization screen will pop up, prompting for a sign in if not signed in already. Please make sure that the right account is being used by verifying the account name in the upper right corner.

Account selection

Figure 4.3 Account selection

4.2.1 Youtube

Authorize YouTube

Figure 4.4 Authorize YouTube

Press Allow Access for the following message to appear.


Access granted YouTube

Figure 4.5 Access granted YouTube

Now it is possible to use the Youtube account to share videos.

Important note: If you want to publish to a YouTube page/channel that's not your user account's only/home channel please set up a separate account for the page you want to upload videos to.

source: https://support.google.com/business/answer/4570250?rd=1


4.2.2 Twitter

Authorize Twitter

Figure 4.6 Authorize Twitter

Press Allow Access for the following message to appear.


Access granted Twitter

Figure 4.7 Access granted Twitter

Now it is possible to use the Twitter account to share videos.


4.2.3 Facebook

Authorize Facebook

Figure 4.8 Authorize Facebook

Press Allow Access for the following message to appear.


Access granted Facebook

Figure 4.9 Access granted Facebook

Now it is possible to use the Facebook account to share videos.


4.3 Step 3 - Extra options

This is to show extra options related to the selected social channel type. After finishing step 3 it's time for step 4.

4.4 Step 4 - Selecting cliplist

Select cliplist YouTube

Figure 4.10 Select cliplist YouTube

After step 4 it is possible to publish content automatically to the selected Social channel type by naming the Social Channel. After naming the Channel the creation process is complete.


4.5 Manual link Social Channel

Mediaclips can be exported manually to a defined Social Channel. This can be done by opening the clip, and selecting the Social tab.

Social channel

Figure 4.11 Social channel

Select the Social Channel to use and click on export.


4.6 Automatic feed Social Channel

The automatic export of a mediaclip to a Social Channel is done by creating a cliplist, which is described in Cliplists. After creating a cliplist the next section will explain connecting this to a social channel.

4.7 Connect cliplist to Social Channel

The last step in static(manual) or dynamic(automatic) publishing of mediaclips to YouTube, consists of modifying your Social Channel to use the static or dynamic cliplist you have created. Start by opening the Settings menu and modifying the selected Social Channel by clicking edit.

Connect Social channel

Figure 4.12 Connect Social channel

Select cliplist for automated feed

Figure 4.13 Select cliplist for automated feed

Now click select cliplist and select the cliplist to use. By selecting a dynamic cliplist, the YouTube channel will be filled automatically with the selected mediaclips.


Create new ...

Create new ...

Figure 5.1 Create new ...

It's easy to create one of the items shown above. Click on the 'plus'-sign down at the left corner of the screen and the options pop up.


Note: Creating a new campaign or text clip is only available if the Campaign Management module has been contracted.

New cliplist

Figure 5.2 New cliplist

This is an example to show how to create a new item.



Search bookmarks

Figure 6.1 Search bookmarks

At the upper left corner of the screen the latest searches are bookmarked. If there is no match with the searched item, the search screen will close automatically after a couple of seconds. The bookmark will also disappear from the list.


Search complete

Figure 6.2 Search complete

Start by searching for a clip by using the search field in the upper left corner. After searching for an item, a list of items that match your search will be displayed.


Searching for multi word titles or descriptions can be done by enclosing the search in quotes. So when searching for This search string this will be "This search string"


7.1 Clip search

Clips overview

Figure 7.1 Clips overview

This screen can be used to filter clips by selecting a filter type in the top left of the page, typing text in the filter box or by selecting and deselecting mediaclip types like video, audio, picture, flash or text clip. Searching is done by searching on predefined fields like Tags, Author, Copyright owner, Title, Custom fields, Clip id, Cliplists or Status (Published or Draft).


Note: In this screen it's also possible to see the statistics of a specific mediaclip. This can be done by clicking on the stats button in the row at the rightmost button. Edit the mediaclip details by clicking the edit button. Previewing this mediaclip can be done by clicking the embed button. This is explained at the end of this chapter.

7.1.1 Filter selection

Filter selection

Figure 7.2 Filter selection

The search parameters are shown next to the metadata box in the top left. In the picture above are some of the tags as an example. Clicking on one of them will only show the mediaclip(s) with the selected tag.


7.1.2 Media filters

Media filters

Figure 7.3 Media filters

Search for a certain type mediaclip like video, audio, picture, commercial or text by selecting and/or unselecting one or more of the checkboxes. Clicking on invert will invert the selection.


7.1.3 Search filter

Search filter

Figure 7.4 Search filter

Using the Filter box, it's easy to narrow the search. This is a full-text search which will search in title, description, tags, author and original filename.


7.2 Embed code

Embed code

Figure 7.5 Embed code

To embed the video on a html page, use the dropdown menu shown above to select a specific playout. Choose between the default javascript and the iframe javascript. To copy the code to your clipboard click on the copy code button. To preview a playout, click on the preview button.


Clip details

Clip details

Figure 8.1 Clip details

Choose a clip and press edit on the right side of the screen. The clip details screen is where to preview, publish, but mainly edit the metadata of a video item.


8.1 Embargo


Figure 8.2 Embargo

The embargo button is the clock above published in the top right of the screen. An embargo is used to publish an item on a specified date and time. It can also be used to unpublish an item, again on a specified date and time. The figure above shows how to add an embargo.


Note: The clock symbol is only displayed when the item is set to published.

8.2 Metadata

Start editing metadata by clicking on the edit button (in the middle at the bottom), or by clicking in one of the edit boxes. Boxes will be visible for every editable field. When provided, the Copyright field will show up in the analytics sources detail tabs described in Filter selection.

Note: Most customers have custom metadata fields. This is one way the VMS can be integrated with any existing web-publishing system. Customized fields can be exported through XML to publish smoothly by using our api.

8.2.1 Tags

Use tags to easily find videos of a certain type. Use the tag car to distinguish videos about cars, and use the tag ferrari to see video's about ferrari. Videos about ferrari will then contain the tags: cars, ferrari. Videos about a vw beetle: cars, beetle, vw. Grouping videos is easy this way. Tags are always saved lowercase.

Note: There can only be one tag per line.

8.2.2 Location

The location field can be used to add a geotag. Pressing the button next to the location field will bring up the location field.

Clip location

Figure 8.3 Clip location

Note: Use the right mouse button to show the menu which contains the add marker item. Add a location by selecting add marker and then pressing the ok button.

8.2.3 Deeplink

This is the location of the web page where the clip is embedded. In general it's recommended to populate the field with the "home url" where the clip can be displayed in the best way.

The VMS is using the deeplink field in vodcasts and for generating the video sitemap. The VMS will prefer the deeplink url instead of the generated sitemap links. See the API guide for more detailed information.

Another way the deeplink can be used is when sharing the videoclip, for example for Facebook. See the Facebook how-to embed manual for more information.

By clicking on the QR code icon behind the deeplink a popup will show with an qr image. This image can be used with mobile applications who read the QR code. A QR code contains a link to a url.

Note: If the deeplink is not filled in, the qr code will not be visible.

Clip QR code

Figure 8.4 Clip QR code

Clicking on the first icon will download the QR image to a local harddisk, while clicking the next button will select it into the keyboard buffer. The third icon will open the link in the QR code in a browser window.


8.2.4 Attachments

If the mediaclip contains attachments, these will be displayed under attachments.

8.3 Thumbnail


Figure 8.5 Thumbnails

To select a thumbnail, click on any one of the thumbnails. The currently selected thumbnail is surrounded by a green border. Deleting a thumbnail is done by clicking on the red X sign in the upper right of a thumbnail. Uploading a thumbnail can be done by clicking the blue upload button in the bottom right of the screen. To upload a custom thumbnail, click on the blue arrow up button. Make sure the dimensions of the thumbnail are at least as high as the dimensions of the video. To create a thumbnail from the video, start by pressing the play button of the video. Clicking anywhere in the video screen will create a new thumbnail.


Note: The more thumbnails there are the longer it takes to save a clip. All the generated thumbnails will be uploaded to the backend of the vms.

8.4 Mediaclip asset details

Mediaclip asset details

Figure 8.6 Mediaclip asset details

The mediaclip assets will be displayed here. These are the different formats that are transcoded by the vms, for example the iPod/iPhone version or the hd version for viewing the mediaclip in higher detail. Next to the preview button there are 4 more buttons, in order: download asset, copy asset source, edit asset and delete asset.


Note: The last 2 buttons may or may not be visible, depending on user rights and/or if it's a live clip.

8.4.1 Download asset

The file that was transcoded (for example the iPod profile) can be downloaded to a local harddisk by pressing this button. It can then be viewed offline.

8.4.2 Copy asset source

Will copy the location (url) of this transcoded asset.

8.4.3 Edit asset

Edit asset

Figure 8.7 Edit asset

The edit asset button will show the screen above, which allows for some advanced options. These options are only available for a user with sufficient rights, and normally there's no sense in changing these options.


8.4.4 Delete asset

This option is used to delete an asset. Like the edit asset screen, this is only available for a user with sufficient rights.

8.5 Embed and Preview

Embed & Preview

Figure 8.8 Embed & Preview

Pressing the embed preview button on the bottom of the screen, will show a playout selector screen as well as an embed screen as shown above. Pressing preview after selecting a playout will result in playing the current video in the selected playout. This will show the video preview screen in Section10.11, Video preview. The last selected playout will be remembered. The copy code button will copy the embed code for usage on a webpage.


Note: Make sure the status of the video is published.

8.6 Source information

Source information

Figure 8.9 Source information

This is information about the source clip that was uploaded to the VMS. It is mostly technical details, that can be used to see what kind of video file has been uploaded.


8.7 Fitmode Tab


Figure 8.10 Fitmode

The fitmode is used to make sure the content size is correctly displayed in relation to the player. This setting is clip specific. Normally when all clips are the same height and width, there is no need to change this.


8.8 Subtitles and Nametags Tab

Subtitles and Nametags

Figure 8.11 Subtitles and Nametags

Subtitles or nametags can be edited in this tab. There's also a button to upload subtitle/nametag documents. The 4 formats that are allowed are: srt, ttxt, xml and sub. When uploaded the VMS will detect which format it is. Subtitles/Nametags need to be set to published to show up in the video.


Note: The subtitle/nametag tab will only be displayed if subtitles/nametags have been contracted.

Subtitle edit

Figure 8.12 Subtitle edit

After pressing the edit button the screen above will display. There is an inpoint and an outpoint that need to be filled in. Pressing the minus sign will remove the corresponding line. If there is need to add another line, press the (bottom) plus sign. To display a subtitle/nametag on the 4th second, type "00:00:04.0". Enter the text next to the in and outpoint.


Note: The system will assume hours as default. If 4 is typed, the system will save that as "04:00:00.0".

8.9 Social Tab

After creating an export channel in the settings described in Social Channels export any clip to YouTube, Twitter or Facebook. Start by pressing on the button of the social export to use. Hereafter select the export channel to push the clip to the internet. In this case there already has been an export to the channel named Facebook.

8.10 Information


Figure 8.13 Information

Here you can see information about the transcoded video. It contains information about the length, the clip id (identifier), subtitles etc.


8.11 Video preview

Video preview

Figure 8.14 Video preview

The figure above shows the video preview of a videoclip. Closing this screen can be done by pressing the esc button on the keyboard, clicking on the close button, or clicking outside the preview window.


8.12 Live clip

Creating a live clip is described in Create new ....

Live clip details

Figure 8.15 Live clip details

A live video or audio clip is essentialy the same as a normal clip, except in this case it is needed to manually add a live url. For button explanations see Mediaclip asset details .


Live clip icon

Figure 8.16 Live clip icon

When the mediaclip is a live mediaclip the icon above will be shown in the top left of the mediaclip view.


Live clip edit

Figure 8.17 Live clip edit

When pressing the edit button the popup shown above will be shown.


Note: The external party that will provide the live stream should be able to give information about the height, width, bandwidth and live url. All the fields are mandatory.

Live clip delete

Figure 8.18 Live clip delete

This will remove the clip from the list of assets. A confirmation box will be shown to prevent users from accidentaly removing a clip.


8.13 Text clip


Figure 8.19 Information

Create a textclip by clicking on the Create new button in the bottom left of the screen, and then click on Text clip. By entering a name for the text clip, the text clip details will be shown. The text clip has different properties (below) than a normal mediaclip. Enter the text that should appear into the call to action text field. Enter the url to go to after clicking the text ad in the click through url text field. The example shows what the ad will look like.


Note: Text clip will only be displayed if the campaigns module has been contracted.

8.14 Shared clips

Shared clips

Figure 8.20 Shared clips

This screen is mostly the same as the clip search described in Section8.1, Clip search. There are however some differences like the publication dropdown and the import button. Select a publication to show the clips that are shared. After clicking on the import button, it's possible to edit the metadata of the clip. The metadata already contains metadata filled in by the owner (publication) of the clip. It's not possible to change the source of this clip, for obvious reasons. Editing this metadata does not update the metadata of the owner, it is a copy for personal use.


Note: Shared clips are only available if the Enterprise module has been contracted.


This list contains dynamic as well as static cliplists. A dynamic cliplist will have a green icon with a D in it, and a static cliplist will have a brown icon with a S.

9.1 Dynamic cliplist

A dynamic cliplist is filled with mediaclips that match the specified criteria. Whenever a new mediaclip with these criteria is uploaded, it will be added automatically. Dynamic cliplists can be used, for example, to show only the 10 most recent items, by setting limit to 10 and sorting by date descending. The new cliplist will remain red until the cliplist has been saved.

Note: If a dynamic cliplist is very large and it is used to upload to YouTube, it is possible to be banned from YouTube.

9.1.1 Query parameters


Figure 9.1 Queries

Dynamic cliplists can be created with a number of parameters. Above the first field can contain a text like "trailer". All clips that have trailer in their metadata will be displayed. To add a parameter underneath the first, press the plus sign to the right. Now it's possible to add another parameter like tags. This will show a dropdown list to the right of the contains dropdown. To see the list, click on the refresh button.


9.1.2 Limit

With the limit it is possible to show only couple of videos to show in a list. This way it is possible to only show, for example, a maximum of 5 items.

9.1.3 Sort

To create a list that will show the latest items, the sort field will need to be set to Date. There are a couple of other ways to sort a dynamic cliplist, but most of the time date or title will be used. Ascending will show the oldest item first and descending the latest item.

9.2 Static cliplist

A static cliplist is a list that contains mediaclips. These clips need to be added manually. A static cliplist will always contain the mediaclips that are added to it. Place the embed code of a static cliplist on a website to show the mediaclips in order. The new cliplist will remain red until the cliplist has been saved.

Static cliplist

Figure 9.2 Static cliplist

To add clips to the cliplist, click on the clip function first, to display the clips. Now click on the cliplist function to display the cliplists again. Now drag a clip to the cliplist. This is shown in detail in the picture below.


9.3 Vodcast

Vodcast option

Figure 9.3 Vodcast option

The vodcast icon is shown in the cliplist next to embed & preview. The vodcast makes it easy to distribute video using rss feeds.


Note: A vodcast will not work if it's set to draft.

9.4 Edit metadata


Figure 9.4 Metadata

Click on the edit metadata button in the cliplist screen to show the figure above. This window is used to edit the metadata and provide a thumbnail for this cliplist. By clicking on the blue button under the picture, a thumbnail can be uploaded.




Playouts can be used to edit the settings of a player. To create a new playout start with Create new ... or select an existing playout and use "Save as".

There is always a default playout that can only be edited with an admin account, this is to guarantee a fallback to go back to. This default playout should not be edited.

If a playout is locked, the lock in the top right will be closed. Also, to be able to use a playout it is essential to set the playout to active. The settings that are available can change, sometimes features are added or removed.

For a full explanation of all the playout settings, please refer to the Standard Player Playout Settings page.



Figure 11.1 Creatives

Creatives is like the clips function. It contains all the commercials that are uploaded to the VMS. It works the same as the clips function described in Clips.



Analytics gives a thorough insight of all the statistical information about each clip.

13.1 Select a date

analytics quick selection

Figure 13.1 analytics quick selection

Selection by using the date quick selection (preset) tool. This can be used to select today, the last 7 or 30 days or the All time selection. To select current and previous years, hover over Select to see the years. This way it's also possible to select a month from a year.


analytics from/to selection

Figure 13.2 analytics from/to selection

Selection by using the date selection tool. Pressing the left date will select the from data, while the right date will select the to data. This will change the graph screen and world overview as well, to reflect the selected from and to date.



analytics graph

Figure 13.3 analytics graph

Analytics show the the number of views from the selected period. This graph is also used to show multiple lines that contain certain filters, for example, countries, browsers and numerous other filters.


13.3 Data overview

Data overview

Figure 13.4 Data overview

This will show the number of views and the number of unique visitors. Player inits are the number of times someone will open a page on which a player is embedded. Creatives are the number of commercial views. The Data overview will disappear when a filter is selected.


13.4 Filter selection

Filter selection

Figure 13.5 Filter selection

When selecting filters on the right side of the screen, the graph at the top, the most viewed at the bottom left and the world map at the bottom right will change accordingly. Selecting the dots in front of the checkboxes will add lines to the graph. See differences between for example, windows, iOS and OS X. The map graph will show where in the world the views came from.


Top graph

Figure 13.6 Top graph

This graph will show the number of views over a period of time. Selecting the dots in front of the checkboxes will show the lines that belong to that filter. The current filters are shown next to the "Clear all filters" button on the top left. On the top right under the "Clear all lines" button, there are buttons with the active filters. The picture shows the iOS, OS X and Windows as active filters. These are buttons that can be used to show and hide the lines as well.


13.5 Best viewed

Best viewed

Figure 13.7 Best viewed

The figure above can be found below the graph next to the world map. The best viewed videos can be found here. By clicking on a clip title the clip detail page shown below will open. It's also possible to get the mediaclip analytics from the clips screen described in Clip Search.


Mediaclip analytics

Figure 13.8 Mediaclip analytics

In the top left of the screen there's a player which shows a line. The line shows what bits of the video are shown most, and where the visitors lose interest. It also shows some mediaclip details, like duration, and number of timeline shows/clicks.


Audience tracking

audience tracking main

Figure 14.1 audience tracking main

With Audience Tracking you can follow exactly and realtime who is watching which video on which place on earth. Even information about device, browser etc. is available. The following sections will explain the subjects more extensively.


14.1 Audience tracking

The top left of the screen shows the number of currently watching viewers, this will update every few seconds. On the top right of the screen are the most popular video's that are currently being watched. On the bottom left of the screen are the currently watching viewers displayed, as well as their location. On the bottom right is the world map, which shows the viewers that are watching. This map will auto-update automatically, although this can be disabled as described in Audience tracking settings.

14.2 Audience specifics

audience specifics

Figure 14.2 audience specifics

The time shown at the top left shows when a viewer started viewing. To the left there's the location of the viewer, and underneath the time is the browser shown. The green bar shows if the viewer is still active, when the viewer stopped watching this will turn red. When a piece of the video is skipped the bar will remain white.


audience specifics

Figure 14.3 audience specifics

At the right of the screen it shows the video position (blue section). It also shows whether the viewer is playing the video, or if the viewer pressed pause. If a viewer decides to watch some of the content again by seeking in the video, the blue section will become darker, like shown by "04:12".


14.3 Audience tracking settings

audience tracking settings

Figure 14.4 audience tracking settings

The top of the Audience tracking screen shows the number of current viewers and to the right of that is the settings button. The settings can be used to disable the automatic updating of the whole screen (Autoupdate) of the bottom right map.