{"id":25580571,"url":"https://github.com/younelan/simplelivestream","last_synced_at":"2026-05-09T09:41:49.052Z","repository":{"id":54943383,"uuid":"522744544","full_name":"younelan/SimpleLiveStream","owner":"younelan","description":"Simple Live Stream using Bash and ffmpeg","archived":false,"fork":false,"pushed_at":"2023-10-03T02:48:45.000Z","size":6376,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-10-03T12:09:26.840Z","etag":null,"topics":["broadcasting","ffmpeg","ffmpeg-wrapper","music-player","radio","streaming","twitch","youtube"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/younelan.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}},"created_at":"2022-08-09T00:03:28.000Z","updated_at":"2023-08-30T04:10:05.000Z","dependencies_parsed_at":"2023-01-20T02:32:21.312Z","dependency_job_id":null,"html_url":"https://github.com/younelan/SimpleLiveStream","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younelan%2FSimpleLiveStream","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younelan%2FSimpleLiveStream/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younelan%2FSimpleLiveStream/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younelan%2FSimpleLiveStream/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/younelan","download_url":"https://codeload.github.com/younelan/SimpleLiveStream/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239952621,"owners_count":19723924,"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":["broadcasting","ffmpeg","ffmpeg-wrapper","music-player","radio","streaming","twitch","youtube"],"created_at":"2025-02-21T04:16:53.962Z","updated_at":"2026-03-30T23:30:18.175Z","avatar_url":"https://github.com/younelan.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"*Simple Live Stream* - FFmpeg Uncomplicated Stream Script\n\nThis is a simple script to simplify streaming platforms like **YouTUBE** or **Twitch** through **ffmpeg**\n\n## Steps to make it work:\n- install ffmpeg\n    - **Ubuntu:** apt-get install ffmpeg\n    - **Mac** install ffmpeg on a mac\n    - **Windows**: unsupported but you probably can install windows subsystem for linux and **apt-get ffmpeg**\n- Add stream keys:\n    - Get a Youtube Stream Key and put in **config.sh** as **YOUTUBE_KEY**\n    - Get a Twitch Stream Key and put in **config.sh** as **YOUTUBE_KEY**\n- edit **DEFAULT_VIDEO_SOURCE** to reflect the video background file\n- edit your playlist, default **music.txt** playlist with One music file per line \n  in the following format: '**file filename.mp3**' . Note the word file is required\n- optionally run the screen command if you want to run it remotely\n- optionally add an overlay to your video with **add_image.sh**\n- run **stream.sh** with optional parameters below\n\n## Syntax examples:\n### stream using defaults in config.sh\n   \u003e ./stream.sh\n### stream to twitch restarting on a loop if streaming fails\n   \u003e ./stream.sh -t twitch -l YES\n### stream playlist \"music.txt\" with background \"title.png\"\n   \u003e ./stream.sh -p music.txt -t title.png\n### stream playlist dance.txt with video video.mp4 as a background\n   \u003e ./stream.sh -p dance.txt -v video.mp4\n### stream playlist play.txt with overlay overlay title.png and video video.mov in the background\n   \u003e ./stream.sh -p play.txt -o title.png -v video.mov \u003elog.txt @\u00261 -l YES \u0026\u0026\n### pre-create a video with your overlay to use less resources while streaming\n   \u003e ./add_image.sh {input.video} {output.video} {overlay.image}\n\n## optional parameters\n- **-p [playlist]**  provide a file playlist\n- **-t [target]**    provide a target - youtube or twitch\n- **-v [video]**     provide a video file for background\n- **-i [img.file]**  provide a image for the background, preferably transparent png\n- **-o [image]**     provide an image to overlay on video\n- **-d [dir]**       provide a dir to play all audio files in a directory\n- **-c [config]**    provide an alternate config to support multiple configs\n\n## main files:\n- **config.sh**    - variables to customize the script\n- **common.sh**    - common functions\n- **stream.sh**    - main stream script\n- **add_image.sh** - overlay an image on an existing video\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyounelan%2Fsimplelivestream","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyounelan%2Fsimplelivestream","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyounelan%2Fsimplelivestream/lists"}