Internet Archive Upload Action

• This action was originally forked from palewire/internet-archive-upload.
• It allows you to upload files or directories to the Internet Archive (archive.org) and set metadata for the uploaded items.
• The action supports uploading single files, multiple files, or entire directories, and it can handle various metadata fields to describe the content being uploaded.

Inputs: (Required)

• These 4 fields, MUST be present in your action configuration.
• Missing any 1 of these will cause the upload to fail.

Additional Non-Metadata Optional Inputs

Outputs

Supported Metadata Fields Inputs: (Optional)

• All of the following fields are optional.
• They are used to define additional metadata on your uploads according to the Archive.org Metadata Schema.
• Please refer to the metadata docs above if you have any questions about uploading specific metadata.

Usage Examples

1cdb640f1bd8b06c29ef86a7d323d8c2e51eda89

Upload a single file with metadata

name: Upload a file to archive.org with metadata
jobs:

  job:
    name: Upload a file
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v6

      - name: Upload file to archive.org
        id: ia_upload
        uses: nick2bad4u/internet-archive-upload@1cdb640f1bd8b06c29ef86a7d323d8c2e51eda89
        with:
            # Required fields
            access-key: ${{ secrets.IA_ACCESS_KEY }}
            secret-key: ${{ secrets.IA_SECRET_KEY }}
            identifier: your-item
            files: your-file.jpg

            # Optional metadata fields
            title: "My Archive Title"
            creator: "Jane Doe,John Smith"
            subject: "example,archive,upload"
            date: "2025-05-29"
            language: "English"
            betterpdf: true

      - name: Print uploaded item URL
        run: echo "Item URL: ${{ steps.ia_upload.outputs.item-url }}"

Upload a directory of files

name: Upload a directory of files to archive.org with metadata
jobs:

  job:
    name: Upload directory
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v6

      - name: Upload directory to archive.org
        uses: nick2bad4u/internet-archive-upload@1cdb640f1bd8b06c29ef86a7d323d8c2e51eda89
        with:
          # Required fields
          access-key: ${{ secrets.IA_ACCESS_KEY }}
          secret-key: ${{ secrets.IA_SECRET_KEY }}
          identifier: your-item
          files: your-files/

          # Optional metadata fields
          title: "My Archive Title"
          creator: "Jane Doe,John Smith"
          subject: "example,archive,upload"
          date: "2025-05-29"
          language: "English"
          betterpdf: true

Example of a real-world usage in a GitHub Actions workflow

• Action is located here in the repo here: .github/workflows/internet-archive-upload.yml
• Check workflow run logs here: Upload Releases to Archive.org - Logs

name: Upload Releases to Archive.org

on:
  workflow_dispatch:
  push:

concurrency:
  group: IA-${{ github.ref }}
  cancel-in-progress: true

jobs:
  upload-windows:
    runs-on: ubuntu-latest
    steps:

      - name: Download release tarball + zip
        id: download_zip
        uses: robinraju/release-downloader@daf26c55d821e836577a15f77d86ddc078948b05 # v1.12
        with:
          repository: Nick2bad4u/internet-archive-upload
          latest: true
          tarBall: true
          zipBall: true
          token: ${{ secrets.GITHUB_TOKEN }}

      - name: Upload tarball + zip to archive.org
        uses: Nick2bad4u/internet-archive-upload@1cdb640f1bd8b06c29ef86a7d323d8c2e51eda89 # main
        with:
          access-key: ${{ secrets.IA_ACCESS_KEY }}
          secret-key: ${{ secrets.IA_SECRET_KEY }}
          identifier: Github-Action-IA-Archiver-${{ steps.download_zip.outputs.tag_name }}
          files: ./
        continue-on-error: true
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Issues

If you encounter any issues or have feature requests, please open an issue in the GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

If you want to contribute to this project, please fork the repository and submit a pull request. Contributions are welcome!

Acknowledgements

This action was originally created by Ben Welsh. It has been forked and maintained by Nick2bad4u.