Social Media Hub User Guide 3.0

SMH Social Media Hub
Version 3.0
User Guide December 2016

Copyright © 2016 Avid Technology, Inc. and its licensors. All rights reserved. Printed in
Israel.
No part of this document may be reproduced or transmitted in any form or by any means,
electronic or mechanical, including photocopying, photographing, and recording, for any
purpose, without the express written permission of Avid Technology, Inc.
Product features, specifications, system requirements and availability are subject to
change without notice.
Trademarks
Avid, the Avid Logo, Avid Everywhere, Interplay, ISIS, Media Composer, Pro Tools and
Sibelius, and all related product names and logos, are registered or unregistered
trademarks of Avid Technology, Inc. in the United States and/or other countries. The
Interplay name is used with the permission of the Interplay Entertainment Corp. which
bears no responsibility for Avid products. All other trademarks are the property of their
respective owners. For a full list of Avid trademarks, see:
http://www.avid.com/US/about-avid/legal-notices/trademarks
December 14, 2016

Contents
Introduction .......................................................................5
What is Avid Social Media Hub?.............................................................6
SMH System ......................................................................................7
SMH Server ....................................................................................7
SMH Client Application .....................................................................7
SMH Database ................................................................................7
Shared Directories ...........................................................................7
Controllers .....................................................................................8
New Features in Social Media Hub 3.0....................................................9
Conventions Used in This Document .................................................... 11
Setup ................................................................................12
Starting SMH.................................................................................... 13
Client Application Overview ................................................................ 15
View Tab and The Application Toolbar .............................................. 15
Arranging the windows \ views ........................................................ 17
Social Media Hub Views ..................................................................... 20
Projects ....................................................................................... 20
Profiles ........................................................................................ 23
Events ......................................................................................... 32
Clients ......................................................................................... 37
Rules ........................................................................................... 38
Users........................................................................................... 39
Logs ............................................................................................ 42
Statuses ...................................................................................... 44
Notifies ........................................................................................ 46
Settings ....................................................................................... 46
Authorization.................................................................................... 47
Supported Social Media Interfaces and Features ................................ 47
Authorizing Facebook ..................................................................... 48
Authorizing Flickr .......................................................................... 51
Authorizing Instagram ................................................................... 52
Authorizing YouTube ...................................................................... 53
Authorizing Twitter ........................................................................ 56
Receiving and Aggregating Messages ...............................58
Overview of Receiving Messages ......................................................... 59
Creating Rules .................................................................................. 60
Exporting and Importing Phrases ..................................................... 61
Receiving Messages........................................................................... 62
The Messages View........................................................................ 63
Aggregating Messages ....................................................................... 71
The Aggregation View .................................................................... 71
Customizing ......................................................................74
Setting Preferences ........................................................................... 75
Service ........................................................................................ 75
Database ..................................................................................... 76
Aggregation.................................................................................. 77
Maintenance ................................................................................. 78
Miscellaneous ............................................................................... 79
SMH Keyboard Shortcuts ................................................................... 80
Main Window ................................................................................ 80
Profile Messages / Aggregation View ................................................ 80
SMH in MediaCentral |UX ..................................................83

Integration with MediaCentral |UX....................................................... 84
Social Media Hub Panes in MediaCentral |UX......................................... 85
SocialMedia Projects Pane............................................................... 85
SocialMedia Profiles Pane................................................................ 86
SocialMedia Aggregations Pane ....................................................... 87
SocialMedia Messages Pane ............................................................ 88
Integration with the Assignments Pane in MediaCentral |UX.................... 93
Integration with Avid Control Systems .............................94

Connecting the Control Systems to the SMH database............................ 95
Integration with Maestro ................................................................ 95
Integration with 3DPlay.................................................................. 96
Integration with Morpho ................................................................. 98
Publishing content from Control Systems to Social Media...................... 101
Using SMH with Maestro to post to social media services .................. 101
Using SMH with Morpho 3.0 to send messages to social media........... 102
|
1. Introduction
In this section:
What is Avid Social Media Hub? on page 6
SMH System on page 7
New Features in Social Media Hub 3.0 on page 9
Conventions Used in This Document on page 11
What is Avid Social Media Hub?
Avid Social Media Hub (SMH) acts as a bridge between broadcast control applications
(for example Maestro, 3Dplay, Morpho) and the world of online social media.
SMH was designed as an independent application and offers multi-connectivity to other
control applications. Since SMH provides the actual connection to the Internet and
social media sites, it offers security for the control applications connected to it. SMH
also moderates and assesses Social Media (SM) content.
SMH can collect social media posts of your selection into groups (called
Aggregations), or find post based on predefined assessment rules. The posts are
then displayed in the Control application, where they can be selected for broadcast, as
illustrated in the following diagram.
1. Introduction
SMH also enables the Control application to post from social media along with certain
broadcast events. The Control application triggers SMH events that instruct SMH to
post to social media sites, as illustrated in the following diagram.
What is Avid Social Media Hub? |

6
SMH System
SMH Server
The SMH Server controls the database and all connected social media accounts, along
with their messages and attached media (images and videos), as well as moderation
and assessment rules, user permissions, log files, and other system-related
information.
The SMH server is accessed via an SMH client application. Usually, the server and the
database are installed on a dedicated machine, which can additionally run an SMH
client.
SMH Client Application

The SMH client application offers the means to communicate with the SMH server, for
administering and maintaining the system, and allowing users to moderate, assess,
and collect social media posts. Only one machine can have a client and server running
concurrently. Other clients are installed on remote computers. Every SMH system must
have at least one Administrator user. Optionally, additional users with different rights
are created by the administrator. The number of allowed clients is determined by your
license.
1. Introduction
SMH Database
SMH utilizes the Microsoft SQL database. The database stores all information about the
social media content, along with the attached images and videos. The users of the
system apply this information to target relevant posts and select them for
broadcasting.
Shared Directories
SMH uses shared directories to save videos and images attached to the social media
posts. Other control applications can access the directories.
SMH System | 7
Controllers
Control applications, such as 3Dplay, Maestro, and Morpho, can use the SMH content
and broadcast it on-air. Control applications can also send information back to the SMH
server. Using events, they can post broadcast content, such as announcements of next
shows or titles of breaking news, to social media networks.
1. Introduction
SMH System |
8
New Features in Social Media Hub 3.0
The following features have been introduced after the Social Media Hub 2.0 release:
Features introduced in the SMH 2.1 release

• The possibility to receive e-mails via the IMAP protocol (read only; secured and
unsecured) has been added;
• New social media driver TVAppServer has been introduced (read only).
• The Social Media Hub Desktop GUI is available in multiple languages.
• The option to set range of received messages has been added.

