Skip to content

This asset allows you to set custom icons for any folder in unity project browser.

License

Notifications You must be signed in to change notification settings

Borod4r/unity3d-rainbow-folders

Repository files navigation

Discontinued

This project is discontinued and deprecated. Unfortunately, our benefit from the open source project was too low to justify the extra effort to keep it alive.

Meanwhile, development continues and new versions of the Rainbow Folders are now available exclusively on the Asset Store

Now back to original README content…

License

All our code in this repo is covered under Apache 2.0 license:

https://www.apache.org/licenses/LICENSE-2.0

All our icons, images and other artwork is covered under Creative Commons Attribution-NonCommercial 4.0 International licesnse:

https://creativecommons.org/licenses/by-nc/4.0/

Unity3D Rainbow Folders

License

Have you ever thought about highlighting often used project folders? This simple but colorful asset allows you to do that!

With "Rainbow Folders" you can set custom icon for any folder in unity project browser:

Browser window example Browser window example Browser window example

Installing

Rainbow Folders is a standard Unity extension and should be installed like any other Unity package. Just drag the RainbowFolders.unitypackage into your current project, or in the Editor go to the drop-down menu Assets → Import Package → Custom Package and then browse to the RainbowFolders.unitypackage file.

When downloading from the Asset Store then Download Manager will automate this process.

Browser window example

Once the Importing dialog appears, just click the Import button.

Folder location

The package will be imported into the Assets/Plugins/RainbowFolders folder by default. Most users prefer to keep it here, but you can freely move it wherever you want. Just go to Edit → Preferences → Rainbow Folders and update the folder location:

Browser window example

Configuring folder icons

To apply custom icon for some folder in your project view, just hold the Modifier key and click on any folder icon in Unity project browser. By default, it’s the Alt key, but you can change it in Preferences.

Alt-click example

Configuration dialogue will appear, and you'll be able to assign icons to the corresponding folder.

Configuration dialog

What you need to configure for each folder item, are these fields:

  • Folder Name - icon will be applied to all folders with that name.
  • or Folder Path - icon will be applied to a single folder with specified path.
  • Recursive checkbox - subfolders icons will be changed automatically

Then you need to specify actually icons:

  • Small Icon - custom icon for the left panel of the project browser (16x16 px)
  • Large Icon - custom icon for the right panel of the project browser (64x64 px)

Your changes will be applied next time when the project browser will retrieve the focus.

Presets

You can choose icons from few dozen of presets. Simply click on the star button in configuration dialog, select one of them from the drop-down menu and apply changes.

Configuration dialog Configuration dialog

Revert to default

To reset the folder icon to the default one, just Alt-click on it, then press the red cross button in configuration dialogue and apply changes.

Configuration dialog

Multi-editing

You can also edit multiple folders at once, just select them all and Alt-click at one of their icons.

Configuration dialog

Configs List

To view all existing assignments, click on the gear button in the configuration dialog, then take a look at the Inspector.

Configuration dialog

There is reorderable list with all defined "folder" configurations. You can modify existing items, remove them using "-" button or add new ones by clicking "+" button below.

Configuration dialog

If there is more than one config for the same folder (including recursive assignments), then latest (lowest) item in the list will be applied.

Context menu

All the above functionality is also available via the context menu.

Configuration dialog

Right-click on any folder in project view and select Rainbow Folders → Apply Custom to open configuration dialogue.

The Rainbow Folders → Revert to Default item will reset corresponding folder icon to the default one.

With Color, Tag, Type and Platform sub-items you can easily apply custom icons from few dozen of presets, right from the context menu.

Select Rainbow Folders → Settings to view all existing assignments in the inspector.

Upgrading

Please always do a clean import of the Rainbow Folders package (delete the old version before importing the new one). Otherwise, you may receive a number of difficult to diagnose issues.

  • Backup your settings file (optional): Assets/.../RainbowFolders/Editor/Data/RainbowFoldersSettings.asset
  • Delete the Assets/.../RainbowFolders folder.
  • Delete the Assets/Editor Default Resources/RainbowFolders folder, if exists.
  • Import the new version from package or from the Asset Store.
  • Restore your settings file.