INSTALL.md

Install MMM-GoogleDocs-Notes

This guide will walk you through the installation process of MMM-GoogleDocs-Notes.

We will

1. Create a Google Cloud Project and configure OAuth to access your Google Drive

2. Authorize MMM-GoogleDocs-Notes via cli

3. Setup the Google Docs Page

4. Check the result

Prerequisite:

1. Downloaded the MMM-GoogleDocs-Notes module from GitHub to your Magic Mirror modules directory

2. nodejs installed

3. you can open a cli (cmd, bash, shell or whatever you are running)

4. you have a google account

Creation Date: September 9, 2023

---

# Open Google Cloud Console

1. Click on NEW PROJECT

2. Click on Project name

3. Click on CREATE

4. Click on SELECT PROJECT

5. Click on APIs & Services

6. Click on ENABLE APIS AND SERVICES

7. Click on Google Drive API…

8. Click on ENABLE

9. Click on OAuth consent screen

10. Select External

11. Click on CREATE

12. Type e.g. "Magic Mirror Project"

13. Click on "youremail@gmail.com"

14. Type "youremail@gmail.com"

15. Click on SAVE AND CONTINUE

16. Click on SAVE AND CONTINUE

17. Click on ADD USERS

18. Type "youremail@gmail.com"

19. Click on ADD

20. Click on SAVE AND CONTINUE

21. Click on Credentials

22. Click on CREATE CREDENTIALS

23. Click on OAuth client ID…

24. Click on Application type

25. Click on TVs and Limited Input devices

26. Type e.g. "Magic Mirror"

27. Click on CREATE

28. Click on DOWNLOAD JSON

29. Save the file to the MMM-GoogleDocs-Notes directory

30. Rename the client_secret_.json to client_secret.json

31. Authorize via cli

In the MMM-GoogleDocs-Notes directory open a cmd/shell and execute

1. node authorize.mjs

2. or if you run MM on a raspberry pi sudo -u pi -- node authorize.mjs (Change pi to the user that runs the Magic Mirror application).

Follow the instructions to authorize the Google account for which you want to display notes on your mirror. It must be one of the "Test users" previously configured in the consent screen.

# Open https://google.com/device

32. Enter the code

33. Click on Continue

34. Select "youremail@gmail.com"

35. Click on Continue

36. Click on Allow

37. Authorization Done

38. Continue in the cli

Check for succeeded authorization status

# Open the Google Doc

The module created a new file in your google docs that is used to display.

39. Click on MMM Google Docs Note…

40. Click on File

41. Click on Page setup

42. Click on Page colour picker

43. Click on black

44. Click on OK

45. Click on Text colour

46. Click on white

47. Enter some text

48. (Optional) Click on Insert

49. Click on Emoji

50. Click on 😀

# MagicMirror²

51. Install the module to Magic Mirror

Insert the config to your the Magic Mirror config.js (see readme)

{
  module: 'MMM-GoogleDocs-Notes',
  header: "Notes",
  ...........
}

52. Start the Magic Mirror Server

Check the result

---

Created with Tango.us