{"id":28368808,"url":"https://github.com/emberglazee/yt2hoi4","last_synced_at":"2026-04-13T06:32:10.337Z","repository":{"id":292106444,"uuid":"979681219","full_name":"emberglazee/yt2hoi4","owner":"emberglazee","description":"Automatically download a YouTube playlist and generate a HOI4 music mod out of it.","archived":false,"fork":false,"pushed_at":"2026-03-31T09:43:40.000Z","size":167,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-31T11:38:41.250Z","etag":null,"topics":["bun","bunjs","ffmpeg","hoi4","hoi4mod","youtube","youtube-music","yt-dlp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/emberglazee.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-07T22:44:08.000Z","updated_at":"2025-11-02T05:44:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"192f68a5-6882-4cbc-b9a0-42d0e99fcec2","html_url":"https://github.com/emberglazee/yt2hoi4","commit_stats":null,"previous_names":["nonamelmao/yt2hoi4"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/emberglazee/yt2hoi4","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberglazee%2Fyt2hoi4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberglazee%2Fyt2hoi4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberglazee%2Fyt2hoi4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberglazee%2Fyt2hoi4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emberglazee","download_url":"https://codeload.github.com/emberglazee/yt2hoi4/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberglazee%2Fyt2hoi4/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31742931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T06:26:45.479Z","status":"ssl_error","status_checked_at":"2026-04-13T06:26:44.645Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bun","bunjs","ffmpeg","hoi4","hoi4mod","youtube","youtube-music","yt-dlp"],"created_at":"2025-05-29T05:07:46.948Z","updated_at":"2026-04-13T06:32:10.330Z","avatar_url":"https://github.com/emberglazee.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# yt2hoi4 v0.3.4\n\n\u003e This project is a proof of concept. Unless you have [yt-dlp](https://github.com/yt-dlp/yt-dlp), [FFmpeg](https://ffmpeg.org), and [Bun](https://bun.sh) installed and ready to go, you will probably be better off with an alternative project, like the [Music Mod Creation Tool for Paradox Interactive Games](https://runite-drill.github.io/music-mod-creation-tool)\n\nDownload a YouTube video or a playlist and generate a full Hearts of Iron 4 radio station (music) mod.\n\n## Requirements\n\nThis project requires:\n\n- Bun\n- yt-dlp\n- ffmpeg\n\nAnd was tested on:\n\n- Windows 11 24H2, build 26120\n- Hearts of Iron IV v1.16.9\n\nwith:\n\n- Bun v1.2.19\n- yt-dlp v2025.07.21 (`winget`)\n- ffmpeg v7.1.1 (`winget`)\n- ImageMagick v7.1.2-0 Q16-HDRI (`winget`)\n\n## Installation\n\nInstall [yt-dlp](https://github.com/yt-dlp/yt-dlp?tab=readme-ov-file#installation), [FFmpeg](https://ffmpeg.org/download.html), [Bun](https://bun.sh), and optionally [ImageMagick](https://imagemagick.org/script/download.php) for the --use-thumbnail option\n\n```bash\n# ! Ensure yt-dlp, ffmpeg, bun, and magick are in the PATH environment variable !\n\n# Optionally check if your current version works with YouTube right now; regular updates recommended (`yt-dlp -U`)\n$ yt-dlp --version\n2025.07.21\n# Do the same with FFmpeg\n$ ffmpeg -version\nffmpeg version 7.1.1-full_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers\n  built with gcc 14.2.0 (Rev1, Built by MSYS2 project)\n# And with Bun\n$ bun -v\n1.2.19\n# ImageMagick is only required for custom thumbnails, they're optional\n$ magick --version\nVersion: ImageMagick 7.1.2-0 Q16-HDRI x64 3fcd081:20250713 https://imagemagick.org\n...\n\n# Clone the repository\n$ git clone https://github.com/emberglazee/yt2hoi4\n$ cd yt2hoi4\n\n# Then install project dependencies\n$ bun install\n```\n\n## Usage\n\n```bash\n# Basic usage with default radio station faceplate\n$ bun start --url \u003cyt-dlp_compatible_link\u003e --mod-name \u003cmod-name\u003e\n\n# Use the video/playlist thumbnail as the radio station faceplate (requires ImageMagick)\n$ bun start --url \u003cyt-dlp_compatible_link\u003e --mod-name \u003cmod-name\u003e --use-thumbnail\n\n# Optionally you can also pass your own yt-dlp args:\n$ bun start --url ... --mod-name ... --ytdlp-args --cookies-from-browser firefox --proxy socks5://localhost:1080 ...\n\n# To clean up the `output` and `downloads` folders:\n$ bun cleanup\n\n# To update:\n$ git pull\n# There are likely dependency changes with an update:\n$ bun install\n```\n\n## Screenshot\n\n![screenshot](https://github.com/user-attachments/assets/e26f222a-966c-435c-a41b-cf78787fb7ed)\n\n## Steam Workshop examples\n\n- [Bo's HoI4 MP In A Nutshell - The Podcast](https://steamcommunity.com/sharedfiles/filedetails/?id=3529621862) - 391 audio files with a combined length of 58.5 hours in a single radio station\n\n- [Project Wingman: Frontline-59 OST Music Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=3488744542)\n\n## Why?\n\ni was bored\n\n- total hours spent: ~15-20\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberglazee%2Fyt2hoi4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femberglazee%2Fyt2hoi4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberglazee%2Fyt2hoi4/lists"}