• New social media driver never.no has been introduced.
• New social media driver MassRelevance (Spredfast) has been introduced.
• Support for Hashtag (#) searches on Instagram has been added.
• New option to filter messages by the number of “Likes” has been introduced.
• Added option to add all visible messages in the Profile Messages View to default
aggregation.
1. Introduction
• Functionality of User and Access Rights has been added to the application.
• The option to recalculate and update assessment within current profile/aggregation
on demand has been added.
• The possibility to define Schedule of 'Out Active' in the Profiles view has been
introduced.
• The option and shortcut ([Ctrl]+[Alt]+[Z]) to revert edits on message in the
Messages and Aggregations context menu has been added.
• Geo-location helper in the Twitter ‘SearchGeocode’ parameter has been added.

• New social media driver RSS has been introduced.
• New social media driver Flickr along with the possibility to download Flickr video
has been introduced.
• The Event Moderation functionality has been added.
• The Aggregation View now has a column with the name of the original source profile
of the message.
• A new option for profiles creation: filter by language has been added.
• Filter Profanity - a new option: replace inadequate words with *** has been added.
• Support for downloading videos from Twitter (native and Vimeo format) has been
introduced.
• Support for downloading videos from Facebook (native and Vimeo format) has been
introduced.
• The Auto- Aggregation mode has been added.
New Features in Social Media Hub 3.0 | 9

• The User operation tracking functionality has been added;

• Social Media Hub Panes have been added to the MediaCentral |UX platform.
1. Introduction
New Features in Social Media Hub 3.0 |

10
Conventions Used in This Document
This symbol marks a step-by-step procedure.
NOTE:
A note specifies useful or optional information, relevant to the preceding text.
TIP:
A tip provides useful information on shortcuts, or how to do things differently.
Bold text marks a part of the User Interface such as a menu item, dialog box name, or
button. For example, “click OK”.
ALL CAPITALS text specifies a keyboard key. For example, “press CTRL and drag the
name...”.
1. Introduction
Conventions Used in This Document | 11

2. Setup
In this chapter:
Starting SMH on page 13
Client Application Overview on page 15
Social Media Hub Views on page 20
Authorization on page 47
Starting SMH
During the installation, SMH shortcuts are created on the desktop and in the Start
menu. Two configurations can co-exist:
• Client and Server: Where the Server, the SQL database and the client interface are
installed on the same computer.
• Client only: Where only the client interface is installed (i. e. a journalist station) and
communicates with the server installed on another computer.
To Start SMH:
1. Double-click the Media Hub shortcut on the desktop.

Or-
From the Start menu, select All Programs > Orad > Media Hub.
2. If the SMH Service is installed on the same machine as the client and is not
currently running, then the Settings window is displayed.
In the Service tab, select Start Service.
2. Setup
3. In the Login window type your Login and Password as assigned to you by the
system’s administrator.
Starting SMH | 13
The application main window opens. The current project and your login name are
indicated in the Title bar.
NOTE:
The layout of the application screen may vary, depending on user rights, the
license module installed, and previous settings.
To log off the system:

■ From the View menu select Quit.
Or -
From the Tools menu select Logout...
2. Setup
Starting SMH |
14
Client Application Overview
This section describes an administrator client. Other clients display only the elements
they have access to, as set by the administrator. For more information see Users on
page 39.
The last layout set by each user is saved when you log out and is displayed when you
next log in.
Two elements are always visible:
• The menu bar
• The application toolbar
All other windows or views can be shown, hidden, and arranged by each user as
required.
2. Setup
View Tab and The Application Toolbar
Use the options from the top menu View to show the required windows or views.
Some of the items are also available from the application toolbar for quick access
Projects Open the Projects window.For Also available from the

more information, see Projects
on page 20. toolbar .
Keyboard shortcut: CTRL+1.
Profiles Open the Profiles window.For Also available from the

more information, see Profiles
Profiles► Open one of the predefined

profiles.
Client Application Overview | 15

Aggregations► Open one of the previously
created aggregations. For more
information, see Aggregating
Messages on page 71
Events Open one of the previously

Moderation► created Events windows
marked for moderation. For
more information, see Events
Moderation View on page 34.
Events Open the Events window. Also available from the

For more information, see
Events on page 32. toolbar .
Clients Open the Clients window Also available from the

Clients on page 37. toolbar
Rules Open the Rules window.For Also available from the

more information, see Rules on
page 38. toolbar
2. Setup
Users Open the Users window. Also available from the

Users on page 39. toolbar
Logs Open the Logs window. Also available from the

For more information, see Logs
on page 42. toolbar
Statuses Open the Event Statuses Also available from the

window. For more information,
see Statuses on page 44. toolbar .
Notifies Open the Notifies window.For Also available from the

more information, see Notifies
Show/Hide Show or hide undocked Keyboard shortcut:

Undocked windows. For more information CTRL+Tab.
see Arranging the windows \
views on page 17.
Client Application Overview |

16
Default Layout Revert to the default windows
arrangement layout.
For more information see
Arranging the windows \ views
on page 17.
Settings Open the system Settings Also available from the

window. For more information,
see Setting Preferences on toolbar .
page 75.
Keyboard shortcut: CTRL+/.
Quit Log out and close the Keyboard shortcut: ALT+F4.

application.
To relocate the toolbar:

1. Point to the white line near the Projects button.
The pointer changes shape to crossed arrows.
2. Drag the toolbar to the required location on the screen.
The toolbar is detached from the client application.
To move the toolbar to its default position:

■ From the menu select View > Default Layout
The toolbar returns to its original place and the windows are moved and resized to
2. Setup
the default layout.
Arranging the windows \ views

In their original form, the windows in the client application are docked.

To change the dimensions of a docked window:
• Drag and drop one of the windows inner edges.
To superimpose one window over another (combine):

1. Drag one of the windows by its heading and release it over the other one.
The windows are combined into one window with a lower tab for each window.
The side header reflects the selected tab name.
2. Setup
To undock a window:

• Click Undock.
To dock a window:

1. Drag the window by its header inside the client windows area until a blank space is
visible behind.
2. Release the window.
To move a window without docking it:

■ Press the CTRL button while moving the window.
Client Application Overview |

18
To show or hide undocked windows:
• From the menu select View > Show \ Hide Undocked.
Or
Use a the keyboard shortcut Ctrl+Tab.
The Show Removed option:

• The Show Removed option allows the administrator to restore or purge a
previously deleted user/project/profile/aggregation.
• To activate this option, select the Show Removed button.
2. Setup

Social Media Hub Views
Projects
Generally, a project is a group of profiles and aggregations that are joined by a specific
topic. For example: social media messages for an evening news show, a reality tv
series, or sports events.
A project might include profiles of social media accounts, rules to indicate messages
and assess them, events to publish broadcast content from control applications to
social media, etc. Using projects enables you to define users for the projects and
manage their rights for every project separately.
NOTE:
An Administrator has access to all the features described in this section. Other
users might have access to some of the features or none of them, depending on
their user rights. For more information, see Users Access Levels on page 41.
When you first log in, your current project and user name are indicated near the left
top header of the client application.
2. Setup
To activate a different project (i.e. change between projects):

1. From the menu select View > Projects, or select Projects from the toolbar.
The Projects window appears.
2. Right-click on the project that you want to activate from and click on Activate
Social Media Hub Views |

20
The project you selected becomes the current project.
To create a new project:

1. From the menu select View > Projects.
The Projects window appears.
2. Select Add.
A NewProject line appears at top table.
3. Double-click on the NewProject and name the project.
Projects Section
Use the Projects section to manage projects.The following paragraph describes the
Projects section for an Administrator user. Users with other rights might not have
access to all features. For more information, see Users Access Levels on page 41.
Quick Filter The text or numbers that you want to search for in the Name
column or choose a recent search from the drop-down box.
Use ? to represent any single character or * to represent a series
of characters.
Clear the filter.
Show the removed projects list.
2. Setup
Name The name of the project. Double-click or press F2 to rename the
project.
Lock Enable this checkbox to prevent a specific project from being

removed.
Created The date and time the project was created.
Modified The date and time the project was last modified.
Accessed The date and time the project was last accessed.
Add Select to add a new project.
Clone Select to clone the selected project. The cloned project will be
created using the original project name and the suffix _1 ,_2
etc. The cloned project is created together with all original
parameters and referred aggregations.
Remove Select to remove a selected project. Removed projects are

transfered to the removed project list.
Activate Select to make a selected project current project.
Restore
Available when is selected.
Click to restore a selected project to the active projects list.
Purge
Click to permanently delete all previously removed projects from
the system.
Social Media Hub Views | 21

Profiles Section
Use the Profile section to manage profiles associated with projects. The following
paragraph describes the Profile section for an Administrator user.Users with other
rights might not have access to all features, for more information see see Users Access
Levels on page 41.
Quick Filter Enter the profile name that you want to search for, or choose a
recent search from the drop-down box.
of characters.
Clear the filter.
Select to show only included profiles
Name Profiles names.To rename, double-click and select Rename.
Include Enable this checkbox include the profile in the selected project.
When a project is active, any created profile is automatically
added to the current project. Removed profiles are automatically
removed from the current project, and the restored ones are
automatically added.
Aggregations Section
2. Setup
An aggregation is a collection of filtered and assessed messages.
Quick Filter Enter the aggregation name that you want to search for, or
choose a recent search from the drop-down box.
of characters.
Clear the filter.
Select to show only included aggregations.
Show removed aggregations.
Name Aggregations name.
Include Select this checkbox to include the aggregation in the selected

project.
Default Check to make the selected aggregation default for this profile.
Add Select to add new aggregation.
Remove Select to remove a selected aggregation.
Restore
Click to restore an aggregation to the active projects list.
Purge
Available when is selected.Click to permanently delete all
previously removed aggregations.

22
Rename Available only from the aggregation line shortcut menu.
Click to rename selected aggregation.
Global Rules Section

Use the Global Rules section to select rules to be associated with the projects.
Dictionary Select the dictionary to be used for the chosen project. The
dictionary is active only if there are no rules selected on the
profile level.
Black/White Select the black/white list to be use for the chosen project. The
List black/white list is active only if there are no rules selected on the
profile level.
Global Thresholds
Use the Global Thresholds to automatically define the status of incoming messages.
When a message arrives, it receives a score according to the defined rules. After the
scoring is done, tags (Removed, Unwished, Desired) are applied according to the
values set in the following boxes. Messages, which receive the Removed tag will
automatically appear in the removed messages list.
Removed Set the threshold value for a message to be tagged Removed.

In case a message is below the minimum threshold, it will not be
2. Setup
shown in the list.
Unwished Set the maximum value for a message to be tagged Unwished.

Any message scoring above the Removed threshold and up to
this value will receive this tag.
Desired Sets the minimum threshold value for a message to be tagged

Desired. Any message above this value will receive this tag.
NOTE:
Messages scoring above Unwished but below Desired will not receive any tag.
Profiles
A profile is a collection of messages (which can include a profile picture, an image, a
link to a clip, the amount of likes and the message itself) originating from defined
social media accounts, such as Facebook, Twitter, Instagram, Never.no, Mail, RSS and
many more.
To create a profile you need to define the following parameters:
• The authorization parameters for sending and receiving data from the specific social
media accounts.
• Characteristics or rules for the messages you are interested in.
• The assessment rules for the messages.

Profiles Section
Use the Profiles window to create, manage and delete profiles.
2. Setup
To create a new profile:

1. From the menu select View > Profiles.
2. Click on Add.
3. Double-click on the newly created profile to rename it.
4. From the Driver dropbox, select the profile driver required for the chosen social
media.
NOTE:
The number of displayed drivers is determined by the license.
5. If this is the first time you use the chosen social media type, select Authorize and
perform the authorization process. For more information on authorization, see
Authorization on page 47.
The profile table displays the existing profiles. Note, that some social media sites limit
the amount of messages you can download. It is recommended that you create a
different account for each project.
of characters.

24
Clear the filter.
Show the removed profiles.
Name Profile name.
Driver The name of the selected social media driver.
In Active Check to enable the profile to receive messages. Clear to

suspend the profile from receiving messages.
Out Active Check to enable the profile to post broadcast content to social
media. Clear to suspend the profile from posting messages. Set
to intermediate in order to enable the Activate Out Schedule
settings.
NOTE:
When the Activate Out Schedule is set by the user the
Out Active is automatically set to intermediate.
Lock Check to prevent a profile from being deleted.
Created The date and time the profile was created.
Modified The date and time the profile was last modified.
Accessed The date and time the profile was last accessed.
Active out Use the dropdown box to set a schedule for the profile to post
2. Setup
Schedule messages. If the From time is set higher then the To time, the
schedule begins from the From time to midnight, and continues
from midnight to the To time.
NOTE:
The In Active state and operation is not affected by the
Activate Out Schedule.
Add Select to add a new profile.
Clone Select to clone the selected profile with its parameters. The old
user profile will be cloned with the suffix _1, _2 etc.
The newly created profile is automatically included in the active
projects list.
Remove Select to remove the profile.
Assign Select to include the selected profile in the current project.
Restore Visible when Show Removed is selected.

Click to restore the selected profile back to the active profiles list.
Purge Visible when Show Removed is selected.

Click to permanently delete all removed profiles.
Profile Driver Section (Profiles Window)

Use the Profile Driver section to manage the parameters needed for downloading
social media content into Social Media Hub. Some of the features in this section
depend on the kind of social media and the license type. It is recommended to create a
different account for each project.

The following parameters are common for all social media types:
Driver Select the social media type to communicate with.

The list of available social media drivers depends on the license.
Authorize Use to start the authorization process for social media profile.
This process is performed once for each social media account.
Not all profiles require authorization. For more information about
authorization see Authorization on page 47.
Help Select to open detailed instructions on how to authorize the

selected social media type.
NOTE:
You can use the same social media account for different profiles. In such cases, it
is recommended to clone the driver, rather than to authorize a completely new
account.
Mail Driver Parameters

Use the mail parameters section to enable Social Media Hub to read e-mail messages
from a chosen e-mail account (Read only). The Mail driver does not need to be
authorized.
AvatarPath Set the avatar image to be used for all messages captured by
2. Setup
this profile.
The default image is Images/SMH_DefaultMail1.jpg.
NOTE:
The Social Media Hub service must have access to the
image folder. The default location for this folder is
C:\Orad\MediaHub\Images directory.
FolderName The folder to look for messages of the e-mail account. Usually, it
is the Inbox folder.
InitFeedDays Enter the time period, in days, to look for messages in. The
search within this period is limited to a maximum of 2000 newest
messages. Once the search ends, this parameter changes to “-”
and only new messages are received.
MailPort The IMAP port number for receiving mails. The default port
address is 993 secure.
MailServer The address of the mail server.

NOTE:
Only the IMAP mail server is supported, and a direct
connection to the IMAP data source is required.
User The user name for the e-mail account on the IMAP server
Password The password for the above user.

26
Facebook Driver Parameters
Use the Facebook Parameters section to enable Social Media Hub to retrieve
Facebook's content.
AccessToken The access token received from Facebook during the

activation process.
AppID The application ID received from Facebook during the

activation process.
AppSecret The application secret password obtained from Facebook

during the activation process.
Expires The expiration date of the above access token.
InitFeedDays Enter the time period, in days, to look for messages in. The
search within this period is limited to a maximum of 2000
messages. Once the search ends, this parameter changes to
“-” and only new messages are received.
ReadSubPostID A Facebook post identifier which allows to search only within

comments to this post.
ReadUserID The Facebook user ID.

The user ID appears at the end of the Facebook URL:
https://www.facebook.com/ReadUserID.
User The account user name.
2. Setup
UserID Facebook internal User ID (automatically filled).
Flickr Driver Parameters

Use the Flickr Parameters section to retrieve Flickr content (posts) and store them in
Social Media Hub.
AccessToken The access token received from Flickr during the

authorization process.
AccessTokenSecret The access token received from Flickr during the

ConsumerKey The Flickr authorization consumer key received during the

authorization.
ConsumerSecret Your Flickr authorization secret key received during the

authorization of the Flickr service.
InitFeedDays The past time period, in days, to look for posts in. The
messages. Once the search ends, this parameter changes
to “-” and only new messages are received.
ReadSubPostID A Flickr post identifier which allows to search only within

comments to the selected post.
ReadUserName The Flickr user ID to capture pictures from.

SearchGeocode The latitude, longitude, radius and measure unites of the
area to search images in.
Example: 40.695245418359,-89.590446472168,10km
See To set a location using the Pick Map Area tool: on
page 28.
User The account you authorized with.
To set a location using the Pick Map Area tool:

1. Select near the SearchGeocode box.
The Pick Map Area window appears.
2. Setup
2. Enter the name of the location you are looking for and select Search.
The location appears at the center of the map.
3. Adjust the position of the pin by dragging it and clicking the map.
4. Adjust the radius of search by using the slider or the number box.
5. Select Pick.
The coordinates for the search appear in the SearchGeocode box.
NOTE:
The radius search of SearchGeocode is limited by Flickr to a maximum of 32km,
approximately 20 miles.

28
Instagram Driver Parameters
Use the Instagram Parameters section to retrieve Instagram content (posts) and
store them in the database.
AccessToken The access token received from Instagram during the

activation process.
ClientID The Client ID obtained from Instagram during the activation

process.
ClientSecret The Client Secret password received from Instagram during

the activation process.
InitFeedDays The past time period, in days, to look for messages in. The
newest messages. Once the search ends, this parameter
changes to “-” and only new messages are received.
ReadSubPostID An Instagram post identifier to search only within comments

to the specified post.
ReadUserName The Instagram user name.
SearchQuery Set an Instagram hashtag to only search for messages

containing the given hashtag.
• The search is limited to one hashtag.
• You can enter the hashtag with or without the # sign.
2. Setup
• When using this parameter, the ReadUserName and
ReadSubPostID parameters blank.
User The Instagram user account name.
UserID Instagram internal User ID (automatically filled).
never.no Driver Parameters

Use the never.no Parameters section to enable Social Media Hub to capture never.no
account posts (read only).
InitFeedDays Enter the past time period, in days, to look for messages in.
The search within this period is limited to a maximum of
2000 newest messages. Once the search ends, this
parameter changes to “-” and only new messages are
received.
ServerUrl Give the server feed address to get the messages from,
e. g.:
http://storyusdemo1.never.no/xml/feed/story_demo3_A.xml

MassRelevance Driver Parameters
Use the MassRelevance Parameters section to retrieve MassRelevance posts. (read
only).
received.
ServerUrl Give the server feed address to get the messages from,
e.g.:
http://api.massrelevance.com/MassRelDemo/kindle.json
NOTE:
In April 2014, MassRelevance merged with Spredfast.
RSS Driver Parameters
Use the RSS Parameters section to enable Social Media Hub to capture RSS feed
posts (read only).
Content Select the data type you would like to capture from the RSS
feed:
2. Setup
• Title: Download the titles of the messages.

• Description: Get the description of the messages.
ServerUrl The RSS feed address
Twitter Driver Parameters

Use the Twitter Parameters section to retrieve Twitter content (read only).
AccessToken The access token received from Twitter during the

AccessTokenSecret The Twitter authorization access token secret string

received during the authorization.
ConsumerKey The Twitter authorization consumer key received during the

authorization.
ConsumerSecret Your Twitter authorization secret consumer key received

during the authorization.
received.
ListName Enter the name of the Twitter List, that you want to use to
capture messages from.

30
SearchGeocode • Fill in to limit the tweets received to a specific
geographical area.
• Use the following format: Latitude, Longitude, Radius,
Unit (mi/km).
Example: 37.781157,-122.398720,1mi
• For more information go to:
https://dev.twitter.com/rest/reference/get/search/tweet
s
SearchLanguage To narrow your search to a specific language select it from

the drop-down list.
NOTE:
In order for the language search to succeed, it must
be correctly set by the Twitter user who posted the
tweet.
SearchQuery • A UTF-8, URL-encoded search query of 500 characters

maximum, including operators. Queries may additionally
be limited by complexity.
https://dev.twitter.com/rest/reference/get/search/tweet
s
Examples:
•@account_name
•#ibc
2. Setup
•#nab - #ibc
NOTE:
When you are using SearchQuery, leave
SearchUserName blank.
SearchUserName The name of the user whose tweets you want to capture.
• Select between the screen_name or the user_id.
https://dev.twitter.com/rest/reference/get/statuses/user
_timeline.
UseStream Change to yes to receive data, at the moment messages

are posted.
NOTE:
Only one stream can be used per one user account at
the same time.
User Username used during authorization.
UserID Your authorized Twitter ID.
YouTube Driver Parameters

Use the YouTube Parameters section to publish rendered broadcast videos and post
them to YouTube (write only).
AccessToken Access token obtained from YouTube during the

authorization

ApiKey API server application authorization key obtained from
YouTube during the authorization.
ClientID Native application client ID obtained from YouTube during

the authorization.
ClientSecret Native application client secret key obtained from YouTube

during the authorization.
Expires Expiration date and time of the Access Token.
RefreshToken Validation refresh token obtained from YouTube during the

authorization.
User User name obtained from YouTube during the authorization
NOTE:
You can not upload the same movie twice to YouTube.
Events
The Events view is used to configure and define events. Most events are based on
Java script and are used to publish content to social media services.
2. Setup

32
Events Section
Use the Events section to manage available events.
Quick Filter Enter the event name that you want to search for, or choose a
of characters.
Clear the filter.
Show the removed events.
Event Event name.
Active Check to enable the event.
Locked Check to prevent an event from being deleted.
Moderated Enable Events Moderation for the selected event.
Created The date and time the event was created.
Modified The date and time the event was last modified.
Accessed The date and time the event was last accessed.
Import Select to import an event in form of a Java script file.
2. Setup
Add Select to add a new event.
Clone Select to clone the selected event with its parameters. The old
user event name will be cloned with the suffix _1, _2 etc.
The newly created event is automatically included in the active
projects list.
Remove Select to remove the event.
Test Select to test the selected event.
Restore Visible when Show Removed is selected.

Click to restore the selected event back to the active events list.
Purge Visible when Show Removed is selected.

Click to permanently delete all removed events.
Events Parameter Section
The Event parameter section displays the parameters of the selected event.
Use Enable Events Moderation for the selected event.

Moderation
Profile
Script File Allows selecting or changing scripts assigned to a specific event.

When a script is selected or changed, the lists of arguments and
properties are imported from the script file, if this script contains
necessary routines.

Arguments
Obligatory Indicates whether the selected argument is obligatory.

• External applications must send all obligatory arguments.
• Other arguments are optional.
• This value can be changed only at the script level.
Name The name of the parameter as visible at the script level.

• Unnamed parameters receive internal script names, starting
with arg1,arg2, etc.
• Names cannot be changed by the user.
Type The type of the selected parameter.
Test Value The argument value which will be sent to the event when the Test
button is pressed.
Comment The parameter comment as it appears on the script.
Properties view illustrates the connection of the selected event wit a specific profile.
Two events, which are using the same script, may use different profiles, which can be
defined in the Properties options described in the table below.
Properties
Name Name of the property as visible on the script level.

2. Setup
• This value cannot be changed by the user
Value The value which will be used by the event when it is executed. In
most cases it will define the profile name.
• This value can be changed by the user.
Description The parameter comment retrieved from the script.

• This value cannot be changed by the user.
Events Moderation View

The Events Moderation functionality has been added to allow for moderation of the
events which are coming from external applications, such as Maestro or 3DPlay. When
a control application sends an events (e. g. a post on a Facebook page), the Moderator
first finds this event in the Event Moderation window to assess whether that content
should definitely be published to the dedicated social media service. If an event is not
moderated, it is executed immediately after the control application has requested it.
Moderated events first land in the corresponding Events Moderation view to be further
evaluated.
To enable the Moderated mode for specific events:

1. Open the Events view from the toolbar or from the View menu.

34
2. Select the event that should be moderated and enable the Moderated checkbox.
3. The events marked as Moderated will appear in the View > Events Moderation
window.
The Events Moderation view shows events received from external control application
marked as Moderated. It is used to process these events and decide which of them can
be sent for execution:
2. Setup
The following options and parameters are available in the Events Moderation view:

Events Moderation
Time Range Set the time frame to display the events. Selecting Custom
gives the option to define the time range between a start date
and an end date . The start and end dates can be
selected from a pop-up calendar.
Event Filter Enter the name of the event to be used as a filter. It is also
possible to select from a list of recent values.
Content Filter the events by Content Overview. It is also possible to select

Overview Filter from a list of recent values.
Statuses Filter the events according to their status. Processed events (i. e.
events which have already been processed and sent for
execution) can be hidden from the view.
Ratings Filter the events according to their set rating.

2. Setup
• [Alt+1] to [Alt+0] range - set filter to events with ratings

equal or higher than specific value;
• [Alt+~] clear rating filter
Defaults Select to revert the filters to default values.
Apply Select to apply the chosen filter to the listed events.
Show removed events.
Events List
Event Name The original event name.
Event Content Displays the overview of the received event.

Overview NOTE:
It is not possible to edit the arguments of the events in this
window.
Status Displays the status of the received event:
• the event has been processed and sent for execution;
• the event has been removed;
Received The date and time on which given event has been posted from a
controller application.

36
Rating Event ratings assigned manually to the event by a moderator.
This field helps to find or filter events according to desired
criteria.To set the rating of the event, click on the star or
between stars or use the keys [0] to [9] when particular event is
selected.
Clients
The Clients view shows all currently and previously connected instances of API
(including Windows clients).
Use the Clients section to manage all connected machines.
Clients
IP Number Enter an IP number to be searched for, or choose a recent search

from the drop-down box. Use ? to represent any single character
or * to represent a series of characters.
Name Enter the host name of the client to be searched for, or choose a
recent search from the drop-down box. Use ? to represent any
2. Setup
single character or * to represent a series of characters.
Connected Enable to display only the connected clients.

Only
Clear Select it to permanently remove disconnected clients from the

Disconnected list.
Clients List
Events Enable the option to handle events for the selected client.
Aggregation Enable the option to handle aggregations for the selected client.
IP Number The IP number of the client.
Host Name The host name of the client.
Connected Indicates whether the selected client is connected or

disconnected.
Time Displays the last time the client has been connected via API.
Connected
Time Displays the last time the selected client has disconnected from
Disconnected the API.
Client Type Displays the client type.

• GUI - a Social Media Hub window
• Client - an external application, such as Maestro.

Rules
Rules help you prioritize social media content, by grading them with points.
The following options are available in the Rules View for an Administrator user.
Rules Section
Quick Filter Enter the name of the rule to be searched for.

Use ? to represent any single character or * to represent a
series of characters.
Clear the filter.
Select to show removed rules.
Name The name of the rule. Double-click or press F2 to rename

the rule.
Active Enable to activate the rule.
Lock Enable to prevent the rule from being deleted.
Created The date and time the rule was created.
Modified The date and time the rule was last modified.
Accessed The date and time the rule was last accessed.
2. Setup
Add Select to add a new rule.
Clone Select to clone the selected rule. The cloned rule will be
created using the original rule name and the suffix _1 ,_2
etc.
Remove Select to remove a selected rule. Deleted rules are

transfered to the removed rule list.
Import Select to import a list of phrases in a CSV file format.
Export Export the current list of phrases in the rule into a CSV file.
Restore
Click to restore a selected rule to the active rules list.
Purge
Click to permanently delete all previously removed rules
from the system.
Phrases Section
Phrase An expression or part of an expression to look for in a

message. Use ? to represent any single character or * to
represent a series of characters. The phrase is NOT Case
sensitive.
Burden The amount of point a message is given if the phrase or

variants of that phrase were found in it.

38
Variants A list of alternative phrases, separated by a semicolon (;)
Add Add a new phrase.
Remove Delete the selected phrase line.
Evaluate Phrase Enter an example sentence to test the evaluation process.
Evaluate Select to begin the evaluation of the entered text.
Result The sum of points awarded to the text based on the created
rules.
Users
The Administrator sets up and maintains system users and their rights.
To add a new user:

1. Select File > Users.
2. Select Add.
A NewUser is added to the list of users.
3. Right click NewUser, and select Rename or press F2.
2. Setup
4. Type the login name of the new user.
5. With the user selected, set the following:
Real Name
Default The default rights of the user for specific projects.

Rights For information on access levels, see Users Access Levels on
page 41
Active Select this check box to activate the user and allow access
to SMH. Clear to prevent a user from logging in to SMH. The
administrator’s status is always active. For more
information, see Users Access Levels on page 41.
Lock Select this check box to prevent a user from being deleted.
The administrator account is always locked. For more
information, see To remove a user: on page 41.
Created The date and time the user was created.

Modified The date and time the user permissions were modified.
Accessed The date and time the user last accessed the system.
Users Use it to map MediaCentral |UX SMH users with the users of
mapping the desktop SMH application. For more information, see
MediaCentral |UX User Mapping in the SMH Desktop GUI on
page 84.
Add
Clone Select to clone the selected user. The suffix _1, _2 etc. is
appended to the original user name.
Remove Select to remove the user. The user is then moved to the
Removed Users list and becomes inactive. To learn how to
restore a user, see To restore a previously removed user: on
page 41.
Restore
This button is active when the Show Removed option
is selected. It facilitates restoring a previously deleted user.
The User is restored with an Inactive status. For more
information, see To restore a previously removed user: on
page 41.
Set Select to set the password for the new user. The password
Password must contain at least eight characters using both numbers
and letters.
2. Setup
User
Information
Quick Filter Select to search for a specific project.

Use ? to represent any single character or * to represent a
series of characters.
Project Display the list of projects in the system.
Rights Select to set the user rights for a specific project. If the
Default Rights above for the user are set to Admin, all
project rights are automatically set to Admin and cannot be
changed. For information on access levels see Users Access
Levels on page 41.
NOTE:
Newly added or cloned users are inactive by default. Activate the user after
setting the password and all necessary rights.
TIP:
All tables can be sorted by clicking the column header you to sort by. Clicking the
column header again reverts the sorting order.
To change your own password:

1. From the top menu select Tools> Change Password.
2. Type your old password.
3. Type the new password.
The password must be at least 8 characters long and contain numbers and letters.

40
4. Retype the newpassword.
5. Select Change.
The new user password is set.
NOTE:
Your password can be changed by an administrator even while you are connected
to SMH.
To remove a user:

1. From the users window, right click on the user you want to delete.
2. Select Remove from the popup menu or simply press Delete on your keyboard.
You can also highlight the user and press the Remove button.
The user account disappears. The user is moved to the removed users list and
becomes inactive.
To restore a previously removed user:

1. Select the Show Removed button.
2. Right click the user account that you want to restore and then click Restore from
the popup menu.
or
Select the user that you want to restore and then click the Restore button.
The user disappears from the removed users list.
2. Setup
NOTE:
Restored users are inactive by default. You need to activate the user from the
existing users list after setting any other right as necessary.
Users Access Levels

The following table specifies the actions associated with each user access level (Default
Rights) that an administrator can set for users.
Option Inactive Def. Viewer Aggr. Manager Admin

NNN
System login. V V V V V
See the list of projects. V V V V V
Activate a project. V V V V
See profile messages, V V V V

aggregations &
moderated events.
Aggregate and process- V V V

messages,
moderated events.
Define auto-aggregation. V V V
Set messages rating. V V V
Edit messages. V V V

Remove messages. V V V
Access Profiles view. V V
View only profiles within V V V V

loaded project.
Access all administrator V

panels (users, rules, full
project, logs, etc.)
Set server address / V V V V V V

proxy.
Start / stop service on V V V V V V

local host.
Access Settings > V V V V V V

language
Access Settings > V V V V V V

Database (Localhost)
Access Settings > V V

database

maintenance
2. Setup

Aggregation
Set own image V V V V V
Logs
The Logs view displays all log events and entries, which have been captured by the
Social Media Hub application.
The following options and parameters are available in the Logs window:
Logs
Time Set the time frame to display the log events.

42
Severity Define which log events will be shown according to their severity.
Source Select the sources of the log events.
Instance Enter the name of the instance to be searched for. Log events
with that instance will be displayed.
of characters.
Message Enter the text of the message to be searched for. Log events with
that message will be displayed.
of characters.
2. Setup
User Select the user for which to show the logs events.
Logs list
ID Displays the Internal ID of the status.
Date Displays the time when the entry was added to the log.
Severity Displays the type of the log entry.
Source Displays the source of the log entry.
Instance Displays the property instance which caused the log entry.
Message Displays the description of the log entry.
Available Severity Types

The following table describes the list of possible types of severity that a log entry can
receive.
CRITICAL Fatal error or application crash.

[Critical]
ERROR Recoverable errors in behavior.

[Error]
WARNING Warning messages.

[Warning]

INFO Information messages which are not warnings, nor critical, or
[Info] standard errors.
DEBUG/ Debugging trace information for Avid support.

INTERNAL
[Internal]
START Information about starting various parts of application.

[Started]
XX% Information about the progress of certain events.

[Progress]
SUSPEND Information about the events which have been suspended.

[Started]
OK Information about closing of various parts of application.

[Finished]
BREAKING Information about breaking of various parts of application

[Breaked]
NOTIFY Notifications which may require user attention.
CONF_NOTIFY Notifications which have been confirmed.

[Notification]
Statuses
2. Setup
Event Status window shows the information about the current running events.
All available options and parameters are illustrated in the table below:
Events Status
Time Defines which events will be shown according to their start time.

44
Status Defines which events will be shown according to their status.
Event Enter the name of the event to be searched for.
Parameters Enter the name of the parameter to be searched for.
Client Enter the name or the IP address of the client to be searched for.
Events List
ID Displays the Internal ID of the status.
Status Displays the current status of the specific event execution

instance. For more information, see Available Status Options on
page 45.
Event Displays the name of the event.
Parameters Displays the parameters provided to the event when it started.
Start Displays the time the event was started.
Stop Displays the time the event was stopped.
2. Setup
Client Displays the IP address of the client which issued the event.
Uuid Displays the identifier the of event execution, which is required

to identify the given run by the API.
NOTE:
The number of listed statuses is limited to 2000 entries.
To break an event:

■ Right-click on the event to be stopped, and select Break.
To break all events:

■ To stop all events, right-click on any event, and select Break All.
Available Status Options

The following table describes the list of possible event statuses. Square brackets show
the names used in filters.
STARTED Event is currently being processed.

[Started]
XX% Event is being processed and the current progress of the

[Started] operation is indicated with a percentage. This type of status is
only available for events which have longer processing times.
SUSPENDED Event execution is suspended due to processing of the sub.

[Suspended]

BREAKING Event execution is currently being stopped on user request.
[BREAKED]
BREAK Event execution has been stopped by the user before it has
[BREAKED] finished processing.
OK Displays the time the event was stopped.

[Finished]
ERROR Event finished processing without errors.

[Error]
CRITICAL Event finished processing with a critical error.

[Critical]
DENIED The request to start the event has been received, but it was
blocked due to the running privileges (either on an event level or
on the Client level).
Notifies
The Notification view shows specific type of log entries called notifications. These log
entries require user intervention or actions.
2. Setup
All available options and parameters are illustrated in the table below:
Confirm All Confirm all existing notifications.
Event Displays the information about the type of the event that the
notification concerns.
Time The date and time the notification occurred
Confirm Confirm the selected notification.
Message area Displays the content of the notification.
Settings
The Settings window displays the available customizing options. For more
information, see Setting Preferences on page 75.

46
Authorization
Many social media services require a developer application account with special
privileges, before you can retrieve or publish social media content via 3rd party
applications, such as Social Media Hub. For this purpose, a new account has to be
created. Some of the social media services use additional security measures, such as
tokens and secret passwords, that must be transmitted before each communication.
The Authorize option in the Profile initiates the authorization process on the social
media service and simultaneously updates the Social Media Hub with the necessary
details. In some cases, certain sections need to be filled manually.
TIP:
To save time, you can clone a profile with all its authorization details. It is
recommended not to use the same account for different projects.
TIP:
You can view the authorization instructions within the Social Media Hub
application. Click on the Help button below the list of Profiles.
Supported Social Media Interfaces and Features

The following table illustrates the available social media services, along with their
supported features.
2. Setup
Remarks
1. Supports streaming of messages.
Authorization | 47
2. The hashtag as well as any other query parameters are available within the Twitter
tool.
3. Native format of clips.
4. Vimeo format of clips.
5. YouTube - Identical movies cannot be uploaded more than once. YouTube will ignore
duplicates, while the upload process may be reported as successful.
6. Facebook - It’s not possible to send identical messages consecutively more than
once. To send images, Facebook token needs to be authorized and up-to-date.
7. Twitter -
• It’s not possible to send identical messages consecutively more than once.
• Video can be posted as a link to an external video source (For example:

YouTube).
8. Mail – The subject is stored in the Publisher field of the message, the content is
stored as Message, an attached picture stored as Image. Only the first attached
image is captured.
9. MassRelevance - This is an aggregation platform service. Currently the supported
sources are: Twitter, Facebook, Instagram, Google+.
10.RSS - Various RSS sources provide various types of data inside the RSS Stream,
like title, description, general stream and message thumbnails. Not all of them are
supported.
2. Setup
Authorizing Facebook
Social Media Hub is capable of posting to and receiving messages from Facebook.
To Authorize SMH to post and receive messages Facebook:

1. If you don’t have a dedicated Facebook account, go to https://www.facebook.com/
and create an account.
2. If you don’t have a Facebook developer application, go to the Facebook For
Developers site at http://developers.facebook.com/apps and select Create a New
Application.
3. Select the Apps menu and click on Create a New App. In the following window,
enter the name of the application and select the Category. Press on Create App and
follow the Security Check.
Authorization |
48
4. Once the application is created, go to the Settings tab, select Add Platform and
add the following URL: http://www.avid.com/SMH/index.html.
5. Click Save Changes.

6. Under the Advanced tab, enable the Native or desktop app option and save your
changes.
7. Make the application public:
2. Setup
8. In Social Media Hub, create a new profile with the Facebook driver, and select
Authorize.
Authorization | 49
9. In the Social Media Hub Driver Parameters window, fill in the relevant Facebook
User and Password, and Facebook’s App ID and App Secret.
10.Select OK.
The Facebook login screen opens.
11.Login with the relevant Facebook authentication details.
2. Setup
12.In the Submit for Logon Review window, select OK.

13.Set the post level of messages to Public.
14.Assign the newly created Facebook profile to the publishFacebookMessage
event.
15.In the Events window Arguments section fill in a test message text and select
Test.
If the text message appears on your Facebook wall, the authorization process was
successful.
NOTE:
If the Facebook profile was already authorized, Social Media Hub will skip some
of the above steps.
Authorization |
50
Authorizing Flickr
Social Media Hub is capable of receiving messages from Flickr.
To authorize SMH to receive messages from Flickr:

1. If you don’t have a Yahoo/Flickr account, go to http://www.flickr.com/, select Sign
Up to create a new account.
2. If you already have a developer application, go directly to step 7.
3. Go to The App Garden website at https://www.flickr.com/services/api/ and select
Create an App.
4. Select Request an API key.

5. Choose the character of the application: Commercial or Non-Commercial.
Give the application details and accept the License Terms.
6. Generate an API Key and Secret Key to configure a new profile on Social Media Hub.
2. Setup
If you already have a key and secret select Aps by You from The App Garden
website at https://www.flickr.com/services/api/
7. Create an SMH profile with Flicker driver, select Authorize. Flickr authorization
window opens. For more information on creating profiles, see Authorization on
page 47.
8. Use the your Flickr account user name, Key and Secret for the profile driver
parameters on SMH and click on OK. For more information, see Flickr Driver
Parameters on page 27.
NOTE:
If the Flickr profile was already authorized, Social Media Hub will skip some
steps.
Authorization | 51
Authorizing Instagram
Social Media Hub can receive from and post messages to Instagram.
To Authorize SMH to receive messages from Instagram

1. If you don’t have an Instagram account, use a mobile device to download and install
the Instagram application and create an account.
2. Go to http://instagram.com/developer/# website using a browser and create a new
application.
3. If you already have a registered Instagram application, select Manage Clients to
get your CLIENT ID and CLIENT SECRET, then go directly to step 9.
4. Select Register Your Application and enter the required details.
5. Select Register a New Client.
6. Next fill the form with necessary application information, including: Application
Name, Description, Website (it has to be an existing website with a http:// or
https:// prefix). OAuth redirect_url set as http://www.avid.com/SMH/index.html.
2. Setup
7. Select Register.
Your CLIENT ID and CLIENT SECRET appearers.
Authorization |
52
8. In Social Media Hub, create a new Profile, assign the ‘Instagram’ driver, press the
Authorize button, and enter the corresponding Client ID and Client Secret from
Instagram together with the User and Password.
For more information on creating profiles, see Authorization on page 47

9. From now on, it should be possible to receive messages from Instagram with the
authorized Media Hub profile.
Authorizing YouTube
Social Media Hub can post videos directly to YouTube.
2. Setup
To authorize Social Media Hub to post videos to YouTube:
1. If you already have a dedicated Google/YouTube account for posting videos, go
directly to step 5.
2. To create a Google account, go to Google website at http://www.google.com and
sign in.
3. If you already have a Youtube channel, skip to step 6.
4. To create a channel, go to the YouTube website at http://www.youtube.com and
select My Channel. A new Youtube channel will be automatically created.
5. If a YouTube application, which is going to be used by Social Media Hub already
exists, and has necessary credentials, go to step 5.
6. Create a Youtube application, following the instructions given by Google:
https://developers.google.com/youtube/registering_an_application
7. Go to Google Cloud console https://cloud.google.com/console and click on Create
an empty project.
Authorization | 53
8. Enter the necessary data in the New Project window and click on Create.
9. Enable the Youtube API for the project.

2. Setup
Authorization |
54
10.Click on the Credentials tab, press on Create credentials. In the following
window, select Server key to generate the key. Once the key is ready, click on
OAuth Client Id to generate the Client Key and Client Secret.
11.In Social Media Hub, create a new profile, assign the Youtube driver and press the
Authorize button. Enter all the necessary data and click on OK.
12.The window will change into Google permission request screen, select Accept. 2. Setup
13.In Social Media Hub, assign the profile you just authorized to a
publishYoutubeVideo event. In the Event Parameter section, give the video file
path, video title, a description, and select Test. The video is posted on YouTube.
Authorization | 55
Authorizing Twitter
Social Media Hub can receive messages from and send messages to Twitter.
To authorize SMH for posting and retrieving messages from Twitter:
1. If you already have a dedicated Twitter account for sending and receiving messages,
go directly to step 3.
2. To create a Twitter account, go to the Twitter website at http://twitter.com and sign
up.
3. If you have a mobile phone registered with the above Twitter account skip to step 5.
To add a mobile phone number to your account, log into your Twitter profile and
select Settings.
2. Setup
4. To create a Twitter application, go to http://apps.twitter.com and click Sign in.

Login with your Twitter credentials.
5. In the Twitter Apps section, click on Create New App.
6. Give the application details, and accept the Developer Agreement.
Authorization |
56
7. Once the application is created, go to the Permissions tab and set the required
access type:
8. Go to the API Keys tab to generate the API keys. For more information on
managing your Twitter applications go to:
https://dev.twitter.com/overview/documentation
9. In Social Media Hub, create a new profile, assign the Twitter driver to and click on
Authorize.
2. Setup
10.Press OK and authorize the application in Social Media Hub.
11.Assign the profile you authorized to the publishTwitterMessage event, enter the
text of the message to be posted and select TEST. The message is posted to Twitter.
Authorization | 57
3. Receiving and
Aggregating Messages
This chapter describes the workflow for collecting and assessing social media messages
from different sources and picking the relevant ones to use during broadcast.
In this section:
Overview of Receiving Messages on page 59
Creating Rules on page 60
Receiving Messages on page 62
Aggregating Messages on page 71
Overview of Receiving Messages
Social media is a dynamic way to get feedback from viewers, and to increase attention
and loyalty. But there's a huge amount of content that needs to be filtered and
reviewed. SMH provides an efficient way to moderate content generated on social
media. The front-end application connects to Twitter, Facebook, Instagram and other
sources to search, retrieve, review and filter data, and aggregate the filtered
information into a single database that can be queried by the applications. Maestro,
3DPlay, and Morpho controllers can use on-air data filtered by SMH and generate
graphics with the content. This workflow is illustrated below:
3. Receiving and Aggregating Messages

Here are the steps you will need to follow in order to achieve the above goal:
1. Create and activate a project.
For more information, see Projects on page 20.
2. Create profiles with appropriate social media drivers.
For more information, see Profiles on page 23.
3. Associate the newly created profiles with the correct project.
4. Create rules to asses and grade the incoming messages (optional).
For more information, see Creating Rules on page 60.
5. Associate the newly created rules with the new profiles (optional).
6. Activate the profiles you created.
7. Manually asses the relevant messages that where captured (Optional).
8. Create aggregations to hold the selected messages.
9. Populate the newly created aggregations with the selected messages. This step can
be performed automatically.
Overview of Receiving Messages | 59

Creating Rules
Searching for messages in social media can be like looking for needles in a haystack.
That’s why SMH features several tools to help find what you're looking for.
Automatically rate messages based on content. Create dictionaries with a predefined
score (positive or negative) for each keyword. The total rating (or assessment) of a
message is the addition of all keywords found in the message. Media associated to
messages—such as the user's avatar image, or associated images and clips—are
automatically downloaded and made available for later usage on the production
environment.
To create a new rule that will mark desired words in a post:
1. Go to View menu, and select Rules.
The Rules window opens.
2. In the Rules section select Add.

3. Double-click the NewRule to rename it, or press F2.
4. To add the Phrases ratings, select the newly created rule and in the Phrases
section, click on the Add button.
5. In the Phrase column, enter the words to be graded.
6. In the Burden column, add the amount of points that the message should receive if
that phrase is found. Negative values are also acceptable.
7. In the Variants column add synonyms or equivalent words separated by semicolon
(;) for the one in the Phrases column (Optional).
For more information on Rules, see Rules on page 38.
Creating Rules |
60
Exporting and Importing Phrases
You can import and export a list of phrases with the points they should be rewarded
from a CSV formated file. The CSV file has no titles, the format of the CSV is as
follows:
[points given];[phrase];[variant 1];[variant 2];[variant n]
Example:
100;election;elections
300;protesters;demonstrators;riots
Creating Rules | 61
Receiving Messages
To start capturing content from social media, a project needs to be created and
activated. Afterwards, the required social media profiles should be included within that
project. It is also recommended to create rules to filter the incoming messages, and
associate these rules with the social media profiles. After all these steps have been
performed, you are ready to receive social media content.
To view the messages from a particular social media services, make sure the profile is
activate and select it from the View.
NOTE:
SMH starts to capture messages from the social media profile as soon as it is
activated.
To open messages from a particular social media service:

■ Go to the View menu, click on the expandable Profiles list, and select the required
social media profile:
Receiving Messages |
62
The Messages View
The illustration below uses the Twitter profile as an example. In the Twitter Profile
settings, the SearchUserName parameter has been set to @Avid, to receive all
content related to the @Avid account on Twitter.

The individual options of the Profile Messages window are explained in the table below:
Filtering Options
Time Range Set the time frame to display the messages. Selecting Custom
and an end date . The start and end dates can be
selected from a pop-up calendar.
Author Filter Enter the name of the author to be used as a filter. It is also
Message Filter Filter the messages by message content. It is also possible to

select from a list of recent values.
Statuses
Receiving Messages | 63
Processing Filter the messages according to their processing status.
Messages, which are currently being processed can be hidden
from the view.
Processed Filter the messages according to their processed status.

Processed (aggregated) messages can be hidden from the view.
Aired Filter the messages according to their airing status. Aired

messages can be hidden from the view.
Assessment • Desired - display only the messages with the Desired status
• Neutral - display only the messages with neither Desired nor

Unwished status
• Unwished - display only the messages with the Unwished
status.
• From To - use it to display only the messages from within the
desired range.
Recalc All - use it to recalculate all assessment values within the
profile.
NOTE:
Assessment is calculated automatically only upon receiving
the message from the social media source. In order to
recalculate the message assessment (e.g. after changes in
the Rules), use this option.
Aggregate • Manual - enable manual aggregation.

• Auto - enable auto aggregation.
For more information, see Auto-Aggregation on page 68.
Update • Manual - click on the Update button, to manually capture

messages when the AutoUpdate option is disabled.
• Limit - limit the number of messages that will be captured
when the Update button is pressed.
• AutoUpdate - enable it to allow for automatic download of
new messages, that comply to the currently set filters, into
the messages window.
Likes Filter the messages by the number of likes.
64
Video Filter the messages according to their video status:
• Show videos - show messages with any videos.
• Hide videos - show messages without any videos.
• Show only downloadable - show messages with videos,
which have not yet been downloaded.
• Show only downloaded - show messages with videos, which
have already been downloaded.
For more information, see Video Options on page 69.
Ratings Filter the messages according to their set rating.

• [Alt+1] to [Alt+0] range - set filter to messages with ratings
equal or higher than specific value;
• [Alt+-] clear rating filter
• Rating Filtering Active - set the filter on or off

Defaults Select to revert the filters to default values.
Apply Select to apply the chosen filters to the listed messages
Show removed messages.
Messages List
Author The name and avatar of the author of the message.
Message The content of the received message along with images.
Status Displays the status of the received message:
• the message has been processed and sent for
aggregation;
• the message is currently being processed by a

moderator;
• the message has been removed;
• the messages has received the Desired status by the
set rules;
• the messages has received the Unwished status by

the set rules;
• the message has been aired by a controller;
• the message has been edited;

• Green background - the message has been included in an
aggregation.
Published The date and time on which given message has been posted.
Assessment Visual and numeral representation of the message assessment.
For more information, see Assessment of messages on page 67.
Rating Message rating assigned manually by a moderator. To set the

rating of the event, click on the star or between stars or use the
keys [0] to [9] when particular event is selected.
Likes The number of likes the message has received on its original
social media service.
The context menu (available after right-clicking on any message) gives the following
options:
• Edit - edit the content of the message.

• Images - toggle to display the images in the Message column.
• Message > Open Message in Webbrowser - open the message using a browser
on the source social media site.
Message > Create Profile with Answers - automatically create a new profile,
which will capture all comments added to the selected message. The newly created
profile needs to be activated manually.
Message > Update Number of Likes - update the number of likes for the
selected message
• Show Message History - toggle to Message History window, which will contain all
the changes, made by various users, that have been performed on the original
message, such as adding the message to an aggregation, editing the content or
reverting all edits.
• Video - download all supported videos or cancel the downloading process.
• Unedit - revert all changes made to a message.
• Wordfilter - process message with word filter; the unwished words (marked with
red color) will be replaced with the pattern defined in the Settings. Message can be
reverted to its original state by using the 'Unedit' option
• Update - update the selected message.
• Delete - delete the selected message.
• Select All - select all visible messages.
• Aggregate All Visible - aggregate all visible messages.
66
For an Administrator user, the Messages Options button gives a quick access to
further message editing possibilities:

Aggregation Assign the default aggregation for the selected profile.
Rules Select the Dictionary and Black/White List that should be

applied to the selected profile.
Likes Set the threshold values for the selected profile.
Assessment of messages
The message list columns includes the Assessments column, which represents the
assessments of each message in a visual way using a special gauge or scale.
Each message is automatically assessed by the rules set for the used social media
profile, or globally to the project. Rules include the Black/White Lists and Dictionaries.
The assessment is represented in two forms:
• A calculated assessment value at the bottom part, either positive or negative;
• A visual scale for quick review by the moderator.
The visual form is a rectangle colored scale. The scale changes its colors from side to
side, to conform with the thresholds assigned to the rules which assessed the
message.
• Dark gray area on the left indicates automatic removal of the message;
• Light red area on the left indicates the message is automatically tagged
unwished;
• Light green area on the right indicates the message is automatically tagged
desired;
• Light gray area in the middle indicates the message is automatically tagged
neutral.
The markers in the middle are proportional to the actual message assessment value:
• Green - represents actual positive assessment;
• Red - represents actual negative assessment.
To arrange the messages according to their assessment value, click on the column
header. Click it again to reverse the order.
Aggregation of messages
Auto-Aggregation
The Auto-aggregation mode makes it possible to automatically add received messages
by given profile to default aggregation(s), defined for the selected profile, or to a
project. The Auto-aggregation mode takes the current filter settings in the Profile
Messages Window into consideration.
NOTE:
This is a global setting, which means that once it is enabled, it is going to be active
even if all connected clients are closed.
Following filtering options are taken into consideration, when setting up the
auto-aggregation: Author, Message content, Assessment Min/Max (if enabled),
Number of Likes (if enabled) and Video filters (if enabled).
To enable the Auto-Aggregation mode:

1. Open the Profile view for the desired social media profile.
2. Define default aggregation(s) for the Profile (in case no default aggregation is
assigned to the Profile, default aggregation for the Project will be selected).
3. Define the set of filters to be used for the Auto-Aggregation.
4. Enable the Auto-Aggregation by clicking on the Aggregate button.
68
5. The button changes its text to Aggregate: Auto and its color to red. All filtering
options become disabled.
The default aggregations for the given profile will be remembered as defined in the
GUI client which enabled the Auto Aggregation mode. The Auto- Aggregation mode
will also be enabled for the specific profile in all connected GUI clients.
To disable the Auto-Aggregation mode:

■ Click on the Aggregate: Auto button to change it to manual aggregation.
Once the auto- aggregation has been disabled, you can change the filtering options,
if necessary. Then enable the auto-aggregation again.
Manual Aggregation
There are multiple ways to add a message to an aggregation. The SMH GUI has been
designed specifically with the ease of use in mind, and so offers multiple possibilities to

perform aggregations.
Option 1 - Drag and drop the message to the Aggregation View
Option 2 - Using the numeric keyboard

Press the + or = keys on a selected message to send it to default aggregations.
Option 3 - Aggregate All Visible Messages
Right-click on any message, and from the context menu select Aggregate All Visible
to send all messages to default aggregations.
Or
Press the * button anywhere in the Messages List view to aggregate all visible
messages.
Video Options
SMH supports download of videos for selected social media services: Facebook,
Twitter, and Flickr. Message with attached video receive an additional status property:
Video.
Unlike images, attached videos are downloaded upon user request.
The messages, which contain videos, can be assigned one of the following statuses:
• - the available (downloadable) status appears for messages which

contain video in a format, that can be downloaded.
• - the OK status appears for messages which contain video that has
already been downloaded.
• - the unsupported status appears for messages which contain video in

an unsupported format.
70
Aggregating Messages
Once interesting messages have been identified, they can be added to one
aggregation. This carousel of messages can be retrieved and sent on air by Avid’s
graphic controllers in any graphical manner desired (ticker, crawl, full frame tables, as
part of virtual studios or high-resolution video walls), depending on the look of the
station. It's possible to utilize multiple moderation stages, so several contributors can
shortlist messages for review and approval by the chief editor.
To open an aggregation:

■ Go to the View menu, click on the expandable Aggregations list, and select the
required aggregation:

The Aggregation View
Differences between the Messages and Aggregations View
The Aggregations View has no Update section, since aggregated messages are not
received automatically from an external source. All messages are updated in this view
immediately as they are added, removed or moved.
There is no Show Removed option. Even though a message is removed from an
aggregation, it still exist in the Profile Messages view.
There are no processed or processing filters, since all messages which are in an
aggregation must have already been processed.
The Aggregation View has an additional column: Source Profile. It informs about the
source social media service that posted the original message.
Aggregating Messages | 71
The context menu (available after right-clicking on any message) gives the following
options:
• Edit - edit the content of the message.

• Images - toggle to display the images in the Message column.
• Message > Open Message in Webbrowser - open the message using a browser
on the source social media site.

Message > Create Profile with Answers - automatically create a new profile,
which will capture all comments added to the selected message. The newly created
profile needs to be activated manually.
Message > Update Number of Likes - update the number of likes for the
selected message
• Show Message History - toggle to Message History window, which will contain all
the changes, made by various users, that have been performed on the original
message, such as adding the message to an aggregation, editing the content or
reverting all edits.
• Video - download all supported videos or cancel the downloading process.
• Unedit - revert all changes made to a message.
• Wordfilter - process message with word filter; the unwished words (marked with
red color) will be replaced with the pattern defined in the Settings. Message can be
reverted to its original state by using the 'Unedit' option
• Update - update the selected message.
• Delete - delete the selected message.
• Select All - select all visible messages.
For an Administrator user, the Aggregations Options button gives a quick access to
further message editing possibilities:
Aggregating Messages |
72
Profile Indicate which profile(s) use the selected aggregation as default
for their messages. To add an aggregation as the default profile,
check the corresponding box. To disassociate the aggregation
from its profile, disable the corresponding box.
Execute Event Allows the user to assign an event which will be executed when a
on Add Entry message will be added to an aggregation. To assign an event,
open the combo box and pick the desired event name.
Aggregating Messages | 73
4. Customizing
This section includes information on customizing Social Media Hub to suit your
preferences.
In this section:
Setting Preferences on page 75
SMH Keyboard Shortcuts on page 80
Setting Preferences
To set the application’s preferences, open the Settings window from the toolbar or the
View menu.
Service
Use the Service tab to control all parameters related to the SMH service. Here, you
can start or stop the SMH service, if it is configured to work on the same machine.
4. Customizing
Connect GUI to Service
Host The name or the IP number of the host where the service is
installed.
Port The number of the service port configured for the API
communication (usually 8377).
Connect GUI Proxy
Use Proxy Enable the proxy connection for the SMH Desktop GUI.
Server Set the Proxy server address.

NOTE:
The service proxy parameters are defined in
SMHService.ini. This file should only be changed by AVID
Personnel.
Port Enter the number of the port for the Proxy server.
User Type in the user name for the Proxy server.
Password Give to password to login to the Proxy server.
Setting Preferences | 75
Service Control
Start Service Start the SMH Service.

NOTE:
The Start / Stop options only work on the machine where
SMH Service instance is installed, and are active only
when the host is set to the 'localhost' value. In order to
Start/Stop the service under Windows7 and above, the
GUI has to be started in an elevated mode (as
Administrator) or the User Access Control option needs to
be disabled on the level of the operation system
Stop Service Stop the SMH Service.
Database
Use the Database tab to define the database communication parameters.
4. Customizing
Database
Host Set the database server name; the host name or IP address of
the computer on which the SQL database is installed.
Database The name of the Social Media Hub database (usually SMH).
Name
User Name Type in the user name for the SQL database server.
Password Give to password to login to the SQL database server.
Setting Preferences |
76
Aggregation
Use the Aggregation tab of to define various parameters of SMH Aggregations.
4. Customizing
Directories
Reference CyberGraphics reference directory.

Directory
Images The directory to which the service will store received images; this
Directory directory has to be accessible from the level of the running
service.
Client Images The directory that will be used to present images path on the
Directory side of a client (like Maestro, 3DPlay or Morpho).
Videos The directory, to which all videos will be downloaded. Videos

Directory from individual social media services will be downloaded to
separate folders named after the media in question.
Client Videos The directory that will be used to present videos path on the side
Directory of a client (like Maestro, 3DPlay or Morpho).
Messages
Limit number Set the limit number of Messages received by the Messages and
of messages Aggregation windows. This functionality avoids potential
performance problems when huge number of entries are received
by a particular window.
Maintenance
The Maintenance tab should only be used by authorized Avid personnel.
4. Customizing
Maintenance Mode
Enable Check this box to enable the Maintenance Mode.

Maintenance
Mode
Editor Define the default application used to edit event scripts.
Debugger Set the default application used to debug scripts.
Enable Enable the log type DEBUG and INTERNAL to be visible in a

Verbose Mode command line text output (when the service is started in this
for Text Log mode) and in a text log file.
Output
Setting Preferences |
78
Miscellaneous
In the Miscellaneous tab you can define various system parameters.
4. Customizing
MediaCentral ACS Gateway
Enabled Enable the Avid Common Services (ACS) Gateway connection.
Host Define the host name or IP address of the ACS gateway.
Translation
Language Change the SMH GUI language.
Avatar of Current User
Select Avatar Set the Avatar Image of the currently logged on user.
Image
Desired and Unwished Words
Highlight Enable the option to highlight desired and unwished words within
Desired and captured messages.
Unwished
Words
Wordfilter Set the filter which will be used instead of unwished words, as
established in the Rules section. For more information, see Rules
on page 38.
SMH Keyboard Shortcuts
Main Window
*Only available when given View is visible and within the docked layout.
[CTRL] +[1] Show/Hide Projects View.
[CTRL] + [2] Show/Hide Profiles View.
[CTRL] + [4] Show/Hide Events View.
[CTRL] + [5] Show/Hide Clients View.
[CTRL] + [6] Show/Hide Rules View.
[CTRL] + [8] Show/Hide Logs View.
[CTRL] + [9] Show/Hide Statuses View.
[CTRL] +[0] Show/Hide Notifications View.
[CTRL]+ [TAB] Show/Hide Undocked Windows.
[CTRL] + [/] Open GUI Settings Panel.
[ALT] + [F4] Close application.

4. Customizing
[ALT] + [V] Accelerator for View Menu.
[ALT] + [T] Accelerator for Tools Menu.
[ALT]+ [P] Accelerator for Help Menu.
[ALT] + [O] Focus to Projects View (not available in all contexts)*
[ALT]+ [E] Focus to Events View (as above).
[ALT]+ [C] Focus to Clients View (as above).
[ALT] + [I] Focus to Profiles View (as above).
[ALT] + [L] Focus to Rules View (as above).
[ALT] + [G] Focus to Logs View (as above).
[ALT] + [T] Focus to Event Statuses View (as above).
[ALT] + [N] Focus to Notifications View (as above).
Profile Messages / Aggregation View

*Only available when given View is visible and within the docked layout.
[+] (Num Pad) / [=] Add Message to Default Aggregation and go to next one.
[-] / [SPACE] Mark message as processed and go to next one.
[/] (Num Pad) / [?] Update messages (in manual update mode).
[1]-[0] Set the Rating; [9] - 5 stars; [0] - 0 stars
SMH Keyboard Shortcuts |

80
[DEL] In Profile Messages View - mark message as removed;
In Aggregation View - remove message from
aggregation.
[INS] In Aggregation View - add Moderator message to

Aggregation; not effective in Profile Messages View.
[F2] Start editing message.
[CTRL]+[ENTER] Start editing message or commit edit.
[ESC] (while editing) Do not commit edited message.
[Alt]+[W] Clear Processing Filter.
[Ctrl]+[W] Enable and set Processing Filter to ‘Hide Processing’.
[Ctrl]+[Shift]+[W] Enable and set Processing Filter to ‘Show Processing’.
[Alt]+[E] Clear Processed Filter.
[Ctrl]+[E] Enable and set Processed Filter to ‘Hide Processed’.
[Ctrl]+[Shift]+[E] Enable and set Processed Filter to ‘Show Processed’.
[Alt]+[R] Clear Aired Filter.
[Ctrl]+[R] Enable and set Aired Filter to ‘Hide Aired’.
4. Customizing
Ctrl]+[Shift]+[R] Enable and set Aired Filter to ‘Show Aired’.
[Alt]+[/] Focus to Messages View Area.
[Alt]+[H] Focus to Time Filter.
[Ctrl]+[U] Focus to Author Filter.
[Ctrl]+[Shift]+[U] Clear Author Filter.
[Ctrl]+[F] Focus to Message Filter.
[Ctrl]+[Shift]+[F] Clear Message Filter.
[Alt]+[0]/[9] Set Rating Filter to 0-5 stars.
[Ctrl]+[-] Reset Rating Filter.
[Alt]+[K] (Re)Apply current filter.
[Alt]+[J] Reset filters to default (except time filter).
[Ctrl]+[M] Show Removed Mode.
[Alt]+[A] Clear Assessment Filter.
[Alt]+[S] Set Assessment Filter to Desired range.
[Alt]+[D] Set Assessment Filter to Neutral.
[Alt]+[F] Set Assessment Filter to Unwished.
[Ctrl]+[S] Set Video Filter to Show Messages With Video.
Ctrl]+[Shift]+[G] Disable Video Filter for Messages.
[Ctrl]+[Shift]+[D] Set Video Filter to Show Messages Without Video.
SMH Keyboard Shortcuts | 81

