Skip to content
Windows SDK for the Microsoft Emotion API, part of Cognitive Services
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Cognitive-Common-Windows @ 10b0875 Remove obsolete disclaimer Mar 20, 2018
Sample-WPF Update Emotion API to .NET core standard 1.1 (Breaking change) (#27) Dec 5, 2017
SampleScreenshots moved Emotion windows projects into new repo Jun 13, 2016
.gitignore moved Emotion windows projects into new repo Jun 13, 2016
.gitmodules change submodule to use https Jul 7, 2016 contibution readmes Jun 22, 2016 contibution readmes Jun 22, 2016 Add SDK link Jul 6, 2016
ThirdPartyNotices.txt Third party notices Jul 6, 2016

Microsoft Emotion API: Windows Client Library & Sample

This repo contains the Windows client library & sample for the Microsoft Emotion API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.

The Client Library

This client library is a thin C# client wrapper for the Microsoft Emotion API.

The easiest way to use this client library is to get microsoft.projectoxford.emotion package from nuget. Please go to Emotion API Package in nuget for more details.

Order expressions

You can call the function ToRankedList from the Scores class, for example:

IEnumerable<KeyValuePair<string, float>> collection = myScores.ToRankedList();

The Sample

This sample is a Windows WPF application to demonstrate the use of Microsoft Cognitive Services Emotion API. It demonstrates emotion API by specifying a URL or using a stream.

Build the sample

  1. Starting in the folder where you clone the repository (this folder)
  2. In a git command line tool, type git submodule init (or do this through a UI)
  3. Pull in the shared Windows code by calling git submodule update
  4. Start Microsoft Visual Studio 2015 and select File > Open > Project/Solution.
  5. Go to Sample-WPF Folder.
  6. Double-click the Visual Studio 2015 Solution (.sln) file EmotionAPI-WPF-Samples.
  7. Press Ctrl+Shift+B, or select Build > Build Solution.

Run the sample

After the build is complete, press F5 to run the sample.

First, you must obtain a Emotion API subscription key by following the instructions on our website.

Locate the text edit box saying "Paste your subscription key here to start" on the top right corner. Paste your subscription key. You can choose to persist your subscription key in your machine by clicking "Save Key" button. When you want to delete the subscription key from the machine, click "Delete Key" to remove it from your machine.

Click on "Select Scenario" to use samples of different scenarios, and follow the instructions on screen.

Microsoft will receive the images you upload and may use them to improve Emotion API and related services. By submitting an image, you confirm you have consent from everyone in it.


We welcome contributions. Feel free to file issues and pull requests on the repo and we'll address them as we can. Learn more about how you can help on our Contribution Rules & Guidelines.

You can reach out to us anytime with questions and suggestions using our communities below:

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.


All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see LICENSE.

Sample images are licensed separately, please refer to LICENSE-IMAGE.

Developer Code of Conduct

Developers using Cognitive Services, including this client library & sample, are expected to follow the “Developer Code of Conduct for Microsoft Cognitive Services”, found at

You can’t perform that action at this time.