{"id":13405945,"url":"https://github.com/sparanoid/live-dl","last_synced_at":"2025-04-06T06:12:52.066Z","repository":{"id":45474399,"uuid":"214770672","full_name":"sparanoid/live-dl","owner":"sparanoid","description":"Monitor and download live streams from YouTube","archived":false,"fork":false,"pushed_at":"2024-09-10T02:54:56.000Z","size":111,"stargazers_count":268,"open_issues_count":17,"forks_count":38,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-09-10T06:08:31.928Z","etag":null,"topics":["aria2","bash","docker","docker-compose","exiv2","ffmpeg","jq","live","livestream","mp4","python","python-yq","streamlink","vtuber","youtube","youtube-dl"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sparanoid.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-13T06:16:14.000Z","updated_at":"2024-08-26T22:55:07.000Z","dependencies_parsed_at":"2024-04-06T12:32:04.861Z","dependency_job_id":"cb133707-8656-4cc5-81db-7f95b16e805c","html_url":"https://github.com/sparanoid/live-dl","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparanoid%2Flive-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparanoid%2Flive-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparanoid%2Flive-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sparanoid%2Flive-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sparanoid","download_url":"https://codeload.github.com/sparanoid/live-dl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441060,"owners_count":20939239,"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":["aria2","bash","docker","docker-compose","exiv2","ffmpeg","jq","live","livestream","mp4","python","python-yq","streamlink","vtuber","youtube","youtube-dl"],"created_at":"2024-07-30T19:02:16.687Z","updated_at":"2025-04-06T06:12:52.042Z","avatar_url":"https://github.com/sparanoid.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# live-dl\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/sparanoid/live-dl.svg)](https://hub.docker.com/r/sparanoid/live-dl)\n\nMonitor and download live streams from YouTube.\n\n- [Docker Hub](https://hub.docker.com/r/sparanoid/live-dl)\n- [ghcr.io](https://github.com/users/sparanoid/packages/container/package/live-dl)\n\n## Features\n\n- Monitor your favorite YouTube channels and download streams when it starts\n- Email/Slack notifications when the stream starts or finish downloading\n- Writing streamer metadata (author/channel name, description, year) via FFmpeg\n- Keywords filter: only download streams that match specific keywords (or regular expressions) in the title\n- Download subtitles if available\n- Convert TS to MP4 automatically after downloading\n- URL guessing: this script will try its best to guess what you pass to it, the following URLs/URIs should all work:\n  - https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg/live\n  - https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg\n  - https://www.youtube.com/watch?v=S3CAGeeMRvo\n  - https://www.youtube.com/playlist?list=UU1opHUrw8rvnsadT-iGp7Cg\n  - S3CAGeeMRvo\n  - UC1opHUrw8rvnsadT-iGp7Cg\n\n## System Requirements\n\nTested on macOS up to 11.2.3, should be working on Ubuntu and RHEL. Running live-dl inside a container is recommended.\n\n## Available Tags\n\n- `latest`: the latest tagged release\n- `nightly`: the nightly build with latest youtube-dl and streamlink bundles\n\n## Run `live-dl` Inside a Container with Docker\n\nThe simplest way to use live-dl is executing it inside a container. The following command will print the help message of live-dl:\n\n```bash\ndocker run --rm -it sparanoid/live-dl:latest\n```\n\nRun live-dl in interactive mode:\n\n```bash\ndocker run --rm -it --init \\\n  -v $(pwd)/downloads:/app/downloads \\\n  sparanoid/live-dl:latest \\\n  'UC1opHUrw8rvnsadT-iGp7Cg'\n```\n\nRun live-dl as a Docker daemon:\n\n```bash\ndocker run --rm -itd --init \\\n  -v $(pwd)/downloads:/app/downloads \\\n  sparanoid/live-dl:latest \\\n  'UC1opHUrw8rvnsadT-iGp7Cg'\n```\n\nRun live-dl with host volume mounted:\n\n```bash\n# Mount host volume for custom config.yml:\ndocker run --rm -itd --init \\\n  -v $(pwd)/downloads:/app/downloads \\\n  -v $(pwd)/config.yml:/app/config.yml \\\n  sparanoid/live-dl:latest \\\n  'UC1opHUrw8rvnsadT-iGp7Cg'\n\n# Mount host volume for custom cookies.txt:\ndocker run --rm -itd --init \\\n  -v $(pwd)/downloads:/app/downloads \\\n  -v $(pwd)/youtube.com_cookies.txt:/app/cookies.txt \\\n  sparanoid/live-dl:latest \\\n  'UC1opHUrw8rvnsadT-iGp7Cg'\n```\n\nYou can extract your current cookies simply via [Get cookies.txt](https://chrome.google.com/webstore/detail/bgaddhkoddajcdgocldbbfleckgcbcid) Google Chrome extension.\n\n## Run `live-dl` with Docker Compose\n\n```yaml\nversion: '3'\n\nx-defaults: \u0026defaults\n  image: sparanoid/live-dl:latest\n  restart: always\n  volumes:\n    - ./config.yml:/app/config.yml\n    - ./youtube.com_cookies.txt:/app/cookies.txt\n    - ./downloads:/app/downloads\n\nservices:\n  minatoaqua:\n    \u003c\u003c: *defaults\n    command: https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg --debug\n\n  uruharushia:\n    \u003c\u003c: *defaults\n    command: https://www.youtube.com/channel/UCl_gCybOJRIgOXw6Qb4qJzQ --debug\n```\n\n## Run `live-dl` Locally\n\nRun `./live-dl` without any parameter to print help message.\n\nYou can run this script in background with `nohup`:\n\n```bash\n# Start process\nnohup bash live-dl https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg \u0026\u003e/tmp/live-dl-minatoaqua.log \u0026\n\n# View processes\nps aux | grep live-dl\n501 94552   964   0  9:38PM ttys009    0:00.06 bash live-dl https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg\n501 94765   964   0  9:39PM ttys009    0:00.00 grep live-dl\n\n# Stop process\nkill 94552\n```\n\n## Configurations\n\nAll configurations are defined in `config.yml` file. Some options can be overwritten by command line arguments.\n\nRun `./live-dl` without any parameter to print the help message.\n\n## Contributing\n\nIt's recommended to use Docker for development and testing. You should simply mount all your files to the container.\n\n```bash\n# Method 1: Use compose file\ndocker compose up [--build]\n\n# Method 2: Use Dockerfile\ndocker build -t sparanoid/live-dl:local .\ndocker run -it -v $(pwd):/app sparanoid/live-dl:local\n```\n\nIf you'd like to run it locally. You need to install all the dependencies defined in `live-dl`.\n\n## License\n\nAGPL-3.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsparanoid%2Flive-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsparanoid%2Flive-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsparanoid%2Flive-dl/lists"}