{"id":17659378,"url":"https://github.com/updownleftdie/obs-random-videos","last_synced_at":"2025-04-09T16:05:34.274Z","repository":{"id":36986266,"uuid":"269232317","full_name":"UpDownLeftDie/obs-random-videos","owner":"UpDownLeftDie","description":"Easily create a random playlist of videos or music","archived":false,"fork":false,"pushed_at":"2025-03-07T05:53:59.000Z","size":70,"stargazers_count":84,"open_issues_count":5,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-09T16:05:27.965Z","etag":null,"topics":["browser-source","glimesh","hacktoberfest","live-streaming","obs","streaming","streamlabs-obs","trovo","twitch","video","youtube"],"latest_commit_sha":null,"homepage":"","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/UpDownLeftDie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","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},"funding":{"custom":["https://www.twitch.tv/subs/updownleftdie","https://cash.app/$UpDownLeftDie/FPBDPCH","https://www.paypal.me/jaredkotoff","https://next.invitation.codes/@updownleftdie"],"github":null,"patreon":null,"open_collective":null,"ko_fi":"jaredk","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null}},"created_at":"2020-06-04T01:29:16.000Z","updated_at":"2025-04-04T09:19:20.000Z","dependencies_parsed_at":"2022-06-30T21:52:09.489Z","dependency_job_id":"ffd7a30e-c7ca-4588-ab27-36be9da678b1","html_url":"https://github.com/UpDownLeftDie/obs-random-videos","commit_stats":{"total_commits":28,"total_committers":2,"mean_commits":14.0,"dds":0.1071428571428571,"last_synced_commit":"705a656d2fe284769decbcb4ed84b202e2fdc9ce"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpDownLeftDie%2Fobs-random-videos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpDownLeftDie%2Fobs-random-videos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpDownLeftDie%2Fobs-random-videos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpDownLeftDie%2Fobs-random-videos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UpDownLeftDie","download_url":"https://codeload.github.com/UpDownLeftDie/obs-random-videos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065288,"owners_count":21041871,"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":["browser-source","glimesh","hacktoberfest","live-streaming","obs","streaming","streamlabs-obs","trovo","twitch","video","youtube"],"created_at":"2024-10-23T16:06:51.589Z","updated_at":"2025-04-09T16:05:34.256Z","avatar_url":"https://github.com/UpDownLeftDie.png","language":"JavaScript","funding_links":["https://www.twitch.tv/subs/updownleftdie","https://cash.app/$UpDownLeftDie/FPBDPCH","https://www.paypal.me/jaredkotoff","https://next.invitation.codes/@updownleftdie","https://ko-fi.com/jaredk"],"categories":[],"sub_categories":[],"readme":"# OBS Random Video Player\n\nPlay videos in random order!\n\n_Perfect for BRB screens!_\n\nNotice: the VLC Source now supports \"Shuffle playlist\" option.\n\n## [Download](https://github.com/UpDownLeftDie/obs-random-videos/releases/latest)\n\n### [Discord Support](https://discord.gg/zxYsjpxaxN)\n\n## Instructions\n\n1. Download the latest executable for your system from above\n2. Place the executable into the folder where your video/audio files you want to use are located\n3. Run the file and follow the prompts for your settings\n4. A new file called `obs-random-videos.html` will be created in the same folder\n5. Add a new `Browser Source` to OBS\n   1. Check \"Local File\" and select the new `obs-random-videos.html` you just created.\n   2. **Copy this path**\n   3. **Uncheck \"Local file\" and set the url to `file://\u003cpaste the path you copied\u003e`**\n      1. Windows example: `file://C:/obs-videos-folder/obs-random-videos.html`\n      2. Mac/Linux example: `file:///obs-videos-folder/obs-random-videos.html` **(note the `///` instead of `//`)**\n   4. Set the width and height to your full canvas resolution\n   5. Check \"Shutdown source when not visible\"\n   6. If you want a new shuffle each time: check \"Refresh browser when scene becomes active\"\n   7. Leave \"Page permissions\" set to \"Read access to OBS status information\"\n6. **Rerun the executable when you add or remove videos** or want to change any settings\n\n### Supported files\n\n#### Video\n\n- mp4\n- m4v\n- webm\n- mpeg4\n\n#### Audio\n\n- mp3\n- ogg\n- aac\n\n## Notes\n\n- VLC Source now supports \"Shuffle playlist\"\n  - This may be a more stable alternative to this project\n  - Mac's with M1 chip: Install the Intel version of VLC to use the VLC plugin\n- Set `Refresh browser when scene becomes active`\n- Video resolutions should match your canvas aspect ratio\n- **Autoplay only works in OBS!**\n  - To test in your browser you must hit the Play button first\n- Pro tip: webm videos support transparency (convert mov to webm to save on file size)\n\n## Stuck? Or nothing happening?\n\n  1. Try hitting `Refresh cache of current page` in OBS\n  2. **In OBS go to `Scene Collection` then `New`**\n     1. **Add only your random video browser source and see if this works**\n     2. **If it works, then theres an external issue.** I have no idea what is causing this so, if you have any info on this us know in the [discussions](https://github.com/UpDownLeftDie/obs-random-videos/discussions)\n  3. [Enable remote debugging](https://github.com/crowbartools/Firebot/wiki/Troubleshooting-Firebot-Overlay-issues-in-OBS-Studio) and open the page for the browser source\n     1. Open Chrome Dev tools\n     2. `Application` tab\n     3. Make sure `Local and session storage` box is CHECKED\n     4. Click `Clear site data`\n  4. If issues persist: use [GitHub Discussions](https://github.com/UpDownLeftDie/obs-random-videos/discussions/categories/q-a) or join the [Discord server](https://discord.gg/zxYsjpxaxN)\n\n## TODO\n\n- Audio-only or video-only modes\n- Option for cross-fading between videos\n- Option to HTML background color\n  - Good for videos with weird aspect ratio\n  - Good for audio files\n- Switch to [Bubble Tea](https://github.com/charmbracelet/bubbletea) instead of `promptui`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupdownleftdie%2Fobs-random-videos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fupdownleftdie%2Fobs-random-videos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupdownleftdie%2Fobs-random-videos/lists"}