Collection Manager

This add-on adds new functionality for the management of collections via a pop-up and a QCD (Quick Content Display) system in the 3D Viewport. It also offers simple display and modification of the relationship of objects with collections.

../../_images/addons_interface_collection-manager_popup.png
../../_images/addons_interface_collection-manager_qcd.png

Activation

  • Open Blender and go to Preferences then the Add-ons tab.

  • Click Interface then Collection Manager to enable the script.

Description

Pop-up

Use M to call up the main Collection Manager pop-up in the 3D Viewport when in Object Mode. It can also be found in the Object ‣ Collection menu.

View Layer
Render

Enable/disable rendering of this view layer with this checkbox.

View Layer

Data-Block Menu of the current view layer.

Expand All Items

Toggle all collections expanded or collapsed. Only enabled when you have subcollections.

Renumber QCD Slots

Shown only if QCD is enabled in the preferences.

  • LMB – Renumber the QCD slots from the root slot (the slot designated 1) down to the bottom, for each depth level (breadth first search).

  • Alt-LMB – Renumber from the first top-level collection in a breadth first search pattern.

  • Ctrl-LMB – Switch the renumber pattern to linear. This pattern will renumber straight down the list regardless of hierarchy.

  • Shift-LMB – Constrain renumbering to the branch under the root slot.

Hint

All options can be combined with each other.

Specials
Remove Empty Collections

Remove all collections that have no subcollections or objects.

Purge All Collections Without Objects

Remove all collections that have no objects regardless of whether they have subcollections.

Display Options (funnel icon)

Choose which restriction toggles are shown in the interface and whether the restriction toggles are aligned to the right in the tree view.

Scene Collection
Set Active Collection

Sets the active collection to the Scene Collection.

Name

This is static and can’t be edited.

Set Object (box icon)
  • LMB – Move object(s) to collection.

  • Shift-LMB – Add/Remove object(s) to/from collection.

Global Restrictions (checkbox, cursor, eye, screen, camera, holdout, indirect only icons)

See the Outliner page for information about Restrictions.

  • LMB – Enable the restriction for all collections. Click again to restore the previous state.

  • Shift-LMB – Invert the restriction state on all collections.

  • Shift-Ctrl-LMB – Isolate collections with selected objects.

  • Shift-Alt-LMB – Disable collections with selected objects.

  • Ctrl-LMB – Copy/paste the restriction state on all collections.

  • Ctrl-Alt-LMB – Swap the restriction state on all collections with that of another restriction.

  • Alt-LMB – Discard the previous state, and anything that has been stored for Copy/Paste or Swap.

Tree View

Shows the collections within the current selected scene.

Disclosure (small triangle icon)
  • LMB – Expand/collapse subcollections.

  • Shift-LMB – Isolate the tree. Collapses everything but the current item, and it’s parents/descendants. Click again to restore the previous state.

  • Ctrl-LMB – Expand/collapse subcollections and their descendants.

Set Active Collection

Click to set the active collection to this collection.

QCD Slot

Set which QCD slot the collection corresponds to. (Shown only if QCD is enabled in the preferences.)

Name

Double LMB-click to rename the collection.

Set Object (box icon)
  • LMB – Move object(s) to collection.

  • Shift-LMB – Add/Remove object(s) to/from collection.

Local Restrictions (checkbox, cursor, eye, screen, camera, holdout, indirect only icons)
  • LMB – Toggle the collection’s restriction on/off.

  • Shift-LMB – Isolate the collection’s restriction, preserving parents if need be. Click again to restore the previous state.

  • Shift-Ctrl-LMB – Isolate the collection and it’s descendants’ restrictions, preserving parents if need be. Click again to restore the previous state.

  • Ctrl-LMB – Toggle the restrictions of the collection and it’s descendants on/off.

  • Alt-LMB – Discard the previous state.

Remove X

Remove the collection.

Filtering
By Name

A text field to filter collections by name.

Invert (magnifying glass icon)

Invert filtering (inverts the collections shown in the tree view so that what is shown is hidden and what was hidden is shown).

By Selected (box icon)

Filter collections by selected objects (show only collections that contain the selected objects).

By QCD Slots (Q key icon)

Filter collections by those designated as QCD slots (show only collections that correspond to a QCD slot). Shown only if QCD is enabled in the preferences.

Hint

All options can be combined with each other.

Add Collection, Add Subcollection

Self-explanatory.

Note

If the tree view is filtered when adding collections, new collections that do not fit the filter rules will be displayed until the filtering changes.

Phantom Mode

All visibility changes made in this mode will be discarded when it’s disabled.

Enabling Phantom Mode saves the current state of the restrictions and allows you to edit them without fear of losing their current state. When finished, disabling Phantom Mode will restore the saved state.

Note: You will be unable to edit anything other than the restrictions while in Phantom Mode.

Apply Phantom Mode (check mark icon)

Applies all changes made to RTOs while in Phantom Mode and exits the mode.

QCD

The Quick Content Display system provides a way to rapidly interact with collections by allowing you to designate up to 20 collections as QCD slots. You can then interact with these slots by using hotkeys or the widget to view or move objects to them.

3D Viewport Header Widget

The header widget is composed of the Quick View Toggles button and 20 QCD slots.

Quick View Toggles (eye icon)
  • Enable All QCD Slots.

  • Enable All QCD Slots Isolated. (Enables all QCD slots and disables any non QCD slots)

  • Isolate Selected Objects Collections.

  • Disable Selected Objects Collections.

  • Disable All Non QCD Slots.

  • Disable All Collections.

  • Select All QCD Objects. (Select all objects that belong to enabled QCD slots)

  • Discard QCD History. (Discards previous QCD slot states)

