https://github.com/emberglazee/yt2hoi4
Automatically download a YouTube playlist and generate a HOI4 music mod out of it.
https://github.com/emberglazee/yt2hoi4
bun bunjs ffmpeg hoi4 hoi4mod youtube youtube-music yt-dlp
Last synced: 2 months ago
JSON representation
Automatically download a YouTube playlist and generate a HOI4 music mod out of it.
- Host: GitHub
- URL: https://github.com/emberglazee/yt2hoi4
- Owner: emberglazee
- Created: 2025-05-07T22:44:08.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2026-03-31T09:43:40.000Z (3 months ago)
- Last Synced: 2026-03-31T11:38:41.250Z (3 months ago)
- Topics: bun, bunjs, ffmpeg, hoi4, hoi4mod, youtube, youtube-music, yt-dlp
- Language: TypeScript
- Homepage:
- Size: 163 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# yt2hoi4 v0.3.4
> 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)
Download a YouTube video or a playlist and generate a full Hearts of Iron 4 radio station (music) mod.
## Requirements
This project requires:
- Bun
- yt-dlp
- ffmpeg
And was tested on:
- Windows 11 24H2, build 26120
- Hearts of Iron IV v1.16.9
with:
- Bun v1.2.19
- yt-dlp v2025.07.21 (`winget`)
- ffmpeg v7.1.1 (`winget`)
- ImageMagick v7.1.2-0 Q16-HDRI (`winget`)
## Installation
Install [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
```bash
# ! Ensure yt-dlp, ffmpeg, bun, and magick are in the PATH environment variable !
# Optionally check if your current version works with YouTube right now; regular updates recommended (`yt-dlp -U`)
$ yt-dlp --version
2025.07.21
# Do the same with FFmpeg
$ ffmpeg -version
ffmpeg version 7.1.1-full_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers
built with gcc 14.2.0 (Rev1, Built by MSYS2 project)
# And with Bun
$ bun -v
1.2.19
# ImageMagick is only required for custom thumbnails, they're optional
$ magick --version
Version: ImageMagick 7.1.2-0 Q16-HDRI x64 3fcd081:20250713 https://imagemagick.org
...
# Clone the repository
$ git clone https://github.com/emberglazee/yt2hoi4
$ cd yt2hoi4
# Then install project dependencies
$ bun install
```
## Usage
```bash
# Basic usage with default radio station faceplate
$ bun start --url --mod-name
# Use the video/playlist thumbnail as the radio station faceplate (requires ImageMagick)
$ bun start --url --mod-name --use-thumbnail
# Optionally you can also pass your own yt-dlp args:
$ bun start --url ... --mod-name ... --ytdlp-args --cookies-from-browser firefox --proxy socks5://localhost:1080 ...
# To clean up the `output` and `downloads` folders:
$ bun cleanup
# To update:
$ git pull
# There are likely dependency changes with an update:
$ bun install
```
## Screenshot
## Steam Workshop examples
- [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
- [Project Wingman: Frontline-59 OST Music Mod](https://steamcommunity.com/sharedfiles/filedetails/?id=3488744542)
## Why?
i was bored
- total hours spent: ~15-20