πŸ“¦ timheuer / zipview

A VS Code extension that shows zip files in the workspace and their contents for quick review.

β˜… 0 stars β‘‚ 0 forks πŸ‘ 0 watching βš–οΈ MIT License
πŸ“₯ Clone https://github.com/timheuer/zipview.git
HTTPS git clone https://github.com/timheuer/zipview.git
SSH git clone git@github.com:timheuer/zipview.git
CLI gh repo clone timheuer/zipview
github-actions[bot] github-actions[bot] chore: update changelog [skip ci] 6aafa90 8 days ago πŸ“ History
πŸ“‚ main View all commits β†’
πŸ“ .github
πŸ“ .vscode
πŸ“ src
πŸ“„ .gitignore
πŸ“„ .vscode-test.mjs
πŸ“„ .vscodeignore
πŸ“„ CHANGELOG.md
πŸ“„ cliff.toml
πŸ“„ esbuild.js
πŸ“„ icon.png
πŸ“„ LICENSE.md
πŸ“„ package.json
πŸ“„ README.md
πŸ“„ tsconfig.json
πŸ“„ version.json
πŸ“„ README.md

πŸ“¦ Zip Viewer

Peek inside zip files without ever extracting them!

Zip Viewer brings seamless zip file browsing directly into VS Code's Explorer. Browse, preview, and inspect archived files as if they were part of your workspaceβ€”no extraction required.

VS Code Marketplace Installs License

πŸ“₯ Installation

Install in VS Code Install in VS Code Insiders

Or search for "Zip Viewer" in the VS Code Extensions view (Ctrl+Shift+X).

✨ Features

FeatureDescription
πŸ—‚οΈ Explorer IntegrationZip files appear in a dedicated "Zip Files" panel in your Explorer sidebar
πŸ” Browse Without ExtractingExpand archives to navigate their full directory structure
πŸ“„ Syntax-Highlighted PreviewOpen any text file with full language supportβ€”JS, TS, JSON, CSS, Markdown, and more
πŸ–ΌοΈ Image PreviewView PNG, JPG, GIF, WebP, SVG, and other images using VS Code's native viewer
🎨 Theme-Aware IconsFiles and folders display icons from your current file icon theme
⚑ Live UpdatesTree automatically refreshes when zip files are added, removed, or changed
πŸ“ Quick NavigationRight-click any zip to reveal it in the workspace Explorer

πŸš€ Getting Started

  • Install the extension from the VS Code Marketplace
  • Open a workspace containing .zip files
  • Find the "Zip Files" panel in your Explorer sidebar
  • Click any zip file to expand and browse its contents
  • Select a file to preview it instantly

πŸ“ Supported File Types

Text Files

All text-based files open with proper syntax highlighting based on their extensionβ€”.js, .ts, .py, .css, .json, .xml, .md, .html, .yaml, and hundreds more.

Images

Images open in VS Code's built-in image viewer with full zoom and pan support:
  • PNG, JPG, JPEG, GIF, BMP, ICO, WebP, SVG

Binary Files

Other binary files (executables, PDFs, archives) are listed in the tree but cannot be previewed.

βš™οΈ Configuration

Fine-tune the extension's behavior in your VS Code settings:

SettingDefaultDescription
zipView.maxFileSize10Max file size (MB) that can be previewed
zipView.maxCompressionRatio100Max compression ratio before blocking (zip bomb protection)
zipView.maxCacheSize50Number of file contents to cache for faster access
zipView.logLevelinfoLogging verbosity: off, error, warn, info, debug, trace
πŸ’‘ Tip: Defaults are optimized for security and performance. Increase with caution.

πŸ”’ Security

Zip Viewer includes built-in protections:

  • Path traversal prevention β€” Blocks malicious paths like ../../../etc/passwd
  • Zip bomb detection β€” Refuses to open files with suspicious compression ratios
  • File size limits β€” Prevents memory exhaustion from oversized files

πŸ“‹ Requirements

  • Visual Studio Code 1.107.0 or higher

πŸ“„ License

MIT β€” Made with β˜• by Tim Heuer