{"id":13830183,"url":"https://github.com/justjim1220/MMM-RandomYouTubePlayer","last_synced_at":"2025-07-09T11:32:16.293Z","repository":{"id":122989313,"uuid":"133891969","full_name":"justjim1220/MMM-RandomYouTubePlayer","owner":"justjim1220","description":"This module loads a YouTube player and a specified playlist and will randomize the videos.","archived":false,"fork":false,"pushed_at":"2019-03-05T18:09:01.000Z","size":100,"stargazers_count":17,"open_issues_count":3,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-20T12:09:37.180Z","etag":null,"topics":["3rd-party-modules","magic-mirror-modules","magicmirror2","youtube-api-v3","youtube-player","youtube-playlist"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justjim1220.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-05-18T02:22:05.000Z","updated_at":"2024-11-14T09:47:28.000Z","dependencies_parsed_at":"2024-01-15T17:49:12.916Z","dependency_job_id":null,"html_url":"https://github.com/justjim1220/MMM-RandomYouTubePlayer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/justjim1220/MMM-RandomYouTubePlayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjim1220%2FMMM-RandomYouTubePlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjim1220%2FMMM-RandomYouTubePlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjim1220%2FMMM-RandomYouTubePlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjim1220%2FMMM-RandomYouTubePlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justjim1220","download_url":"https://codeload.github.com/justjim1220/MMM-RandomYouTubePlayer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjim1220%2FMMM-RandomYouTubePlayer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264450556,"owners_count":23610194,"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":["3rd-party-modules","magic-mirror-modules","magicmirror2","youtube-api-v3","youtube-player","youtube-playlist"],"created_at":"2024-08-04T10:00:57.062Z","updated_at":"2025-07-09T11:32:16.006Z","avatar_url":"https://github.com/justjim1220.png","language":"JavaScript","funding_links":[],"categories":["Entertainment"],"sub_categories":[],"readme":"# Module: MMM-RandomYouTubePlayer...\r\n\r\nThe MMM-RandomYouTubePlayer module is a 3rd party module of the \u003ca href=https://github.com/MichMich/MagicMirror/tree/developMagicMirror\u003eMagicMirror\u003c/a\u003e\r\nThis module loads a YouTube player and a specified playlist and will randomize the videos.\r\n\r\n## Using the module...\r\n\r\nTo use this module, add it to the modules array in the 'config/config.js' file:\r\n```\r\nmodules: [\r\n\t{\r\n\tmodule: \"MMM-RandomYouTubePlayer\", \r\n\tposition: \"top_center\",\t      // This can be any of the regions...\r\n\tconfig: {\r\n\t    playlistId: \"PLl_KM23gznEAZW-INW8ty4QNaHH8JCnNW\",     // See Configuration Options below...\r\n            height: 480,\r\n            width: 720,\r\n\t    }\r\n\t},\r\n]\r\n```\r\n\r\n## Install...\r\n```\r\ncd ~/MagicMirror/modules\r\ngit clone https://github.com/justjim1220/MMM-RandomYouTubePlayer.git\r\n```\r\n\r\n## Optional parameters: (defaults for the player as is. change per your needs...)\r\n```\r\nautoplay: true,\r\ndisablekb: true,\r\nenablejsapi: true,\r\ncolor: \"red\",\r\nfs: false, \r\nvolume: \"100%\",\r\ncc_load_policy: true,\r\ncontrols: false,\r\nshowinfo: false, \r\nrel: false, \r\nmodestbranding: true,\r\nloop: true,\r\n```\r\n\r\n## Configuration Options...\r\nThe following properties NEED to be configured:\r\n\r\n| Config                | Description\r\n| --------------------- | ---------------------------------------------------------------------\r\n| playlistId: \" \"      | Youtube playlist id to display. You can get it from youtube url \u003cbr\u003e **Example:** https://www.youtube.com/playlist?list=PLl_KM23gznEAZW-INW8ty4QNaHH8JCnNW \u003cbr\u003e**playlistId:** PLl_KM23gznEAZW-INW8ty4QNaHH8JCnNW (playlist always starts with PL)\r\n| width: 480            | YT player width \u003cbr\u003e **size in pixels per your need**\r\n| height: 700           | YT player height \u003cbr\u003e **size in pixels per your need**\r\n\r\n## Optional Configuration Options...\r\nThe following properties CAN be configured:\r\n\r\n| Option                | Description\r\n| -----------------     | ---------------------------------------------------------------------\r\n| autoplay: true        | Autoplays video when it loaded \u003cbr\u003e **true OR false**\r\n| volume: 75%:          | Sets the volume at a certain level when starting \u003cbr\u003e **1 to 100 %**\r\n| color: \"red\"          | Player's video progress bar - color can only be \"red\" or \"white \u003cbr\u003e **red or white**\r\n| controls: true        | Show youtube video controls bar \u003cbr\u003e **true OR false**\r\n| enablejsapi: true     | Enables the player to be controlled via IFrame API calls. \u003cbr\u003e **true OR false**\r\n| disablekb:            | Disables keyboard control \u003cbr\u003e **true OR false**\r\n| fs: false             | Displays the fullscreen button in player \u003cbr\u003e **true OR false**\r\n| loop: true            | Auto-replays video again \u003cbr\u003e **true OR false**\r\n| cc_load_policy: true  | Displays captions if available for the video playing \u003cbr\u003e **true OR false**\r\n| modestbranding: false | Prevents the Youtube logo from displaying in the controlbar. \u003cbr\u003e **true OR false**\r\n| rel: true             | Shows related videos at the end of video \u003cbr\u003e **true OR false**\r\n| showinfo: true        | Shows video title and uploader \u003cbr\u003e **true OR false**\r\n\r\n## Screenshots...\r\n\r\nOn my TODO list...\r\n\r\n## Known issues...\r\n\r\nONE... Player will only show a max of 200 videos loaded, but it will shuffle through the full playlist.\r\nMy current playlist has approx. 1600 videos, and it shuffles through them all.\r\n\r\nTWO... Player will shuffle the videos, but you will get repeats. (still working on this)\r\n\r\n## Acknowledgements...\r\nI used code snippets from the MMM-EmbedYouTube module by @nitpum \u003cbr\u003e\r\nAnd from the MMM-YouTube-API by @C4TFLY \u003cbr\u003e \r\nThanks to them for giving me the snippets I needed to get started on this module!!! \u003cbr\u003e\r\nAnd, I added my own snippets to complete the project! \u003cbr\u003e\r\n\u003cbr\u003e\r\nI also want to thank @cowboysdude and @Mykle for their help as well! You guys are Awesome!!!\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustjim1220%2FMMM-RandomYouTubePlayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustjim1220%2FMMM-RandomYouTubePlayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustjim1220%2FMMM-RandomYouTubePlayer/lists"}