40 description: Version tag (YYYY.MM.DD[.REV])
44 description: Update channel (stable/nightly/...)
49 description: yt-dlp, yt-dlp.tar.gz, yt-dlp_linux, yt-dlp_linux.zip
53 description: yt-dlp_linux_aarch64, yt-dlp_linux_armv7l
57 description: yt-dlp_macos, yt-dlp_macos.zip
61 description: yt-dlp_macos_legacy
65 description: yt-dlp.exe, yt-dlp_min.exe, yt-dlp_win.zip
69 description: yt-dlp_x86.exe
73 description: SHA2-256SUMS, SHA2-512SUMS, _update_spec
83 runs-on: ubuntu-latest
85 - uses: actions/checkout@v3
86 - uses: actions/setup-python@v4
88 python-version: "3.10"
89 - uses: conda-incubator/setup-miniconda@v2
91 miniforge-variant: Mambaforge
94 auto-update-conda: true
95 activate-environment: ""
96 auto-activate-base: false
97 - name: Install Requirements
99 sudo apt -y install zip pandoc man sed
107 sed '/^brotli.*/d' requirements.txt >> $reqs
108 mamba create -n build --file $reqs
112 python devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
113 python devscripts/make_lazy_extractors.py
114 - name: Build Unix platform-independent binary
117 - name: Build Unix standalone binary
120 unset LD_LIBRARY_PATH # Harmful; set by setup-python
122 python pyinst.py --onedir
123 (cd ./dist/yt-dlp_linux && zip -r ../yt-dlp_linux.zip .)
125 mv ./dist/yt-dlp_linux ./yt-dlp_linux
126 mv ./dist/yt-dlp_linux.zip ./yt-dlp_linux.zip
128 - name: Verify --update-to
129 if: vars.UPDATE_TO_VERIFICATION
131 binaries=("yt-dlp" "yt-dlp_linux")
132 for binary in "${binaries[@]}"; do
134 cp ./${binary} ./${binary}_downgraded
135 version="$(./${binary} --version)"
136 ./${binary}_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
137 downgraded_version="$(./${binary}_downgraded --version)"
138 [[ "$version" != "$downgraded_version" ]]
141 - name: Upload artifacts
142 uses: actions/upload-artifact@v3
154 packages: write # for creating cache
155 runs-on: ubuntu-latest
163 - uses: actions/checkout@v3
166 - name: Virtualized Install, Prepare & Build
167 uses: yt-dlp/run-on-arch-action@v2
169 # Ref: https://github.com/uraimo/run-on-arch-action/issues/55
171 GITHUB_WORKFLOW: build
172 githubToken: ${{ github.token }} # To cache image
173 arch: ${{ matrix.architecture }}
174 distro: ubuntu18.04 # Standalone executable should be built on minimum supported OS
175 dockerRunArgs: --volume "${PWD}/repo:/repo"
176 install: | # Installing Python 3.10 from the Deadsnakes repo raises errors
178 apt -y install zlib1g-dev python3.8 python3.8-dev python3.8-distutils python3-pip
179 python3.8 -m pip install -U pip setuptools wheel
180 # Cannot access requirements.txt from the repo directory at this stage
181 python3.8 -m pip install -U Pyinstaller mutagen pycryptodomex websockets brotli certifi
185 python3.8 -m pip install -U Pyinstaller -r requirements.txt # Cached version may be out of date
186 python3.8 devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
187 python3.8 devscripts/make_lazy_extractors.py
190 if ${{ vars.UPDATE_TO_VERIFICATION && 'true' || 'false' }}; then
191 arch="${{ (matrix.architecture == 'armv7' && 'armv7l') || matrix.architecture }}"
192 chmod +x ./dist/yt-dlp_linux_${arch}
193 cp ./dist/yt-dlp_linux_${arch} ./dist/yt-dlp_linux_${arch}_downgraded
194 version="$(./dist/yt-dlp_linux_${arch} --version)"
195 ./dist/yt-dlp_linux_${arch}_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
196 downgraded_version="$(./dist/yt-dlp_linux_${arch}_downgraded --version)"
197 [[ "$version" != "$downgraded_version" ]]
200 - name: Upload artifacts
201 uses: actions/upload-artifact@v3
203 path: | # run-on-arch-action designates armv7l as armv7
204 repo/dist/yt-dlp_linux_${{ (matrix.architecture == 'armv7' && 'armv7l') || matrix.architecture }}
211 - uses: actions/checkout@v3
212 # NB: Building universal2 does not work with python from actions/setup-python
213 - name: Install Requirements
215 brew install coreutils
216 python3 -m pip install -U --user pip setuptools wheel
217 # We need to ignore wheels otherwise we break universal2 builds
218 python3 -m pip install -U --user --no-binary :all: Pyinstaller -r requirements.txt
222 python3 devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
223 python3 devscripts/make_lazy_extractors.py
226 python3 pyinst.py --target-architecture universal2 --onedir
227 (cd ./dist/yt-dlp_macos && zip -r ../yt-dlp_macos.zip .)
228 python3 pyinst.py --target-architecture universal2
230 - name: Verify --update-to
231 if: vars.UPDATE_TO_VERIFICATION
233 chmod +x ./dist/yt-dlp_macos
234 cp ./dist/yt-dlp_macos ./dist/yt-dlp_macos_downgraded
235 version="$(./dist/yt-dlp_macos --version)"
236 ./dist/yt-dlp_macos_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
237 downgraded_version="$(./dist/yt-dlp_macos_downgraded --version)"
238 [[ "$version" != "$downgraded_version" ]]
240 - name: Upload artifacts
241 uses: actions/upload-artifact@v3
245 dist/yt-dlp_macos.zip
248 if: inputs.macos_legacy
249 runs-on: macos-latest
252 - uses: actions/checkout@v3
253 - name: Install Python
254 # We need the official Python, because the GA ones only support newer macOS versions
256 PYTHON_VERSION: 3.10.5
257 MACOSX_DEPLOYMENT_TARGET: 10.9 # Used up by the Python build tools
259 # Hack to get the latest patch version. Uncomment if needed
260 #brew install python@3.10
261 #export PYTHON_VERSION=$( $(brew --prefix)/opt/python@3.10/bin/python3 --version | cut -d ' ' -f 2 )
262 curl https://www.python.org/ftp/python/${PYTHON_VERSION}/python-${PYTHON_VERSION}-macos11.pkg -o "python.pkg"
263 sudo installer -pkg python.pkg -target /
265 - name: Install Requirements
267 brew install coreutils
268 python3 -m pip install -U --user pip setuptools wheel
269 python3 -m pip install -U --user Pyinstaller -r requirements.txt
273 python3 devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
274 python3 devscripts/make_lazy_extractors.py
278 mv dist/yt-dlp_macos dist/yt-dlp_macos_legacy
280 - name: Verify --update-to
281 if: vars.UPDATE_TO_VERIFICATION
283 chmod +x ./dist/yt-dlp_macos_legacy
284 cp ./dist/yt-dlp_macos_legacy ./dist/yt-dlp_macos_legacy_downgraded
285 version="$(./dist/yt-dlp_macos_legacy --version)"
286 ./dist/yt-dlp_macos_legacy_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
287 downgraded_version="$(./dist/yt-dlp_macos_legacy_downgraded --version)"
288 [[ "$version" != "$downgraded_version" ]]
290 - name: Upload artifacts
291 uses: actions/upload-artifact@v3
294 dist/yt-dlp_macos_legacy
298 runs-on: windows-latest
301 - uses: actions/checkout@v3
302 - uses: actions/setup-python@v4
303 with: # 3.8 is used for Win7 support
304 python-version: "3.8"
305 - name: Install Requirements
306 run: | # Custom pyinstaller built with https://github.com/yt-dlp/pyinstaller-builds
307 python -m pip install -U pip setuptools wheel py2exe
308 pip install -U "https://yt-dlp.github.io/Pyinstaller-Builds/x86_64/pyinstaller-5.8.0-py3-none-any.whl" -r requirements.txt
312 python devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
313 python devscripts/make_lazy_extractors.py
316 python setup.py py2exe
317 Move-Item ./dist/yt-dlp.exe ./dist/yt-dlp_min.exe
319 python pyinst.py --onedir
320 Compress-Archive -Path ./dist/yt-dlp/* -DestinationPath ./dist/yt-dlp_win.zip
322 - name: Verify --update-to
323 if: vars.UPDATE_TO_VERIFICATION
325 foreach ($name in @("yt-dlp","yt-dlp_min")) {
326 Copy-Item "./dist/${name}.exe" "./dist/${name}_downgraded.exe"
327 $version = & "./dist/${name}.exe" --version
328 & "./dist/${name}_downgraded.exe" -v --update-to yt-dlp/yt-dlp@2023.03.04
329 $downgraded_version = & "./dist/${name}_downgraded.exe" --version
330 if ($version -eq $downgraded_version) {
335 - name: Upload artifacts
336 uses: actions/upload-artifact@v3
345 runs-on: windows-latest
348 - uses: actions/checkout@v3
349 - uses: actions/setup-python@v4
350 with: # 3.7 is used for Vista support. See https://github.com/yt-dlp/yt-dlp/issues/390
351 python-version: "3.7"
353 - name: Install Requirements
355 python -m pip install -U pip setuptools wheel
356 pip install -U "https://yt-dlp.github.io/Pyinstaller-Builds/i686/pyinstaller-5.8.0-py3-none-any.whl" -r requirements.txt
360 python devscripts/update-version.py -c ${{ inputs.channel }} ${{ inputs.version }}
361 python devscripts/make_lazy_extractors.py
366 - name: Verify --update-to
367 if: vars.UPDATE_TO_VERIFICATION
369 foreach ($name in @("yt-dlp_x86")) {
370 Copy-Item "./dist/${name}.exe" "./dist/${name}_downgraded.exe"
371 $version = & "./dist/${name}.exe" --version
372 & "./dist/${name}_downgraded.exe" -v --update-to yt-dlp/yt-dlp@2023.03.04
373 $downgraded_version = & "./dist/${name}_downgraded.exe" --version
374 if ($version -eq $downgraded_version) {
379 - name: Upload artifacts
380 uses: actions/upload-artifact@v3
386 if: inputs.meta_files && always() && !cancelled()
394 runs-on: ubuntu-latest
396 - uses: actions/download-artifact@v3
398 - name: Make SHA2-SUMS files
401 sha256sum * > ../SHA2-256SUMS
402 sha512sum * > ../SHA2-512SUMS
404 - name: Make Update spec
406 cat >> _update_spec << EOF
407 # This file is used for regulating self-update
408 lock 2022.08.18.36 .+ Python 3.6
411 - name: Sign checksum files
413 GPG_SIGNING_KEY: ${{ secrets.GPG_SIGNING_KEY }}
414 if: env.GPG_SIGNING_KEY != ''
416 gpg --batch --import <<< "${{ secrets.GPG_SIGNING_KEY }}"
417 for signfile in ./SHA*SUMS; do
418 gpg --batch --detach-sign "$signfile"
421 - name: Upload artifacts
422 uses: actions/upload-artifact@v3