Hotkeys

  • LMB – Enable All QCD Slots.

  • Alt-LMB – Select All QCD Objects.

  • LMB hold down – Opens a menu with all Quick View Toggles.

QCD Slots

20 buttons in two rows in groups of five where the first row starts with slot 1 and the second with slot 11.

The state of each slot is shown with a combination of the following indicators:

  • x – Unassigned slot.

  • non-highlighted – non-visible slot.

  • highlighted – visible slot.

  • no icon – no objects in the slot.

  • horizontal line icon – objects are present in this slot.

  • circle icon – one or more objects in this slot are selected.

  • dot icon – the active object is in this slot.

Hotkeys

  • LMB – View single slot excluding all others.

  • Shift-LMB – Add/remove slot to/from view.

  • Ctrl-LMB – Move selected objects to slot.

  • Shift-Ctrl-LMB – Add/remove selected objects to/from slot.

  • Alt-LMB – Replace selection with objects in this slot.

  • Shift-Alt-LMB – Add/remove slot objects to/from the selection.

Move Widget

Use V to call up the Move widget in the 3D Viewport when in Object Mode. It can also be found in the Object -> Collection menu.

The Move Widget shares its layout and indicators with the 3D Viewport header widget.

Hotkeys

  • LMB – Move selected objects to slot.

  • Shift-LMB – Add/remove selected objects to/from slot.

  • 0 - 9 – Move selected objects to slot 1-10 (0 is slot 10).

  • Alt-0 - Alt-9 – Move selected objects to slot 11-20 (0 is slot 20).

  • Shift-0 - Shift-9 – Add/remove selected objects to/from slot 1-10 (0 is slot 10).

  • Shift-Alt-0 - Shift-Alt-9 – Add/remove selected objects to/from slot 11-20 (0 is slot 20).

3D Viewport Hotkeys

Object Mode

QCD
  • 0 - 9 – View slot 1-10 (0 is slot 10). Excludes all others.

  • Alt-0 - Alt-9 – View slot 11-20 (0 is slot 20). Excludes all others.

  • Shift-0 - Shift-9 – Add/remove slot 1-10 (0 is slot 10) to/from view.

  • Shift-Alt-0 - Shift-Alt-9 – Add/remove slot 11-20 (0 is slot 20) to/from view.

  • Shift-= – Enable All QCD Slots.

  • = – Isolate Selected Objects Collections.

  • Minus – Disable Selected Objects Collections.

  • Shift-Alt-= – Disable All Non QCD Slots.

  • Ctrl-Alt-= – Disable All Collections.

  • Shift-Ctrl-= – Select All QCD Objects.

  • Alt-= – Discard QCD History.

Disable Objects (Only available if enabled in the preferences.)
  • H – Disable Selected.

  • Shift-H – Disable Unselected.

  • Alt-H – Restore Disabled Objects.

Edit Mode

All Object Mode hotkeys except for Select All QCD Objects and the Disable Objects hotkeys. (Only available if enabled in the preferences.)

  • AccentGrave – Mesh Select Mode menu.

Note

Slots with objects not in Object Mode can not be excluded.

Preferences

Disable objects instead of hiding

Replaces the object hiding hotkeys with hotkeys to disable objects instead and adds these options to the Object ‣ Show/Hide menu.

Disabling objects prevents them from being shown again when a collection’s exclude checkbox is toggled off and on, and so will preserve the object’s visibility when switching QCD slots.

QCD

Enable the QCD system.

QCD Hotkeys

Enable 3D Viewport hotkeys in Object Mode.

QCD Edit Mode Hotkeys

Enable 3D Viewport hotkeys in Edit Mode.

QCD Move Widget:
Tool Theme Overrides

Enable overrides in this section to change the color of individual elements in the QCD Move Widget (colors default to the current theme).

Icon Alpha

Opacity of the icons for selected (but not active) objects and unselected objects.

Note

The values for icon alpha are not overrides and always affect the QCD Move Widget.

Known Issues

  • Linked collections are not supported.

  • Two QCD slots can swap collections if the collections are under the same parent and you rename one collection with the name of the other, then undo the rename and redo the rename.

Glossary

General
Chaining

Dependent on parents for whether an RTO can be active.

LMB

Left Mouse Button.

QCD

Quick Content Display.

QVT

Quick View Toggles.

RTO

Restriction Toggle Option.

RTO Short Forms
EC

Exclude Checkbox. (Excludes the collection from the current view layer – affects both 3D Viewport and render – non-chaining.)

SS

Selectability. (Disables selection for the collection in all view layers – affects 3D Viewport – chaining.)

VV

Visibility. (Hides the collection from the current view layer – affects 3D Viewport – chaining.)

DV

Disable Viewports. (Disables the collection in all view layers – affects 3D Viewport – chaining.)

RR

Renderability. (Disables the collection from being rendered in all view layers – affects render – chaining.)

HH

Holdout. (Masks out the collection from the view layer – affects render – non-chaining.)

IO

Indirect Only. (Makes the collection only contribute indirectly (shadows/reflections) to the render for the current view layer – affects render – non-chaining – Cycles only.)

Reference

Category

Interface

Description

Collection management system.

Location

3D Viewport

File

object_collection_manager folder

Author

Imaginer (Ryan Inch)

Maintainer

Imaginer

License

GPL

Support Level

Community

Note

This add-on is bundled with Blender.