[Ctrl]+[S] Set Video Filter to Show Messages With Downloadable
Videos.
[Ctrl]+[Shift]+[S] Set Video Filter to Show Messages With Downloaded

Videos.
[Ctrl]+[Shift]+[W] Apply Wordfilter.
Ctrl+[B] Download Video for Selected Messages.
Ctrl+[N] Cancel Downloading Video for Selected Messages.
Ctrl+[G] Enable/Disable auto aggregation.

4. Customizing
SMH Keyboard Shortcuts |

82
5. SMH in MediaCentral
|UX
In this section:
Integration with MediaCentral |UX on page 84
Social Media Hub Panes in MediaCentral |UX on page 85
Integration with the Assignments Pane in MediaCentral |UX on page 93
Integration with MediaCentral |UX
SMH is part of the full story-centric workflow, making it easy to engage with, inform,
and grow your audience, as well as bring their voices into your story. Using
MediaCentral | UX, which integrates directly with SMH, you can monitor, filter,
moderate, and prioritize incoming feeds from Facebook, Twitter, and other social
channels to see what people are saying and sharing. Then easily present the best posts
as graphic elements to display on air.
To configure the connection to the MediaCentral |UX ACS bus:

1. Go to View > Settings, and select the Misc tab.
5. SMH in MediaCentral |UX
2. In the MediaCentral ACS Gateway section, check the Enabled box, and enter the
host name or IP address of the MediaCentral |UX ACS bus.
3. Click on Apply.
4. In the Service tab, restart the SMH Service, and click OK.
MediaCentral |UX User Mapping in the SMH Desktop GUI

