45 VERSION: yyyy.mm.dd[.rev] or rev
50 SOURCE of this build's updates: stable/nightly/master/<repo>
55 description: yt-dlp, yt-dlp.tar.gz, yt-dlp_linux, yt-dlp_linux.zip
59 description: yt-dlp_linux_aarch64, yt-dlp_linux_armv7l
63 description: yt-dlp_macos, yt-dlp_macos.zip
67 description: yt-dlp_macos_legacy
71 description: yt-dlp.exe, yt-dlp_min.exe, yt-dlp_win.zip
75 description: yt-dlp_x86.exe
79 description: SHA2-256SUMS, SHA2-512SUMS, _update_spec
95 runs-on: ubuntu-latest
97 origin: ${{ steps.process_origin.outputs.origin }}
99 - name: Process origin
102 echo "origin=${{ inputs.origin || github.repository }}" >> "$GITHUB_OUTPUT"
107 runs-on: ubuntu-latest
109 - uses: actions/checkout@v3
110 - uses: actions/setup-python@v4
112 python-version: "3.10"
113 - uses: conda-incubator/setup-miniconda@v2
115 miniforge-variant: Mambaforge
117 channels: conda-forge
118 auto-update-conda: true
119 activate-environment: ""
120 auto-activate-base: false
121 - name: Install Requirements
123 sudo apt -y install zip pandoc man sed
131 sed '/^brotli.*/d' requirements.txt >> $reqs
132 mamba create -n build --file $reqs
136 python devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
137 python devscripts/make_lazy_extractors.py
138 - name: Build Unix platform-independent binary
141 - name: Build Unix standalone binary
144 unset LD_LIBRARY_PATH # Harmful; set by setup-python
146 python pyinst.py --onedir
147 (cd ./dist/yt-dlp_linux && zip -r ../yt-dlp_linux.zip .)
149 mv ./dist/yt-dlp_linux ./yt-dlp_linux
150 mv ./dist/yt-dlp_linux.zip ./yt-dlp_linux.zip
152 - name: Verify --update-to
153 if: vars.UPDATE_TO_VERIFICATION
155 binaries=("yt-dlp" "yt-dlp_linux")
156 for binary in "${binaries[@]}"; do
158 cp ./${binary} ./${binary}_downgraded
159 version="$(./${binary} --version)"
160 ./${binary}_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
161 downgraded_version="$(./${binary}_downgraded --version)"
162 [[ "$version" != "$downgraded_version" ]]
165 - name: Upload artifacts
166 uses: actions/upload-artifact@v3
179 packages: write # for creating cache
180 runs-on: ubuntu-latest
188 - uses: actions/checkout@v3
191 - name: Virtualized Install, Prepare & Build
192 uses: yt-dlp/run-on-arch-action@v2
194 # Ref: https://github.com/uraimo/run-on-arch-action/issues/55
196 GITHUB_WORKFLOW: build
197 githubToken: ${{ github.token }} # To cache image
198 arch: ${{ matrix.architecture }}
199 distro: ubuntu18.04 # Standalone executable should be built on minimum supported OS
200 dockerRunArgs: --volume "${PWD}/repo:/repo"
201 install: | # Installing Python 3.10 from the Deadsnakes repo raises errors
203 apt -y install zlib1g-dev python3.8 python3.8-dev python3.8-distutils python3-pip
204 python3.8 -m pip install -U pip setuptools wheel
205 # Cannot access requirements.txt from the repo directory at this stage
206 python3.8 -m pip install -U Pyinstaller mutagen pycryptodomex websockets brotli certifi
210 python3.8 -m pip install -U Pyinstaller -r requirements.txt # Cached version may be out of date
211 python3.8 devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
212 python3.8 devscripts/make_lazy_extractors.py
215 if ${{ vars.UPDATE_TO_VERIFICATION && 'true' || 'false' }}; then
216 arch="${{ (matrix.architecture == 'armv7' && 'armv7l') || matrix.architecture }}"
217 chmod +x ./dist/yt-dlp_linux_${arch}
218 cp ./dist/yt-dlp_linux_${arch} ./dist/yt-dlp_linux_${arch}_downgraded
219 version="$(./dist/yt-dlp_linux_${arch} --version)"
220 ./dist/yt-dlp_linux_${arch}_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
221 downgraded_version="$(./dist/yt-dlp_linux_${arch}_downgraded --version)"
222 [[ "$version" != "$downgraded_version" ]]
225 - name: Upload artifacts
226 uses: actions/upload-artifact@v3
228 path: | # run-on-arch-action designates armv7l as armv7
229 repo/dist/yt-dlp_linux_${{ (matrix.architecture == 'armv7' && 'armv7l') || matrix.architecture }}
237 - uses: actions/checkout@v3
238 # NB: Building universal2 does not work with python from actions/setup-python
239 - name: Install Requirements
241 brew install coreutils
242 python3 -m pip install -U --user pip setuptools wheel
243 # We need to ignore wheels otherwise we break universal2 builds
244 python3 -m pip install -U --user --no-binary :all: Pyinstaller -r requirements.txt
248 python3 devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
249 python3 devscripts/make_lazy_extractors.py
252 python3 pyinst.py --target-architecture universal2 --onedir
253 (cd ./dist/yt-dlp_macos && zip -r ../yt-dlp_macos.zip .)
254 python3 pyinst.py --target-architecture universal2
256 - name: Verify --update-to
257 if: vars.UPDATE_TO_VERIFICATION
259 chmod +x ./dist/yt-dlp_macos
260 cp ./dist/yt-dlp_macos ./dist/yt-dlp_macos_downgraded
261 version="$(./dist/yt-dlp_macos --version)"
262 ./dist/yt-dlp_macos_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
263 downgraded_version="$(./dist/yt-dlp_macos_downgraded --version)"
264 [[ "$version" != "$downgraded_version" ]]
266 - name: Upload artifacts
267 uses: actions/upload-artifact@v3
271 dist/yt-dlp_macos.zip
275 if: inputs.macos_legacy
276 runs-on: macos-latest
279 - uses: actions/checkout@v3
280 - name: Install Python
281 # We need the official Python, because the GA ones only support newer macOS versions
283 PYTHON_VERSION: 3.10.5
284 MACOSX_DEPLOYMENT_TARGET: 10.9 # Used up by the Python build tools
286 # Hack to get the latest patch version. Uncomment if needed
287 #brew install python@3.10
288 #export PYTHON_VERSION=$( $(brew --prefix)/opt/python@3.10/bin/python3 --version | cut -d ' ' -f 2 )
289 curl https://www.python.org/ftp/python/${PYTHON_VERSION}/python-${PYTHON_VERSION}-macos11.pkg -o "python.pkg"
290 sudo installer -pkg python.pkg -target /
292 - name: Install Requirements
294 brew install coreutils
295 python3 -m pip install -U --user pip setuptools wheel
296 python3 -m pip install -U --user Pyinstaller -r requirements.txt
300 python3 devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
301 python3 devscripts/make_lazy_extractors.py
305 mv dist/yt-dlp_macos dist/yt-dlp_macos_legacy
307 - name: Verify --update-to
308 if: vars.UPDATE_TO_VERIFICATION
310 chmod +x ./dist/yt-dlp_macos_legacy
311 cp ./dist/yt-dlp_macos_legacy ./dist/yt-dlp_macos_legacy_downgraded
312 version="$(./dist/yt-dlp_macos_legacy --version)"
313 ./dist/yt-dlp_macos_legacy_downgraded -v --update-to yt-dlp/yt-dlp@2023.03.04
314 downgraded_version="$(./dist/yt-dlp_macos_legacy_downgraded --version)"
315 [[ "$version" != "$downgraded_version" ]]
317 - name: Upload artifacts
318 uses: actions/upload-artifact@v3
321 dist/yt-dlp_macos_legacy
326 runs-on: windows-latest
329 - uses: actions/checkout@v3
330 - uses: actions/setup-python@v4
331 with: # 3.8 is used for Win7 support
332 python-version: "3.8"
333 - name: Install Requirements
334 run: | # Custom pyinstaller built with https://github.com/yt-dlp/pyinstaller-builds
335 python -m pip install -U pip setuptools wheel py2exe
336 pip install -U "https://yt-dlp.github.io/Pyinstaller-Builds/x86_64/pyinstaller-5.8.0-py3-none-any.whl" -r requirements.txt
340 python devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
341 python devscripts/make_lazy_extractors.py
344 python setup.py py2exe
345 Move-Item ./dist/yt-dlp.exe ./dist/yt-dlp_min.exe
347 python pyinst.py --onedir
348 Compress-Archive -Path ./dist/yt-dlp/* -DestinationPath ./dist/yt-dlp_win.zip
350 - name: Verify --update-to
351 if: vars.UPDATE_TO_VERIFICATION
353 foreach ($name in @("yt-dlp","yt-dlp_min")) {
354 Copy-Item "./dist/${name}.exe" "./dist/${name}_downgraded.exe"
355 $version = & "./dist/${name}.exe" --version
356 & "./dist/${name}_downgraded.exe" -v --update-to yt-dlp/yt-dlp@2023.03.04
357 $downgraded_version = & "./dist/${name}_downgraded.exe" --version
358 if ($version -eq $downgraded_version) {
363 - name: Upload artifacts
364 uses: actions/upload-artifact@v3
374 runs-on: windows-latest
377 - uses: actions/checkout@v3
378 - uses: actions/setup-python@v4
379 with: # 3.7 is used for Vista support. See https://github.com/yt-dlp/yt-dlp/issues/390
380 python-version: "3.7"
382 - name: Install Requirements
384 python -m pip install -U pip setuptools wheel
385 pip install -U "https://yt-dlp.github.io/Pyinstaller-Builds/i686/pyinstaller-5.8.0-py3-none-any.whl" -r requirements.txt
389 python devscripts/update-version.py -c "${{ inputs.channel }}" -r "${{ needs.process.outputs.origin }}" "${{ inputs.version }}"
390 python devscripts/make_lazy_extractors.py
395 - name: Verify --update-to
396 if: vars.UPDATE_TO_VERIFICATION
398 foreach ($name in @("yt-dlp_x86")) {
399 Copy-Item "./dist/${name}.exe" "./dist/${name}_downgraded.exe"
400 $version = & "./dist/${name}.exe" --version
401 & "./dist/${name}_downgraded.exe" -v --update-to yt-dlp/yt-dlp@2023.03.04
402 $downgraded_version = & "./dist/${name}_downgraded.exe" --version
403 if ($version -eq $downgraded_version) {
408 - name: Upload artifacts
409 uses: actions/upload-artifact@v3
415 if: inputs.meta_files && always() && !cancelled()
424 runs-on: ubuntu-latest
426 - uses: actions/download-artifact@v3
428 - name: Make SHA2-SUMS files
431 sha256sum * > ../SHA2-256SUMS
432 sha512sum * > ../SHA2-512SUMS
434 - name: Make Update spec
436 cat >> _update_spec << EOF
437 # This file is used for regulating self-update
438 lock 2022.08.18.36 .+ Python 3.6
441 - name: Sign checksum files
443 GPG_SIGNING_KEY: ${{ secrets.GPG_SIGNING_KEY }}
444 if: env.GPG_SIGNING_KEY != ''
446 gpg --batch --import <<< "${{ secrets.GPG_SIGNING_KEY }}"
447 for signfile in ./SHA*SUMS; do
448 gpg --batch --detach-sign "$signfile"
451 - name: Upload artifacts
452 uses: actions/upload-artifact@v3