Easily download files from any public or private GitHub repository in your GitHub Actions workflows! 🚀

• 🔒 Supports private repositories via Personal Access Token (PAT) or GITHUB_TOKEN
• 📂 Download multiple files or folders in one step
• 🏷️ Specify branch, tag, or commit SHA for precise control
• 🗂️ Map source files to custom destination paths using JSON
• 📝 Generates a workflow summary table for all downloaded files
• 🛠️ Simple setup and configuration
• 🧩 Integrates seamlessly with other actions
• 🖼️ Visual summary in workflow logs

Add the action to your workflow YAML:

jobs:
	download-files:
		runs-on: ubuntu-latest
		steps:
			- name: Checkout
				uses: actions/checkout@v4
			- name: Download files from repo
				uses: AcmeSoftwareLLC/github-downloader@v2
				with:
					token: ${{ secrets.GITHUB_TOKEN }}
					owner: AcmeSoftwareLLC
					repo: example-repo
					ref: develop
					mappings: |
						{
							"src/config.json": "config/config.json",
							"docs/manual.pdf": "documentation/manual.pdf"
						}
					output-directory: "downloads"

Example mappings:

{
	"README.md": "docs/README.md",
	"src/utils.ts": "lib/utils.ts",
}

• Ensure your PAT or GITHUB_TOKEN has access to the target repository (repo/read permissions).
• Check that your mappings JSON is valid and paths exist in the source repo.
• Review workflow logs for error messages and summary table.
• If files are missing, verify the branch/tag/commit and file paths.

Q: Can I download from private repositories? A: Yes! Use a PAT or GITHUB_TOKEN with access to the target repo.

Q: Can I download folders? A: No, only individual files are supported.

Q: What happens if a file doesn't exist? A: The action will fail and report the missing file in the summary.

Q: Can I use this in composite actions? A: Yes, it works in any workflow step.

Pull requests and issues are welcome! Please review the LICENSE before contributing.

• GitHub Actions Documentation
• Creating a Personal Access Token

MIT © AcmeSoftwareLLC