New column “User Mapping” has been added to the Users View. When the service is
connected to the MediaCentral |UX Platform, it is possible to map a MediaCentral |UX
user to an existing Social Media Hub user. When the mapped MediaCentral |UX user
performs any operation on a message (such as editing), the log and the history of
message will inform about these changes.
The list of MediaCentral |UX users is updated upon the startup of the SMH service. This
list can also be manually updated.
To update the list of MediaCentral |UX users:

■ Go to Tools and select Update MCUX Users.
Integration with MediaCentral |UX |

84
Social Media Hub Panes in MediaCentral |UX
Once the ACS Gateway connection has been enabled, and the MediaHub UX
component is installed on the MediaCentral |UX server, you can start using the Social
Media Hub Panes within MediaCentral |UX.
SocialMedia Projects Pane

The Projects configuration pane allows to edit, add and remove existing Projects. A
Project is a definition of used Message Profiles, Aggregations, Rules and relations
between these elements. It can be used for the configuration of the Project workflow.
NOTE:
A Project only contains Profiles and Aggregations, while Events are global for all
projects, and are working in configurations where the GUI is not connected to Core
application.
The Projects configuration pane allows to configure a basic set of parameters for a

specific project. More advanced options are only available in the Desktop GUI.
Add Select to add a new project.
Remove Select to remove a project.
Clone Select to clone the selected project. The cloned project will be
created using the original project name and the suffix _1 ,_2
etc.
Purge
Click to permanently delete all previously removed projects from
the system.
Restore
Click to restore a selected project to the active projects list.
Quick Filter Enter the project name that you want to search for, or choose a
of characters.
Enable Show Removed view. Activates the Purge and Restore

