2021-02-13 18:22:07 +00:00

130 lines
6.2 KiB
Markdown

# vscode-icons
[![Version](https://vsmarketplacebadge.apphb.com/version/vscode-icons-team.vscode-icons.svg)](https://marketplace.visualstudio.com/items?itemName=vscode-icons-team.vscode-icons)
[![Installs](https://vsmarketplacebadge.apphb.com/installs-short/vscode-icons-team.vscode-icons.svg)](https://marketplace.visualstudio.com/items?itemName=vscode-icons-team.vscode-icons)
[![Ratings](https://vsmarketplacebadge.apphb.com/rating/vscode-icons-team.vscode-icons.svg)](https://marketplace.visualstudio.com/items?itemName=vscode-icons-team.vscode-icons)
[![Build Status](https://travis-ci.org/vscode-icons/vscode-icons.svg?branch=master)](https://travis-ci.org/vscode-icons/vscode-icons)
[![Build Status](https://ci.appveyor.com/api/projects/status/github/vscode-icons/vscode-icons?branch=master&svg=true)](https://ci.appveyor.com/project/vscode-icons-team/vscode-icons)
[![Dependencies Status](https://david-dm.org/vscode-icons/vscode-icons/status.svg)](https://david-dm.org/vscode-icons/vscode-icons)
[![DevDependencies Status](https://david-dm.org/vscode-icons/vscode-icons/dev-status.svg)](https://david-dm.org/vscode-icons/vscode-icons?type=dev)
[![Greenkeeper badge](https://badges.greenkeeper.io/vscode-icons/vscode-icons.svg)](https://greenkeeper.io/)
[![Maintainability](https://api.codeclimate.com/v1/badges/4f02368ebeb7be1490bb/maintainability)](https://codeclimate.com/github/vscode-icons/vscode-icons/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/4f02368ebeb7be1490bb/test_coverage)](https://codeclimate.com/github/vscode-icons/vscode-icons/test_coverage)
[![Known Vulnerabilities](https://snyk.io/test/github/vscode-icons/vscode-icons/badge.svg)](https://snyk.io/test/github/vscode-icons/vscode-icons)
[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/vscode-icons/vscode-icons.svg)](https://isitmaintained.com/project/vscode-icons/vscode-icons "Average time to resolve an issue")
[![Percentage of issues still open](https://isitmaintained.com/badge/open/vscode-icons/vscode-icons.svg)](https://isitmaintained.com/project/vscode-icons/vscode-icons "Percentage of issues still open")
[![Wallaby.js](https://img.shields.io/badge/wallaby.js-configured-green.svg)](https://wallabyjs.com)
---
Bring icons to your [Visual Studio Code](https://code.visualstudio.com/) (**minimum supported version: `1.31.1`**)
![demo](https://raw.githubusercontent.com/vscode-icons/vscode-icons/master/images/screenshot.gif)
---
## Installation
To install the extension just execute the following command:
```sh
ext install vscode-icons
```
Some people have reported that they cannot find the extension when they insert the installation command.
If you find yourself in the same position, try:
```sh
ext install icons
# or
ext install "vscode-icons"
```
## Security
`vscode-icons` utilizes [NSRI](https://www.npmjs.com/package/nsri) for its subresources integrity check and protection against code injection.
## Usage
Once installed and after reloading `vscode`, you will be presented with a message to `Activate` the icons.
In case this doesn't happen, navigate to:
* `Linux` & `Windows` `=>` **File > Preferences > File Icon Theme > VSCode Icons**.
* `MacOS` `=>` **Code > Preferences > File Icon Theme > VSCode Icons**.
## Features
`vscode-icons` is being shipped with a lot of features, like:
* [Icons Customization](https://github.com/vscode-icons/vscode-icons/wiki/Customization)
* [Project Auto-Detection](https://github.com/vscode-icons/vscode-icons/wiki/Pad)
* [Custom Configuration](https://github.com/vscode-icons/vscode-icons/wiki/Configuration)
## Globalization
`vscode-icons` uses [Crowdin](https://crowdin.com/project/vscode-icons-i18n) to provide translations for `vscode` supported languages.
We are looking for translators and proofreaders for all `vscode` supported languages.
If you'd like to contribute, checkout the [translation section](https://github.com/vscode-icons/vscode-icons/wiki/Translation).
## Contributing
If you like to get involved with the source code, checkout the [build section](https://github.com/vscode-icons/vscode-icons/wiki/Build).
For those using [Docker](https://www.docker.com/) checkout the [docker section](https://github.com/vscode-icons/vscode-icons/wiki/Docker).
On the other hand, if you want to show the world your artistic side, checkout the [contributing section](https://github.com/vscode-icons/vscode-icons/wiki/Contributing).
In any case, please follow our [contribution guidelines](https://github.com/vscode-icons/vscode-icons/blob/master/.github/CONTRIBUTING.md).
## Documentation
In our [wiki](https://github.com/vscode-icons/vscode-icons/wiki) you can find info, like:
* [Extension's History](https://github.com/vscode-icons/vscode-icons/wiki/History)
* [Supported file icons](https://github.com/vscode-icons/vscode-icons/wiki/ListOfFiles).
* [Supported folder icons](https://github.com/vscode-icons/vscode-icons/wiki/ListOfFolders).
and more.
## Credits
Kudos to all [contributors](https://github.com/vscode-icons/vscode-icons/graphs/contributors) that made this extension what it is.
## License
The source code is licensed under the [MIT](https://github.com/vscode-icons/vscode-icons/blob/master/License) license.
The icons are licensed under the [Creative Commons - ShareAlike (CC BY-SA)](https://creativecommons.org/licenses/by-sa/4.0/) license.
Branded icons are licensed under their copyright license.
## Versioning
`vscode-icons` follows [Semantic Versioning 2.0.0](http://semver.org/).
## Change Log
You can checkout all our changes in our [change log](https://github.com/vscode-icons/vscode-icons/blob/master/CHANGELOG.md).
## Acknowledgements
We like to express our "Special Thanks" to:
* The [Wallaby.js](https://wallabyjs.com) team for creating an **awesome** development tool and for their generosity in providing us with a license.
## Related extensions
* [vscode-icons for GitHub](https://github.com/dderevjanik/github-vscode-icons) by [@dderevjanik](https://github.com/dderevjanik) will allow you to see all `GitHub`'s files with `vscode-icons` icons.
* [vscode-icons-js](https://github.com/dderevjanik/vscode-icons-js) by [@dderevjanik](https://github.com/dderevjanik) get file/folder specific icon from `vscode-icons` icons.
**Enjoy!**