Download Release Assets - GitHub Action

Key Features

Streamline release asset downloads with intelligent version handling

🎯

Smart Version Resolution

Use v1 to automatically get the latest v1.x.x release without hardcoding specific versions

📦

Auto-Extraction

Automatically extracts ZIP, TAR, and TAR.GZ archives - no manual extraction needed

🔍

Pattern Matching

Download specific files using glob patterns like *.zip or exact filenames

Quick Start

Get started in seconds

Zero Configuration

          - name:
          Download release
          uses:
          starburst997/download-release@v1
        

Basic Usage

          - name:
          Download release assets
          uses:
          starburst997/download-release@v1
          with:
          repository:
          owner/repo tag:
          v1.2.3 pattern:
          *.zip
        

Smart Version Resolution

          - name:
          Download latest v1 release
          id: download
          uses:
          starburst997/download-release@v1
          with:
          repository:
          owner/repo tag:
          v1
          # Resolves to latest v1.x.x
          pattern:
          release.tar.gz
          extract-to: ./dist

          - name:
          Use downloaded files
          run: |
          echo "Downloaded to: ${{ steps.download.outputs.download-path
            }}"
          echo "Resolved tag: ${{ steps.download.outputs.resolved-tag
            }}"
        

Documentation

Complete reference for all inputs and outputs

Inputs

Input	Description	Required	Default
`repository`	Repository in `owner/name` format	No	`${{ github.repository }}`
`tag`	Release tag (supports `v1`, `v1.2.3`, `latest`)	No	`${{ github.action_ref }}`
`pattern`	File pattern to download (e.g., `*.zip`, `release.zip`)	No	`release.zip`
`extract-to`	Directory to extract files to	No	`${{ runner.temp }}/release`
`token`	GitHub token for authentication	No	`${{ github.token }}`

Outputs

Output	Description
`resolved-tag`	The actual tag that was resolved and downloaded
`download-path`	Path where files were extracted

Version Resolution Examples

v1 → Latest v1.x.x release
v1.2.3 → Exact version v1.2.3
latest → Latest release (any version)