buttons.
Activate Activate the selected project. Current project information is

visible over Quick Filter option.
Projects List
Social Media Hub Panes in MediaCentral |UX | 85

Name Name of a project. Project names must be unique. To change the
name of a project, select it and type a new name
Locked When enabled, the project cannot be removed.
Created The date and time the project was created.
Modified The date and time the project was last modified.
SocialMedia Profiles Pane

The Profile configuration pane allows to configure a set of specific parameters for a
selected profile. Profiles provide means for sending and receiving data from social
media services. Complete configuration of profiles is only available in the Desktop GUI.
The Profiles Pane in MediaCentral |UX allows to change selected profile parameters (as
described below).
Remove Select to remove a profile.
Clone Select to clone the selected profile. The cloned profile will be
created using the original profile name and the suffix _1 ,_2 etc.
Purge
Click to permanently delete all previously removed profiles from
the system.
Restore
Click to restore a selected project to the active profiles list.
of characters.
Enable the Show Removed view. Activates the Purge and Restore
buttons.
Profiles List
Name Name of a profile. Profile names must be unique. To change the

name of a profile, select it and type a new name.
Social Media Hub Panes in MediaCentral |UX |

86
Driver Name of the selected driver for a specific profile. This value
cannot be changed within MediaCentral |UX, only in the SMH
Desktop GUI.
Locked When enabled, the profile cannot be removed.
Input Active Enable it so that the selected profile can receive messages; to
disable it, click on this column again; this option is disabled by
default.
NOTE:
When a profile is defined as In Active for the first time, it
starts receiving messages according to the defined
query. Then, it remembers the current state of the
received data settings.Afterwards, only new updated
messages will be received. If a new query is going to be
used for the selected social media profile- another
profile needs to be created (the easiest way to achieve
this, is to clone the original profile, adjust the query settings,
and enable the In Active option in the cloned profile).
Output Active Enable it so that the selected profile can publish messages; to

