{"id":23564561,"url":"https://github.com/parnic/mmm-unsplash","last_synced_at":"2025-04-30T16:19:22.227Z","repository":{"id":75525266,"uuid":"130492456","full_name":"parnic/MMM-Unsplash","owner":"parnic","description":"Show a random photo from an Unsplash collection","archived":false,"fork":false,"pushed_at":"2024-07-20T17:49:46.000Z","size":20,"stargazers_count":8,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-30T16:19:15.888Z","etag":null,"topics":["magicmirror","magicmirror2","unsplash","unsplash-api","unsplash-collections"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/parnic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-21T16:35:48.000Z","updated_at":"2024-07-20T17:49:49.000Z","dependencies_parsed_at":"2024-08-04T10:13:19.548Z","dependency_job_id":null,"html_url":"https://github.com/parnic/MMM-Unsplash","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parnic%2FMMM-Unsplash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parnic%2FMMM-Unsplash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parnic%2FMMM-Unsplash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parnic%2FMMM-Unsplash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parnic","download_url":"https://codeload.github.com/parnic/MMM-Unsplash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251739678,"owners_count":21635894,"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":["magicmirror","magicmirror2","unsplash","unsplash-api","unsplash-collections"],"created_at":"2024-12-26T17:16:46.652Z","updated_at":"2025-04-30T16:19:22.197Z","avatar_url":"https://github.com/parnic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MMM-Unsplash\r\nA \u003ca href=\"https://github.com/MichMich/MagicMirror\"\u003eMagicMirror²\u003c/a\u003e module used to pull a random photo from one or more Unsplash collections. Like \u003ca href=\"https://github.com/diego-vieira/MMM-RandomPhoto\"\u003eMMM-RandomPhoto\u003c/a\u003e, but for specific collections. Tested with MagicMirror² v2.2.2, v2.3.1 servers, Chrome 65 on Windows 10 and Midori 0.4.3 on a Raspberry Pi Zero W with Raspbian Jessie.\r\n\r\n## Installation\r\n1. Navigate into your MagicMirror's `modules` folder and execute `git clone https://github.com/parnic/MMM-Unsplash.git`.\r\n2. Add the module inside `config.js` placing it where you prefer.\r\n\r\n## Config\r\n|Option|Type|Description|Default|\r\n|---|---|---|---|\r\n|`opacity`|double|The opacity of the image.|0.3|\r\n|`collections`|string|(REQUIRED) Comma-delimited list of collections to pull from.|`''`|\r\n|`width`|int|Desired image width.|`1080`|\r\n|`height`|int|Desired image height.|`1920`|\r\n|`orientation`|string|Orientation of the image. Valid values: `landscape`, `portrait`, `squarish`|`'portrait'`|\r\n|`apiKey`|string|(REQUIRED) Your Unsplash API key.|`''`|\r\n|`updateInterval`|int|Number of seconds between image updates. Note that your API key is rate-limited, so if, for example, your rate limit was 50/hr, this should be no less than 72.|`1800` (30mins)|\r\n|`divName`|string|The ID of the div to use for the displayed image. This only needs to be set if you use something like [MMM-ProfileSwitcher](https://github.com/tosti007/MMM-ProfileSwitcher) and/or need to be able to load images from multiple Unsplash modules at once.|`'mmm-unsplash-placeholder'`|\r\n\r\nHere is an example of an entry in config.js\r\n```\r\n{\r\n\tmodule: 'MMM-Unsplash',\r\n\tposition: 'fullscreen_below',\r\n\tconfig: {\r\n\t\tcollections: '369966,1240111,1136512,629911,150672,920773',\r\n\t\tapiKey: 'your_api_key'\r\n\t}\r\n},\r\n```\r\n\r\n## Notes\r\nPull requests are very welcome! If you'd like to see any additional functionality, don't hesitate to let me know.\r\n\r\n## Dependencies\r\nNone!\r\n\r\n## Special Thanks\r\n\u003ca href=\"https://github.com/diego-vieira/MMM-RandomPhoto\"\u003eMMM-RandomPhoto\u003c/a\u003e for the inspiration. The core image update functionality is cribbed from this module.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparnic%2Fmmm-unsplash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparnic%2Fmmm-unsplash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparnic%2Fmmm-unsplash/lists"}