Skip to content

This Magic Mirror module shows the follower count of a twitter user or youtube account.

License

Notifications You must be signed in to change notification settings

ngnijland/MMM-social-counter

Repository files navigation

MMM-social-counter

This MagicMirror module is a twitter follower counter.

Screenshot of module

Installation

  1. Go to the MagicMirror modules folder
cd ~/MagicMirror/modules
  1. Clone this repository
git clone https://github.com/ngnijland/MMM-social-counter.git
  1. Add this module to the modules array in the MagicMirror config/config.js file, like this:
modules: [
  {
    module: "MMM-social-counter",
    position: "middle_center"
  }
]

Twitter

To show the follower count of a Twitter user you need an app in the Twitter Developer Portal.

  1. Go to: https://developer.twitter.com/

  2. Log into your Twitter account

  3. Go to the apps overview in the Developer Portal (https://developer.twitter.com/en/portal/projects-and-apps)

  4. Create a new app

  5. Add the API key and API key secret to the config of this module as follows:

modules: [
  {
    module: "MMM-social-counter",
    position: "middle_center",
    config: {
      twitter: {
        apiKey: '<YOUR API KEY>',
        apiKeySecret: '<YOUR API KEY SECRET>',
        username: '<TWITTER USERNAME TO SHOW FOLLOWER COUNT OF>'
      }
    }
  }
]

Configuration

Configure this module in your MagicMirror config file which is located at config/config.js in the MagicMirror repository. An example config for this module:

modules: [
  {
    module: "MMM-social-counter",
    position: "middle_center",
    config: {
      // Options
    }
  }
]

The following configurations are available:

Config Type Default value Description
size small | medium | large medium The size of the counter
icon string fa-twitter The name of the font (from FontAwesome) to use as the icon next to the follower count, e.g. fa-twitter-square
updatesEvery number 10 The number of seconds between each follower count update

About

This Magic Mirror module shows the follower count of a twitter user or youtube account.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project