disable it, click on this column again; this option is enabled by
default.
Created The date and time the profile was created.
Modified The date and time the profile was last modified.
Schedule Enable this setting to activate scheduling of events.
Days of the Define on which days of the week, the selected profiles are active
week for processing events (publishing messages to social media
services).
SocialMedia Aggregations Pane

Aggregations show messages which have been processed. These messages are
available to be used in Control Systems, such as Maestro, 3DPlay or Morpho.
The Aggregations pane allows to edit, add and remove existing Aggregations. New
aggregations are automatically added to the currently active Project.
Remove Select to remove a profile.
Clone Select to clone the selected profile. The cloned profile will be
created using the original profile name and the suffix _1 ,_2 etc.

Purge
Click to permanently delete all previously removed aggregations
from the system.
Restore
Click to restore a selected project to the active profiles list.
Quick Filter Enter the aggregation name that you want to search for, or
choose a recent search from the drop-down box.
of characters.
buttons.
Aggregations List
Name Name of an aggregation. Aggregation names must be unique. To

change the name of an aggregation, select it and type a new
name.
Lock The date and time the aggregation was created.
Modified The date and time the aggregation was last modified.
Accessed The date and time the aggregation was last accessed.
Created The date and time the aggregation was created.
SocialMedia Messages Pane

