A module for the Magic Mirror to display trending topics for a given place or city.
Switch branches/tags
Nothing to show
Clone or download
AdamMoses-GitHub Update node_helper.js
fixed debug showing for no reason
Latest commit cab81c7 Aug 21, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images Initial commit Jan 17, 2017
.gitignore Initial commit Jan 17, 2017
LICENSE Initial commit Jan 17, 2017
MMM-TwitterTrendsByPlace.js Initial commit Jan 17, 2017
README.md Fixed examples Jan 17, 2017
node_helper.js Update node_helper.js Aug 21, 2018
woeid_short_list.md Add files via upload Jan 17, 2017

README.md

Module: Twitter Trends By Place

The MMM-TwitterTrendsByPlace module is a module design to display the trending topics from Twitter based on a given locale. The trends are automatically sorted by the volume of tweets for that trending topic and then displayed in that order, optionally along with their rank and their tweet volume shown.

Example:

Full

Dependencies / Requirements

This module requires the use of the twitter package for node.js. To install this please run npm install twitter from the root directory of your Magic Mirror installation.

This module also requires Twitter access tokens and keys. For more information on acquiring these please visit https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

You will need to set a WOEID value for the place (likely a city) to gather the trending topics for. WOEID values, aka "Where On Earth ID" values, are maintained by Yahoo! and can be searched for at http://woeid.rosselliot.co.nz/lookup/.

NOTE: That while WOEID's exist for nearly every city or place on Earth, trending topics are only available for the very largest cities or places. If you discover an error when running this module change the WOEID to an appropriate very large city and try again.

To see a short, but not at all comprehensive, list of cities and their WOEID's please check the woeid_short_list.md file included in this repository.

Using the module

To use this module, add it to the modules array in the config/config.js file:

modules: [
	{
		module: 'MMM-TwitterTrendsByPlace',
		position: 'bottom_left',
		config: {
		// visit the url below for the twitter keys/tokens
		// https://dev.twitter.com/oauth/overview/application-owner-access-tokens
			consumer_key: 'FILL IN',
			consumer_secret: 'FILL IN',
			access_token_key: 'FILL IN',
			access_token_secret: 'FILL IN',
		// set the display name/title for the place		
			placeName: 'New York, NY',
		// set the woeid for the place, see documentation for more
		// http://woeid.rosselliot.co.nz/lookup/
			placeWoeid: '2459115',
		}
	}	
]

Configuration options

The following properties can be configured:

Option Description
consumer_key Used by the Twitter package in order to collect the trends. For more visit https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

This value is REQUIRED
consumer_secret Used by the Twitter package in order to collect the trends. For more visit https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

This value is REQUIRED
access_token_key Used by the Twitter package in order to collect the trends. For more visit https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

This value is REQUIRED
access_token_secret Used by the Twitter package in order to collect the trends. For more visit https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

This value is REQUIRED
placeName The name/title of the location for which the Twitter trending topics will be gathered for. This should match the place set by the placeWoeid value. However, it can be set to any string and allows the user to decide based on their display preference, i.e. could be "New York", "NYC", "New York, New York", "The Big Apple", etc.

Example: New York, NY
This value is REQUIRED
placeWoeid The "Where On Earth ID"/WOEID value for the city or place you are trying to gather trending topics for. These can be searched for at http://woeid.rosselliot.co.nz/lookup/. NOTE: Trending Topics are only available for the largest cities or places, if the WOEID you use does not work pick another large city or place and try again.

Example: 2459115
This value is REQUIRED
numberOfTrendsToShow The number of trending topics to list. If set to 0 it will show all the trending topics for the place that have any tweet volume information available. Do note that the number of trending topics provided by Twitter is not fixed and can be many or just a few.

Example: 6
Default value: 10
This value is OPTIONAL
showTweetVolume Enable this to show the tweet volume for a particular trending topic, i.e. "1.31m", "378k", "13k", etc.

Example: false
Default value: true
This value is OPTIONAL
showTrendRank Enable this to show the rank of the trend, effectively the order after being sorted by the tweet volume, i.e. "1", "2", "3", etc.

Example: false
Default value: true
This value is OPTIONAL
refreshRate Specified in MINUTES, set the speed at which the trending topics are updated. Note that if a value less than 15 is specified it will be set to 15; this is to prevent any possible over-polling of Twitter. Also, the trending topics are no updated nearly as often as a typical Twitter home timeline is.

Example: 45
Default value: 20
This value is OPTIONAL
fade Enables the fade effect as seen visibly moving down the trending topics. This is the identical effect as seen in the weather forecast default module.

Example: true
Default value: false
This value is OPTIONAL
fadePoint The decimal percentage of where in the list of trending topics to begin the fade effect. This is identical to the effect seen in the weather forecast default module.

Example: 0.25
Default value: 0.5
This value is OPTIONAL