Skip to content

NateDee/MMM-fitbit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

65 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MMM-fitbit

MagicMirror Module for getting fitbit data. First time users follow setup instructions, if your tokens get lost run setupAccess.py again without arguments and accept reading from credentials.ini.

Dependencies

Setup

  • As with all modules, use git clone <this url> in the modules directory to download the module
  • Goto fitbit to register a new app (sign in with your fitbit account)
    • Give your app a catchy name and description
    • Your personal website, organisation, and organisation website can be whatever you like
    • Check browser and personal for OAuth settings
    • Callback URL MUST BE http://127.0.0.1:8080/
    • Give your app read & write permissions (read-only untested)
    • Note your:
      • "OAuth 2.0 Client ID" --- (client_id)
      • "Client (Consumer) Secret" --- (client_secret)
    • (You can access these again later via manage my apps at the same link as above)
  • Navigate to MMM-fitbit in the modules directory
  • Install dependancies using the listed commands
  • Navigate to the python directory in MMM-fitbit
  • Create blank files tokens.ini and credentials.ini or duplicate their .sample files
  • Via the command line on your Pi (NOT via SSH), run sudo python setupAccess.py. You must either:
    • Pass it your client_id and client_secret as arguments
    • Run it without arguments and have it read from credentials.ini (you can use this if you have already setup the module but need a fresh set of tokens)
    • Run it without arguments and enter your client_id and client_secret when prompted
  • Login using your fitbit credentials (if you are not already) and allow access to all options (if you do not some features may not work, but you may revoke app access and rerun sudo python setupAccess.py to change these)
  • Add the example config to your config (entering relavent credentials)
  • Start your MagicMirror!

Config

Example config

{
	module: 'MMM-fitbit',
	position: 'top_center',
	config: [
		credentials: {
			client_id: <client_id>,
			client_secret: <client_secret>,
		},
		resources: [
			'steps',
			'floors',
			'caloriesOut',
			'distance',
			'activeMinutes',
			'sleep',
			'heart'
		],
		update_interval: 60
	]
},

Explanation

  • (Required) credentials:
  • (Required) resources: List of resources to display on Mirror. May take any combination of 'steps', 'floors', 'caloriesOut', 'distance', 'activeMinutes', 'sleep', 'heart'
  • (Optional) update_interval - (default value of 60): in the amount of time in minutes to wait before fetching new fitbit data. This must not be done too often otherwise fitbit will not send new tokens and an uncaught exception will be thrown. This happens after approximately 150 requests in an hour, so updates should be no more frequent than once every minute for safety.

TODO

See here.

About

MagicMirror Module for fitbit

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 89.3%
  • JavaScript 10.2%
  • CSS 0.5%