{"id":13830337,"url":"https://github.com/jgauth/MMM-GoogleTasks","last_synced_at":"2025-07-09T11:32:41.351Z","repository":{"id":91114484,"uuid":"141855670","full_name":"jgauth/MMM-GoogleTasks","owner":"jgauth","description":null,"archived":false,"fork":false,"pushed_at":"2020-04-22T15:39:41.000Z","size":43,"stargazers_count":21,"open_issues_count":19,"forks_count":27,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-04T10:02:55.581Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jgauth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-07-22T00:57:49.000Z","updated_at":"2024-08-04T10:02:55.582Z","dependencies_parsed_at":null,"dependency_job_id":"0e86fd99-0d54-4a50-adb2-c76d6cfc8075","html_url":"https://github.com/jgauth/MMM-GoogleTasks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgauth%2FMMM-GoogleTasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgauth%2FMMM-GoogleTasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgauth%2FMMM-GoogleTasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgauth%2FMMM-GoogleTasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgauth","download_url":"https://codeload.github.com/jgauth/MMM-GoogleTasks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539378,"owners_count":17485314,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T10:00:58.829Z","updated_at":"2024-11-20T11:30:38.806Z","avatar_url":"https://github.com/jgauth.png","language":"JavaScript","funding_links":[],"categories":["Productivity"],"sub_categories":[],"readme":"# MMM-GoogleTasks\n\nModule for the [MagicMirror²](https://github.com/MichMich/MagicMirror/) smart mirror.\n\nDisplays tasks from Google Tasks App\n\n\n### Example\n![Example of MMM-GoogleTasks](images/sample.png?raw=true \"Example screenshot\")\n\n### Dependencies\n1. The [Google Node.js client library](https://github.com/google/google-api-nodejs-client/): For authentication and Google Tasks API (v1). See Installation for instructions\n\n## Installation\nTo install the module, use your terminal to:\n1. Navigate to your MagicMirror's modules folder. If you are using the default installation directory, use the command:\u003cbr /\u003e`cd ~/MagicMirror/modules`\n2. Clone the module:\u003cbr /\u003e`git clone https://github.com/jgauth/MMM-GoogleTasks.git`\n3. Install Google API:\u003cbr /\u003e`npm install googleapis`\n\n## Authentication Setup\nGoogle Tasks API an authenticated OAuth2 client:\n1. Go [here](https://developers.google.com/tasks/quickstart/nodejs), and click \"Enable the Google Tasks API\" button. Follow the steps to download the credentials.json file. \n2. Move credentials.json to your MMM-GoogleTasks directory (MagicMirror/modules/MMM-GoogleTasks/)\n3. [Enable Google Tasks API](https://console.cloud.google.com/apis/library/tasks.googleapis.com). Select the same project as in step 1.\n4. Run authenticate.js:\u003cbr /\u003e`node authenticate.js`\n5. Follow the instructions and it should print your lists. Copy the ID of the list you want to the config listID\n\n## Using the module\n\n### MagicMirror² Configuration\n\nTo use this module, add the following configuration block to the modules array in the `config/config.js` file:\n```js\nvar config = {\n    modules: [\n        ...\n        {\n            module: 'MMM-GoogleTasks',\n            header: \"Google Tasks\",\n            position: \"top_left\",\n            config: {\n                listID: \"\",\n                ...\n                // See below for Configuration Options\n            }\n        },\n        ...\n    ]\n}\n```\n\n### Configuration Options\n\n| Option                  | Details\n|------------------------ |--------------\n| `listID`                | *Required* - List ID printed from authenticate.js (see installation)\n| `maxResults`            | *Optional* - Max number of list items to retrieve. \u003cbr\u003e\u003cbr\u003e **Possible values:** `0` - `100` \u003cbr\u003e **Default value:** `10`\n| `showCompleted`         | *Optional* - Show completed task items \u003cbr\u003e\u003cbr\u003e **Possible values:** `true`  `false` \u003cbr\u003e **Default value:** `false`\n| `dateFormat`            | *Optional* - Format to use for due date \u003cbr\u003e\u003cbr\u003e **Possible values:** See [Moment.js formats](http://momentjs.com/docs/#/parsing/string-format/) \u003cbr\u003e **Default value:** `MMM Do` (e.g. Jan 18th)\n| `updateInterval`        | *Optional* - Interval at which content updates (Milliseconds) \u003cbr\u003e\u003cbr\u003e **Possible values:** `2000` - `86400000` (Tasks API has default maximum of 50,000 calls per day.) \u003cbr\u003e **Default value:** `10000` (10 seconds)\n| `animationSpeed`        | Speed of the update animation. (Milliseconds) \u003cbr\u003e\u003cbr\u003e **Possible values:** `0` - `5000` \u003cbr\u003e **Default value:** `2000` (2 seconds)\n| `tableClass`            | Name of the classes issued from `main.css`. \u003cbr\u003e\u003cbr\u003e **Possible values:** xsmall, small, medium, large, xlarge. \u003cbr\u003e **Default value:** _small_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgauth%2FMMM-GoogleTasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgauth%2FMMM-GoogleTasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgauth%2FMMM-GoogleTasks/lists"}