{"id":13830482,"url":"https://github.com/Ultimatum22/MMM-RandomBackground","last_synced_at":"2025-07-09T11:33:12.960Z","repository":{"id":46395364,"uuid":"75867967","full_name":"Ultimatum22/MMM-RandomBackground","owner":"Ultimatum22","description":null,"archived":false,"fork":false,"pushed_at":"2021-10-17T08:39:38.000Z","size":20,"stargazers_count":9,"open_issues_count":14,"forks_count":9,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-08-04T10:03:11.053Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ultimatum22.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-07T19:19:08.000Z","updated_at":"2024-05-21T08:53:29.000Z","dependencies_parsed_at":"2022-09-19T05:51:00.679Z","dependency_job_id":null,"html_url":"https://github.com/Ultimatum22/MMM-RandomBackground","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/Ultimatum22%2FMMM-RandomBackground","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ultimatum22%2FMMM-RandomBackground/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ultimatum22%2FMMM-RandomBackground/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ultimatum22%2FMMM-RandomBackground/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ultimatum22","download_url":"https://codeload.github.com/Ultimatum22/MMM-RandomBackground/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539408,"owners_count":17485321,"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:01:00.772Z","updated_at":"2024-11-20T11:30:49.389Z","avatar_url":"https://github.com/Ultimatum22.png","language":"JavaScript","funding_links":[],"categories":["Photos"],"sub_categories":[],"readme":"# MagicMirror Module: MMM-RandomBackground\nA MagicMirror Module to show random backgrounds from a local folder on the Mirror.\n\n## Installation\n\nIn your terminal, go to your MagicMirror's Module folder:\n````\ncd ~/MagicMirror/modules\ngit clone https://github.com/Ultimatum22/MMM-RandomBackground.git\nnpm install\n````\n\nConfigure the module in the `config.js` file.\n\n## Using the module\n\nTo use this module, add it to the modules array in the `config/config.js` file:\n````javascript\nmodules: [\n\t{\n\t\tmodule : 'MMM-RandomBackground',\n\t\tposition : 'fullscreen_below', // Any region but this one makes the most sense\n\t\tconfig : {\n\t\t\tanimationSpeed : 2000,\n\t\t\tupdateInterval : 5000\n\t\t}\n\t}\n]\n````\n\nCreate a folder named `photos` in the module directory and place the images to be displayed in this folder. Make sure that the file permissions are set correctly so that the MagicMirror process is able to read the files.\n\n## Configuration options\nThe following properties can be configured:\n\n\u003ctable width=\"100%\"\u003e\n\t\u003cthead\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003cth\u003eOption\u003c/th\u003e\n\t\t\t\u003cth width=\"100%\"\u003eDescription\u003c/th\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/thead\u003e\n\t\u003ctbody\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003eanimationSpeed\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003eHow fast the new image fades into the old one (in milliseconds). A higher value means a slower animation. Default is 1000 ms.\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003eupdateInterval\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003eHow often a new photo is displayed. Default is 10 minutes.\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003eshowAdditionalInfo\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003eShow image meta info. Default is false.\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003erandomOrder\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003eDisplay images in random order. Default is true.\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003eopacity\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003eOpacity of the background. Ranged 0.0 to 1.0. Default is 1.0.\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003ccode\u003ephotoDirectories\u003c/code\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003e[Functionality not yet implemented]\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/tbody\u003e\n\u003c/table\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUltimatum22%2FMMM-RandomBackground","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUltimatum22%2FMMM-RandomBackground","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUltimatum22%2FMMM-RandomBackground/lists"}