How to open .NUPKG files on Linux

To open .NUPKG files on Linux, rename a copy of the file from .nupkg to .zip (it is a ZIP container).

Step-by-step instructions

  1. Rename a copy of the file from .nupkg to .zip (it is a ZIP container).
  2. Use your archive manager or unzip to extract and inspect the contents; the .nuspec manifest is inside the package.

Common issues

“Windows can’t open this file” / double-click does nothing useful

A .nupkg is a ZIP-based NuGet package and usually isn’t associated with a default app for double-click viewing.

  1. Rename a copy of the file from .nupkg to .zip.
  2. Open/extract the .zip with a ZIP tool and inspect the contents (including the .nuspec manifest).

Package contents are hard to understand after extraction

NuGet packages contain code and metadata intended for NuGet tooling; manually browsing can be confusing without checking the manifest.

  1. Locate and open the .nuspec file inside the extracted package to read the package metadata (id, version, description, dependencies).
  2. If you are trying to use the package in a .NET project, prefer consuming it through NuGet rather than copying files manually.

Renaming to .zip fails to open or extraction errors occur

The download may be incomplete/corrupted, or the file may not actually be a valid NuGet package.

  1. Re-download the .nupkg from the original source and try renaming/extracting again.
  2. If you created the package yourself, recreate it with NuGet tooling and then inspect the newly produced .nupkg.

Security note

A .nupkg is a ZIP archive and can contain compiled code meant to be referenced by your application; treating it as “just data” can be risky if you later build/run code that depends on it.

Back to .NUPKG extension page