The SocialMedia Messages Pane shows messages received from a selected profile or
messages added to an aggregation. By default, the number of messages visible in the
Aggregation Messages View is limited to 500. This setting can be changed in the SMH
Desktop GUI.

88
Profile/ Switch between social media profiles and aggregations active
Aggregation within the current project.
Selector
Update Update the content for a specific profile or aggregation. Apply all
the filters.
Aggregate Add selected messages to default aggregations. Alternatively,

Message messages can be added to any visible aggregation by using the
drag and drop operation.
Auto- Enable Auto-Aggregation. Once this option is switched on, the

Aggregation button’s color changes to yellow. The mechanism behind the

(Profile View auto- aggregation mode works in the same way as for the SMH
only) Desktop GUI. For more information, see Auto-Aggregation on
page 68.
Reset Filter Revert all filters to the default status.
Select Visible In order to save space of the Media Central |UX interface, it is
Columns possible to define which columns of Media Hub Messages Pane
are visible.
buttons.
Shortcuts Help Display the list of available keyboard shortcuts.
Filtering Options

Time Range Set the time frame to display the messages. Selecting Custom
and an end date .
The start and end dates can be added manually.
Author Filter Enter the name of the author to be used as a filter. It is also
Message Filter Filter the messages by message content. It is also possible to

select from a list of recent values.
Status • Hide processing - show or hide messages with the

Processing status. These are the messages which have been
updated for processing by one of moderators.
• Hide processed - show or hide messages with the Processed
status. These are the messages which have been already

processed by adding them to an Aggregation or ignoring such
message.
Likes Filter the messages by the number of likes.
Aired Filter the messages according to their airing status. Aired

messages can be hidden from the view.
Assessment • Desired - show only messages with Assessment equal or

higher than Desired Threshold.
• Neutral - show only messages with Assessment between
Desired and Unwished Threshold
• Unwished - show only messages with Assessment equal or
lower than Unwished Threshold.
Ratings Filter the messages according to their set rating.

• Set filter to messages with ratings equal or higher than
specific value.
Video Filter the messages according to their video status:

• Show videos - show messages with any videos.
• Hide videos - show messages without any videos.
• Show only downloadable - show messages with videos,
which have not yet been downloaded.
• Show only downloaded - show messages with videos, which
have already been downloaded.
For more information, see Video Options on page 69.
Messages List
Author The name and avatar of the author of the message.

90
Message The content of the received message along with images.
Double-click on the message to edit it.
Status Displays the status of the received message:

• Processed- the message has been already processed; when
not added to Aggregation, the background remains gray, when
added to any aggregation background changes to green.;
• Processing -the message is currently being processed by
other moderator;
• Remove - remove the selected message.
• Aired - the message has been aired by a controller;
• Edited - the message has been edited; Press the Edited
button once again, to revert all changes.
Published The date and time on which given message has been posted.
A Visual representation of the message assessment.

(Assessment) • Green - desired

• Gray - neutral
• Red- unwished
For more information, see Assessment of messages on page 67.
Rating Message rating assigned manually by a moderator. To set the

rating of a message, click on the star or between stars.
Likes The number of likes the message has received on its original
social media service.
To sort messages in the SocialMedia Messages Pane:

