NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #155 most downloaded on NuGet
SharpCompress is a compression library for NET 4.8/NET 8.0/NET 10.0 that can unrar, decompress 7zip, decompress xz, zip/unzip, tar/untar lzip/unlzip, bzip2/unbzip2 and gzip/ungzip with forward-only reading and file random access APIs. Write support for zip/tar/bzip2/gzip is implemented.
Latest stable
0.50.11
Last release today
21 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
127 years old
119 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Apply the LZMA2 dictionary limit to retained history by @adamhathcock in #1500
Full Changelog: 0.50.10...0.50.11
Update .NET SDK to fix AOT restore by @adamhathcock in #1489
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: 0.50.8...0.50.10
Also check the CVEs for the published security fixes
Also check the CVEs for the published security fixes
Full Changelog: 0.50.8...0.50.9
Also check the CVEs for the published security fixes
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.8...0.50.9
Nothing published for this version
Reduce allocations in RAR5 password key derivation by @adamhathcock in #1464
Full Changelog: 0.50.6...0.50.7
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.6...0.50.7
Fix 7z encryption detection for streamless files by @adamhathcock in #1446
Full Changelog: 0.50.5...0.50.6
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.5...0.50.6
Cache RAR5 encrypted header key derivation by @adamhathcock in #1419
Full Changelog: 0.50.4...0.50.5
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.4...0.50.5
Adam/fix tar symlink by @adamhathcock in #1407
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.3...0.50.4
Fix RAR5 async decompression corruption in UnpWriteBufAsync by @adamhathcock in #1396
Full Changelog: 0.50.2...0.50.3
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.2...0.50.3
Fix SeekableSharpCompressStream.StopRecording() to rewind to recorded… by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1393
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.1...0.50.2
Fix ArgumentException in ZlibBaseStream when disposing mid-stream GZip probe in ReaderFactory by @adamhathcock with @Copilot in #1371
Thanks for reporting!
Full Changelog: 0.50.0...0.50.1
Thanks for reporting!
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.50.0...0.50.1
Tar Archive does not try to decompress streams anymore. TarReader will still do this.
Breaking changes:
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.49.1...0.50.0
Close writable entry streams during async archive disposal by @Copilot in #1338
WriteToDirectoryAsync progress callbacks for solid 7z archives by @Copilot in #1340Full Changelog: 0.49.0...0.49.1
WriteToDirectoryAsync progress callbacks for solid 7z archives by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1340Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.49.0...0.49.1
This should contain a lot of write async fixes and some breaking API changes that fix previous broke net48 usage
This should contain a lot of write async fixes and some breaking API changes that fix previous broke net48 usage
IVolume.FileName for single-volume file-based archives by @Copilot in #1333Full Changelog: 0.48.1...0.49.0
This should contain a lot of write async fixes and some breaking API changes that fix previous broke net48 usage
IVolume.FileName for single-volume file-based archives by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1333Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.48.1...0.49.0
release test cleanup by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1322
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.48.0...0.48.1
Getting some fixes out to prep for bigger release - async writing might still not work on non-async streams
Getting some fixes out to prep for bigger release - async writing might still not work on non-async streams
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.47.4...0.48.0
Dynamic ring buffer sizing for BZip2 and ZStandard on non-seekable streams by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1273
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.47.3...0.47.4
Fix denial-of-service crashes in 8 decompressors on malformed input by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1260
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.47.2...0.47.3
Making the default experience better with a larger buffer size.
Making the default experience better with a larger buffer size.
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.47.1...0.47.2
Proper test file clean up by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1245
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.47.0...0.47.1
I think this is the last breaking change before I mark things as 1.0. Looking for feedback
I think this is the last breaking change before I mark things as 1.0. Looking for feedback
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.46.4...0.47.0
Fix DataErrorException when extracting LZMA-compressed zero-byte ZIP entries by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/12
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.46.3...0.46.4
Fix SharpCompressStream.Create() buffer size misalignment for non-seekable streams by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.46.2...0.46.3
Downgrade dependencies for legacy frameworks by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1226
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.46.1...0.46.2
Fix NullReferenceException when extracting 7z empty-stream entries by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1219
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.46.0...0.46.1
Open/Create must be asynchronous now so they return ValueTasks when they didn't before.
Open/Create must be asynchronous now so they return ValueTasks when they didn't before.
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.45.1...0.46.0
The big regression was fixed in 0.44.5 and 0.45.0 but only for sync. This does it for async too.
The big regression was fixed in 0.44.5 and 0.45.0 but only for sync. This does it for async too.
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.45.0...0.45.1
This release should be fully async as well as sync depending on the API used. I've endeavoured to make sure no sync methods are used when going via th
This release should be fully async as well as sync depending on the API used. I've endeavoured to make sure no sync methods are used when going via the async interface (and vice versa) but you never know.
Tests should cover things as well as the recent fixes (like the 7z regression)
Options and the API have been revamped so expect API breakages. I think it should be straight-forward but things won't compile.
There is a thing about Dispose vs async Disposing that may or may not be fully covered 😬
Feedback is welcome as I think 1.0 is around the corner with the introduction of Providers and other things. I wanted to get the async revamp out generally first though.
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.5...0.45.0
Add [Obsolete] attribute to ReaderOptions.DefaultBufferSize for backward compatibility by @Copilot in https://github.com/adamhathcock/sharpcompress/pu
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.4...0.44.5
Fix ArrayPool corruption from double-disposal in BufferedSubStream by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1161
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.3...0.44.4
Merge pull request #1156 from adamhathcock/copilot/fix-sharpcompress-… by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1157
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.2...0.44.3
Adam/1151 release cherry pick by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1154 same as https://github.com/adamhathcock/shar
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.1...0.44.2
Merge pull request #1145 from adamhathcock/copilot/add-leaveopen-para… by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1146
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.44.0...0.44.1
Configure nuget-release workflow to validate PRs without publishing by @Copilot in https://github.com/adamhathcock/sharpcompress/pull/1099
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.43.0...0.44.0
Big changes: Progress was redone to use IProgress. ZstdSharp was moved into the project. More groundwork for full async as well as more contributions
Big changes: Progress was redone to use IProgress. ZstdSharp was moved into the project. More groundwork for full async as well as more contributions and bug fixes!
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.42.0...0.43.0
Fix: Should not throw on ARJ detection by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/1067
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.42.0...0.42.1
This is one where I leaned heavily on AI for asynchronous implementation and bug fixes. ARJ is provided by @TwanVanDongen
This is one where I leaned heavily on AI for asynchronous implementation and bug fixes. ARJ is provided by @TwanVanDongen
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.41.0...0.42.0
Fix volume FileName property potentially missing by @Morilli in https://github.com/adamhathcock/sharpcompress/pull/921
Attrib for ZipEntry by @Morilli in https://github.com/adamhathcock/sharpcompress/pull/933Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.40.0...0.41.0
don't run net48 on non-windows by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/892
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.39.0...0.40.0
Restore stream position in ArchiveFactory.IsArchive by @Morilli in https://github.com/adamhathcock/sharpcompress/pull/876
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.38.0...0.39.0
Tar: Add processing for the LongLink header type by @DannyBoyk in https://github.com/adamhathcock/sharpcompress/pull/847
Type of ArchiveType.Tar instead of ArchiveType.Gzip by @Morilli in https://github.com/adamhathcock/sharpcompress/pull/848Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.37.2...0.38.0
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.37.1...0.37.2
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.37.1...0.37.2
Prevent infinite loop when reading corrupted archive by @Blokyk in https://github.com/adamhathcock/sharpcompress/pull/835
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.37.0...0.37.1
Updated ZstdSharp.Port to be native Private assets for github link?
Zip: Use last modified time from basic header when validating zip decryption by @DannyBoyk in https://github.com/adamhathcock/sharpcompress/pull/805
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.36.0...0.37.0
ZipWriter: Write correct EOCD record when more than 65,535 files by @DannyBoyk in https://github.com/adamhathcock/sharpcompress/pull/792
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.35.0...0.36.0
Dont crash on reading rar5 comment #783 by @Erior in https://github.com/adamhathcock/sharpcompress/pull/784
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.34.2...0.35.0
Throw ReaderCancelledException on reader cancelled by @pathartl in https://github.com/adamhathcock/sharpcompress/pull/778
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.34.1...0.34.2
Feature/761 by @Erior in https://github.com/adamhathcock/sharpcompress/pull/768
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.34.0...0.34.1
Check for broken file #736 by @Erior in https://github.com/adamhathcock/sharpcompress/pull/737
ExtractToDirectoryAsync extension method on IArchive by @FlsZen in https://github.com/adamhathcock/sharpcompress/pull/750Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.33.0...0.34.0
I think the API didn't break with IArchiveFactory
I think the API didn't break with IArchiveFactory
I've been out it for health reasons
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.32.2...0.33.0
ReadOnlySubStream overrides and adds logic #636 by @Erior in https://github.com/adamhathcock/sharpcompress/pull/675
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.32.1...0.32.2
Feature/malformed zip file generated by @Erior in https://github.com/adamhathcock/sharpcompress/pull/673
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.32...0.32.1
Add a net 6 target and make trimmable by @ds5678 in https://github.com/adamhathcock/sharpcompress/pull/652
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.31...0.32
Rar2 fix with new unit tests that fail on previous build. by @Nanook in https://github.com/adamhathcock/sharpcompress/pull/638
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.30.1...0.31
Add test and probable fix for Issue 617 by @adamhathcock in https://github.com/adamhathcock/sharpcompress/pull/624
Full Changelog: https://github.com/adamhathcock/sharpcompress/compare/0.30.0...0.30.1
I accepted a PR to add net461 back as there's still multi-targetting issues. I guess .NET Standard 2.0 never really worked out.
I accepted a PR to add net461 back as there's still multi-targetting issues. I guess .NET Standard 2.0 never really worked out.
Included that and a fix:
https://www.nuget.org/packages/SharpCompress/0.30.0
Two minor fixes from contributors and a behavior fix for extraction. Now the destination directory has to exist before extracting will be allowed.
Two minor fixes from contributors and a behavior fix for extraction. Now the destination directory has to exist before extracting will be allowed.
https://github.com/adamhathcock/sharpcompress/pull/601- Write ZIP64 End of Central Directory only if needed.
https://github.com/adamhathcock/sharpcompress/pull/593 - ReadFully used by pkware encryption didn’t like spans
Two issues found and squashed
One column per quarter.