JupyterLab VSCode Icons Extension
A shameless, unapologetic, and utterly brazen ripoff of the excellent VSCode file icons for JupyterLab. Because why should VS Code users have all the fun?
This extension brings 1414 beautiful file type icons from the vscode-icons project directly into your JupyterLab file browser. We saw those pretty icons, we wanted them, and now you can have them too - no permission asked, no apologies given (well, we did use the MIT license, so it's all legally kosher)
Features
- 1414 file type icons covering virtually every language, framework, and config file you can think of
- One hexagon family for C, C++, Objective-C++, Rust, CUDA and Java, with C# on its own green hexagon;
.hh,.hxx,.h++,.cu,.cuhand.mmare mapped too - Automatic icon detection based on file extensions and names
- Zero configuration required - just install and enjoy
- Lightweight integration using Iconify's JSON icon format
- Compatible with Jupytext - properly displays Python and Markdown icons for .py and .md notebook files; includes hotfix for jupytext 1.19.1 catch-all pattern bug that breaks standard file icons
- Python package folder detection - folders declared in
pyproject.tomlorsetup.pyget a special Python package icon; a manifest is read only when the folder contains it - Fast in large folders - rows are painted once per screen frame, so a 5,000-file folder opens about as fast as it does without the extension
- Symbolic link badges - a link to a file or folder carries a small square arrow badge on its row icon
- Executable file badges - an optional group, off by default, that marks files with the execute bit
- Document tab icons matching the file browser - an open file carries the same glyph on its tab as on its row, including the files JupyterLab claims (.md, .py, .json, .yaml, .csv, images)
- One icon per file whichever extensions are installed - where this extension has an icon for a file, it shows on the row and the tab even when another extension registered that file type with its own icon; the file type is left alone, so the other extension still opens the file
- Readable on both themes - a tab glyph that cannot be seen against its tab is recoloured to clear 3:1 while keeping its internal colours distinct, and a file-browser glyph gets a thin outline; both are re-decided when the background changes
- Web page tabs - a tab showing a web page in a frame (a jupyter-server-proxy service, for example) carries a globe: the brand colour for a page the lab or localhost serves, the accent colour for any other site
- No empty icon space on tabs - a tab without an icon shows its label at the left edge instead of after an empty icon box; a setting turns this off
- Tab tooltip - keeping the pointer on a tab for 0.8 seconds shows its full name, the file path, page address or terminal working directory, the time of its last activity, and JupyterLab's own details such as Last Saved or Kernel; a right-click, a key press or leaving the tab hides it
Requirements
- JupyterLab 4.0+
- A sense of humor about intellectual property (kidding - it's MIT licensed)
- Appreciation for pretty icons
Installation
pip install jupyterlab_vscode_icons_extension
That's it. Restart JupyterLab and watch your bland, iconless file browser transform into a colorful, VSCode-inspired masterpiece
Supported File Types
The extension recognizes hundreds of file types including:
- Languages: Python, JavaScript, TypeScript, Java, C/C++, Rust, Go, Ruby, PHP, R, Julia, and many more
- Web: HTML, CSS, SCSS, Vue, Svelte, React components
- Data: JSON, YAML, CSV, XML, TOML
- Documentation: Markdown, RST, PDF
- Config: Dockerfile, .gitignore, .env, Makefile, package.json
- Notebooks: Jupyter notebooks (.ipynb)
For the complete list of 1414 icons, see the vscode-icons project
Configuration
Customize which icon groups to display via JupyterLab Settings:
- Open JupyterLab Settings (Settings -> Settings Editor)
- Search for "VSCode Icons"
- Toggle icon groups on/off:
- Programming Language Icons (Python, JS, TS, Java, C++, Rust, Go, etc.)
- Web Development Icons (HTML, CSS, Vue, Svelte)
- Data Format Icons (JSON, TOML, XML, CSV, ML models)
- Configuration File Icons (Dockerfile, .gitignore, Makefile, package.json)
- Documentation Icons (Markdown, RST, PDF)
- Image File Icons (PNG, JPG, SVG)
- Executable File Icons (play badge on files with the execute bit; off by default)
- Collapse Empty Tab Icon Space - remove the empty icon box JupyterLab keeps on a tab without an icon (on by default)
Changes require a page refresh to take effect.
Uninstallation
If you somehow tire of beautiful icons (we can't imagine why):
pip uninstall jupyterlab_vscode_icons_extension
Credits
This extension shamelessly borrows icons from the excellent vscode-icons project by Roberto Huertas. Icons are delivered via Iconify, because we believe in standing on the shoulders of giants.
All icon assets remain under their original licenses (MIT for code, CC BY-SA for branded icons). We just wrapped them in a JupyterLab extension and called it a day.
The C, C++, Rust, CUDA and Java hexagons use the vscode-icons file-type-cpp3 shape. The C and CUDA glyphs are vscode-icons artwork, the Rust gear is from skill-icons, and the Java J is drawn for this extension. Both source sets are MIT.
Custom Icons: A few icons (Python, Markdown, README) were hand-crafted in Inkscape - because sometimes you need that perfect shade of purple and the exact right amount of snake eyes.
Why This Exists
Because JupyterLab deserves pretty icons too. That's it. That's the whole justification
Contributing
If you would like to contribute to this extension, please refer to the Contributing Guide.
1 maintainer
Metadata
1 maintainer
Release files for jupyterlab-vscode-icons-extension 1.2.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| jupyterlab_vscode_icons_extension-1.2.21.tar.gz | 7.8 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jupyterlab_vscode_icons_extension-1.2.21-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.9 MB
Release files / jupyterlab_vscode_icons_extension-1.2.21.tar.gz
| Download URL | jupyterlab_vscode_icons_extension-1.2.21.tar.gz |
|---|---|
| Size | 7.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8fb0bbb553bee2dd4f0b849f8a64544f989a19ce974863a4ec929ad5b298170
|
|
BLAKE2b-256 checksum How to use checksums |
f18b6f31f251b0561f3d571775818bdece0beedb5ea19dc8ca3edb42066ab697
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.9
|
Release files / jupyterlab_vscode_icons_extension-1.2.21-py3-none-any.whl
| Download URL | jupyterlab_vscode_icons_extension-1.2.21-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f85a38f34f79762bea6ccbd5d61fc59e5a77c8a0877ec3298bd394179bc560d3
|
|
BLAKE2b-256 checksum How to use checksums |
5f4dde9986485a7b6cb764e81d61f74130215558ded76ccaf7ac87d542d87d1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.9
|
Security for jupyterlab-vscode-icons-extension 1.2.21
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