■ Click on the column to be used to sort the messages. Click again to change order of
sorting to the opposite one.
To change the size of the columns, position the mouse pointer mouse over the column
separators in the Header of the table view. Press the left mouse button, and while
pressed, move the mouse left or right to adjust the size of the column. Then new
column size will be updated, when the left mouse button is released.
To add a message to an Aggregation:

1. Select the messages which are going to be added to an aggregation.
2. Drag and drop the selected Messages into the chosen Aggregation.
3. The bold line in target Aggregation View shows the place between which messages
the new item will be inserted (only when the target Aggregation is sorted by the
Message column, otherwise the new item will be added at the end of list).

4. When a given message will be added to any aggregation, the ‘Processed’ status will
be added.
To remove a message:

1. Select the messages which are going to be added to an aggregation, either with
your mouse or your keyboard.
2. Press the Remove Message button in the Status column.
The Messages are not completely removed from the database; they are just marked
as removed. It’s possible to see them again, when the Show Removed option is
enabled.

92
Integration with the Assignments Pane in MediaCentral |UX
Social Media Messages can be added to the Assignments Pane in the MediaCentral |UX
Platform.
To add social media messages to the Assignments Pane:

1. Open the Assignments Pane, or make sure it is visible together with the
SocialMedia Messages Pane.
2. Add Assignments using the top-right [+] button:

3. Drag and drop the message from the SocialMedia Messages Pane into the bottom
part of the Assignments Pane:
Integration with the Assignments Pane in MediaCentral |UX | 93

6. Integration with Avid
Control Systems
This chapter describes the integration between Social Media Hub and Avid Control
Systems: Maestro, 3DPlay, and Morpho.
In this section
Connecting the Control Systems to the SMH database on page 95
Publishing content from Control Systems to Social Media on page 101
Connecting the Control Systems to the SMH database
Integration with Maestro
Social Media Hub utilizes the SQL Database. The whole content retrieved from the
social media services is stored inside the database. Avid controllers, such as Maestro,
3DPlay or Morpho, can connect to this database and use this data as a part of their
broadcast graphics.
SMH can be added as a data source in Maestro.
To add an SMH data source:

1. In Maestro, open the Data Sources window, right-click on the SMH data source, and
select Add data source.
6. Integration with Avid Control Systems

2. In the Data Source window, select SocialMediaHub as the Factory name and
Type. In the SMH host section, add the name or IP address of the machine, where
the SMH Server is installed. In the Data source name, type in a name for the
newly created connection.
3. Click on the Test connection button to check that the connection is working, and
press Ok.
Connecting the Control Systems to the SMH database | 95

To query the SMH database in Maestro:
1. Select the SMH data source and in the Query Editor enter the required query text:
2. The results of the query are presented in the Query Result window.
Integration with 3DPlay

To retrieve SMH data from 3DPlay, a connection to the SMH database needs to be
established.
To set up a connection to the SMH database:

1. In 3DPlay, go to Devices > Data Source Manager and click on Add to create a
new connection.
Connecting the Control Systems to the SMH database |

96
2. Set the name of the connection (e. g. SMH) and select MSSQL as the source type.

3. Enter the same details for the MSSQL database as used for Social Media Hub.
4. Click OK.
5. Once the connection is created, click on Connect to activate it and on Test to test
it.
Now that the connection between SMH and 3DPlay is up and running, you can send an
example query to test whether it is functioning correctly.
To query the SMH database in 3DPlay:
1. Create a New Action, right-click on it, and select the Edit button.
2. In the Action Editor window, select the Data tab, and enable the Use Query
option.
3. Select the SMH connection that has been created previously, and add the query
text.
4. Click on Execute Query. The results will be displayed in the Query Results window.

Integration with Morpho
In order to integrate Social Media Hub with Morpho, an ODBC SQL driver is required.
SMH Database connection to ODBC
To set up an ODBC connection:

1. Open the ODBC Data Source Administrator tool and add the SQL Server driver.
2. Define the data source name and connect it to the SQL server.
3. Add the Login ID and Password of the SQL instance.

98
4. Enable the Change the default database to option and select the SMH DB that
you want to connect to.
5. Click the Finish button.

6. Once the ODBC data source is created and connected to the SMH DB, connect the
Morpho controller to the database.

Morpho connection to ODBC
To connect to the ODBC in Morpho:

■ In the Morpho Data Sources tab, connect to the SMH ODBC data source that was
created and select the relevant columns.

100
Publishing content from Control Systems to Social Media
Using SMH with Maestro to post to social media services
It is possible to publish broadcast content from Maestro directly to social media
services. It is achieved with the help of SMH events, which are also available in
Maestro.
In order to make use of the SMH event, Social Media Hub needs to be added as an
external device in the Maestro controller.
To add Social Media Hub as an external device in Maestro:

1. In Maestro, go to Customize > Settings, and select the External devices tab.
2. Click on the button to add a new device.

3. In the Name column, change the name to SMH. In the Type column, select SMH
Device.
4. Click on the Configure button, and enter the Host address and Port number of the
SMH server.
5. Press the Ok button.
6. The SMH status icon appears in the Maestro window.
After adding the SMH device to Maestro, use special events on the Timeline to send
commands to SMH.
Publishing content from Control Systems to Social Media | 101

To publish to social media services using SMH events in Maestro:
■ Drag the SMH Device from the Events list to your timeline. In the Event property
section, select the required SMH event. In the Value column, enter the desired text,
and give the path to an image, if required.
The following SMH events are available to be used in Maestro:

Using SMH with Morpho 3.0 to send messages to social media

Version 3.0 of the Morpho controller uses entry level integration with SMH based on
scripting capabilities. Before using this feature in Morpho 3.0, make sure the scripting
license works correctly.
On the bottom side of the Page editor, define the script which will be launched when a
given page is supposed to show.
To post message to social media using SMH, when a page is showing
On-Air:
1. Define the Execute Script parameter as On Show Page.
2. Use the mediaHubEvent.js script. Use the script from the Morpho directory - not
the script with the same name from the Social Media Hub.
3. In the script parameters area on the right side, the first parameter should be the
name of the event to be executed, and all next parameters will be used as
arguments.
In this example we are using:

publishFacebookMessage %FBMessage% %FBImage%
where
publishFacebookMessage - is a name of the event as defined in SMH.
%FBMessage% - Is the first argument of the above event, which will be taken
from FBMessage Morpho story variable (as defined in Morpho Variables editor).
Publishing content from Control Systems to Social Media |

102
%FBImage% - Is second argument of publishFacebookMessage, which will be
taken from FBImage Morpho story variable (as defined in Morpho Variables editor).
To use static text as argument in the mediaHubEvent script use quotation marks for
example:
publishFacebookMessage "First argument" "Second Argument"
It's also possible to send SMH events in other Page contexts as depicted below:

Using SMH from Command Line (SMHProcess.exe)
To start an event using the Command Line:

■ Use the following command (in the MediaHub directory):
SMHProcess.exe -s mediaHubEvent.js NAME_OF_THE_EVENT
"First argument" "Second argument" etc.
Examples:
SMHProcess.exe -s mediaHubEvent.js publishFacebookMessage "Text message from
Command Line"
SMHProcess.exe -s mediaHubEvent.js publishFacebookMessage "Text message from
Command Line with Image" C:\Data\Textures\Auckland.png
The mediaHubevent.js script is configured to connect to the service on the localhost.
To change it - edit mediaHubEvent.js file and replace all localhost references to the
desired name or IP number.
NOTE:
To publish content from 3DPlay or previous versions of Maestro (6.X to 6.8) to
social media services, use the Command Line.
Publishing content from Control Systems to Social Media | 103

A
activate 20
active
in 25, 33
out 25, 33
admin view 15
administrator 7
aggregation
profile 22
rename 23
authorizing
Facebook 48
Flickr 51
Instagram 52
other social media services 57
Twitter 56
YouTube 53
avatar
folder 26
black/white list 23
change project 20
client application 7
configuration
client and server 13
client only 13
control applications 8
database 7
default images folder 26
default layout 17
delete
profile 25, 33
deleted users 38
dictionary 23
directory 7
docked vs. undocked 18
driver 25
Facebook
authorizing 48
Flickr
104
authorizing 51
key 51
location search 28, 95, 96, 97, 98, 100, 101, 102, 103
secret 51
folder 7
geographic search 31
hide / unhide windows 18, 19
IMAP 26
in active 25, 33
Instagram 29
authorizing 52
language search 31
layout 15
default 17
layout default 17
license 7
location search 31
log in 20
log off 14
login 13
MassRelevance / Spredfast 30
never.no 29
new
project 21
out active 25, 33
105
P
password 13
profile 24
aggregations 22
assign 25
clone 25, 33
driver 25
in projects window 22
include 22
lock 25, 33, 34, 37, 43, 44, 45, 46
new 24
rename 25, 33
project
add 21
black/white list 23
create 21
dictionary 23
new 21
purge 21, 22
rename 21, 38
restore 21, 22
rules 23
purge 25, 33
quit see log off 14
receiving messages 59
rules 60
schedule 25
server 7
shared
directories 7
folders 7
Spredfast / MassRelevance 30
start 13
service 13
toolbar 15
relocate 17
Twitter
authorizing 56
106
U
user 39
deleted 38
password 40
users 7
view tab 15
windows
combine or superimpose 18
workfloaw 59
YouTube 31
authorizing 53
107

Social Media Hub User Guide 3.0

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Social Media Hub User Guide 3.0

Uploaded by

Copyright:

Available Formats

SMH Social Media Hub

User Guide December 2016

December 14, 2016

SMH in MediaCentral |UX ..................................................83

Integration with Avid Control Systems .............................94

What is Avid Social Media Hub? |

SMH Client Application

Features introduced in the SMH 2.1 release

Features introduced in the SMH 2.2 release

Features introduced in the SMH 2.3 release

New Features in Social Media Hub 3.0 | 9

Features introduced in the SMH 3.0 release

New Features in Social Media Hub 3.0 |

Conventions Used in This Document | 11

Client Application Overview on page 15

Social Media Hub Views on page 20

To Start SMH:

1. Double-click the Media Hub shortcut on the desktop.

To log off the system:

Projects Open the Projects window.For Also available from the

Profiles Open the Profiles window.For Also available from the

Profiles► Open one of the predefined

Client Application Overview | 15

Events Open one of the previously

Events Open the Events window. Also available from the

Clients Open the Clients window Also available from the

Rules Open the Rules window.For Also available from the

Users Open the Users window. Also available from the

Logs Open the Logs window. Also available from the

Statuses Open the Event Statuses Also available from the

Notifies Open the Notifies window.For Also available from the

Show/Hide Show or hide undocked Keyboard shortcut:

Client Application Overview |

Settings Open the system Settings Also available from the

Quit Log out and close the Keyboard shortcut: ALT+F4.

To relocate the toolbar:

To move the toolbar to its default position:

Arranging the windows \ views

Client Application Overview | 17

To superimpose one window over another (combine):

To undock a window:

To dock a window:

To move a window without docking it:

Client Application Overview |

The Show Removed option:

• To activate this option, select the Show Removed button.

Client Application Overview | 19

To activate a different project (i.e. change between projects):

Social Media Hub Views |

To create a new project:

Clear the filter.

Show the removed projects list.

Lock Enable this checkbox to prevent a specific project from being

Created The date and time the project was created.

Add Select to add a new project.

Remove Select to remove a selected project. Removed projects are

Activate Select to make a selected project current project.

Social Media Hub Views | 21

Clear the filter.

Select to show only included profiles

Name Profiles names.To rename, double-click and select Rename.

An aggregation is a collection of filtered and assessed messages.

Clear the filter.

Select to show only included aggregations.