wiki

Wiki Last Updated: Oct 24th 2021


What is keKit?


  • keKit is a Blender Add-on that provides extensive options for tweaking fast custom workflows.
  • The add-on contains dozens & dozens of scripts; tools, macros and pie-menus etc. in an all-in-one collection.
  • At your discretion: Use what you want - the rest will be there when you need them! 



How do I use it?


Download & Install

Check the download page for download & installation instructions

That page also contains the latest release log, for the most up to date changes.


Manage your own Hotkeys

As many of the scripts are often intended to replace default hotkeys, there is no hotkey map.

Such solutions are common with other (more special purpose) add-ons, but this is not feasible for a general hotkey map (there's a LOT of scripts): You assign whichever operator you like yourself.


As of v1.456, there is also keKit Shortcut managment tools in keKit Add-on Preferences.


Exception:

The Shading Pie Menu has a custom class operator with a preset hotkey (for you to change).


Tips:

  • Some features require mouse position or other viewport action, so I recommend assigning a temporary (unused) hotkey for features you want to try out first.
  • Mouse-hover over each script in the kit in Blender for tool-tip description pop-ups.
  • Right Mouse Button Menu to set hotkeys on kit panel items.



Search Wiki

Just browser search (CTRL-F) on this page to find specific items.

FEATURES

Add-on Preferences


Save keKit Settings

Saves current kit settings to a JSON file in your user folder /scripts (as shown below). Global, persistent and easily transferrable. Will also export keKit keymapping.

Also available in the main panel.


Export / Import Keymapping
Export all the shortcuts assigned for keKit Operators and Pie Menus to a separate JSON file. Import makes sure all properties are set correctly (as Exported).


  • Import will disable (not remove) conflicting shortcuts (*same category only*) and report on all changes (in the console window)

  • Note: Some categories will override others. (Screen vs View3d vs Object etc.) keKit Import will not cross-check all those combinations.

  • Note: Some shortcuts may use "Any" modifier by default. You may want to be aware of this for new installations.


Keymap Location
This is the default Export/Import location: Your local user folder /scripts. Cannot be changed. Text field is intended for clipboard copy-paste.


Assigned Shortcuts
All the currently assigned keKit Operator & Pie Menu shortcuts will be listed here.


Viewport TT-Toggle Icons
Visibility for TT Toggle Mode icons in the viewport. Also available in the keKit panel / Context Tools / TT-Toggle.


kekit Modal Text Colors 

Colors on keKit modal operator UI text. Example: IMAGE

Main Panel


Preferences

Saves current kit settings to a JSON file in your user folder /scripts (as shown in keKit Addon Prefs). Global, persistent and easily transferrable. 


Remember to always save the kit prefs if you want them to be the "default".


This will also export any keKit shortcuts assigned. See Add-on preferences for details on shortcut managment and other settings.



Update Notification


This icon will be displayed when a new version of keKit is available for download. Click the icon for a link to the update page. Update manually as instructed. 


Note: The check is performed at Blender Start-up


Direct Mode Switching

Direct Mode Switch - Go directly to Vertex, Edge, Face or Object mode, regardless if currently in Edit or Object Mode.

(Hotkey ex: 1,2,3,4)


Mouse Over Option - For DMS; Select & switch to desired mode on any mesh you hover the mouse over.


Space Toggle - Switches Edit & Object Mode when the mouse is over nothing (empty viewport area).  


Copy & Paste Ops

Cut+, Copy+ and Paste+ will temporarily store elements so you can quickly cut+/copy+ them into another mesh in Edit Mode with paste+ (or the same mesh if you like). 

VIDEO

Update:

- Now works in Object Mode, either merging the cache or pasting into new mesh (toggle button sets behaviour).

- If you copy an object in object mode; blenders "copy object" will be used, as well as "paste object" if the copy+ cache is empty.


Extract&Edit, Copy&Extract&Edit - Cut/copy elements into a new Object set in Edit Mode.


Itemize, DupeItemize - Cut/copy elements into a new Object using the Active Face or Active Edge for rotation (as new bottom). VIDEO


Get & Set Ops

Get & Set Edit Mode - Selects object under the mouse pointer and switches selection to Edit Mode. VIDEO

  •  "Extend" variant will extend the selection (multi-object editing)
  • "Element Mode Pick" toggle will set the edit mode to the type of element directly under the mouse (vert, edge or face)


Get & Set Material - Grabs material from any object's face under the mouse pointer and applies it to the current selection. VIDEO

Render Visible

Render Image of only what is currently visible in the viewport - Regardless of outliner object render toggles.


Optional: Toggle for using Slot Cycling.


(Temporarily sets render-toggles & uses a modal-timer hack to enable visible render progress.)

Render Image Slot Cycle

Render Image to the first empty render slot (supports any nr of slots*).

Wrap toggle off:No overwrites, you will be notified when all slots are full.

Toggle on: Start step cycle over existing starting from slot 1.


* Tip: You can add extra slots in the render window + save startup scene as default (Set Slot 1 as active!)



BG Sync

Sync the Viewport Preview shading EXR to world render

(incl. built in EXR's) with rotation and strength values.

It will file/node-manage for you, and reuse when possible. Like this


It is also available in the extended shading pie.

Quick Measure

Contextual Measurement Tool by type of selection. VIDEO


Vertex - Two modes: BBox dimensions of selection or                          Distance between 2 verts. Update: You can now                    select any number of verts to calc distance                            between (shift select not needed). Clear if garbage                data is cached. Video.

Edge -    Each Edge's length and combined length.

Face -    BBox dimensions of selection.


XY Area: Displayed in BBox dimension modes.

Round Snap: Built in snapping feature.

Freeze Mode: Stores selection for partial changes to whole.


QM FreezeMode - QM starts in freeze mode. VIDEO

Bookmarks

Cursor Bookmarks

Store Cursor - Saves Cursor Loc & Rot into slot.

Use Cursor - Uses stored Cursor Loc & Rot from slot.


Default/Blank Slot is the reset Cursor position (0 loc, 0 rot)


To Clear Slot: Assign reset Cursor position.

View Bookmarks

Store View - Saves current View transform into slot.

Use View- Uses stored View transform from slot.


Get View- Grabs current View transform (to input slot)

View Input - Copy/Paste View data. Mail your coworker.

Set View- Applies View transform (from input slot)


To Clear slot:

Use stored view, dont move view, store in same slot.


Added - Cycle View Bookmarks. As the name suggests.

Snapping Combos

Bookmarks the current snapping settings to store in 4 slots. Hotkey the stored slots (1-4) or use the snapping pie menu.

  • The combo tools are located in the regular snapping menu (not the kit panel)
  • The Snapping Combos can be renamed (for the pie menu) in the Bookmarks panel.



Orientation & Pivot Combos


Set up 4 combo-operators that will set Orientation & Pivot to your most commonly used combinations.


O & P Operator (Assign Hotkey and/or use in pie menu)

Set Orientation & Pivot for OPC1 Object Mode.

Set Orientation & Pivot for OPC1 Edit Mode.


Update: You can now rename the Combos (for the pie menu)



Select & Align Panel

Cursor Fit & Align

Edit Mode :

  • Snap Cursor to selected elements and orient it to FACE/VERT/EDGE selection for cursor rotation/location.
  • No selection = Cursor reset


Object Mode:

  • Pointing over ANY object will just align the cursor to the face under the mouse, regardless of selections.
  • 1 Object selected and pointing mouse over NOTHING will align cursor to the selected objects location & rotation.
  • 2+ Objects selected and pointing mouse over NOTHING will align the cursor rotation/location to the vector (using Z) between two objects. Note: No selection order beyond 2.
  • No object selected and mouse is over nothing resets Cursor.


Option : O&P Toggle - Sets Orientation & Pivot to Cursor.


(Release) VIDEO


Also availabe in pie menu.


Note: This is meant to supplement to standard cursor placement tool (which has snap-drag for offset, for example), not a complete replacement.

Clear Cursor Rotation

Clears the cursor's Rotation. Also found in keSnapAlign pie menu.

Quick Origin Move

Run grab tool for selected objects origin (in modal) to avoid having to set "Affect origin only" on and off.


- Auto Axis Variant : Will use Mouse Axis instead of default.

Align Object(s)

Align selected Object(s) Location/Rotation to:

- Cursor  (Cursor Fit & Align recommended)

- Active Object

- Origin (Selected to Origin)

  • As "Geometry to Origin" but also works in Edit Mode for element selection.
  • Will work with multiple selected objects (In Edit Mode too); Each object will use its own origin.
  • Find In keSnapAlign pie-menu or Select & Align keKit panel.

  • Object Mode uses "Set Origin" - so all the other modes are available in the redo panel : 

  • Origin to Geo, Origin to Cursor, Origin to Center Mass (Surface & Volume) 


(old)

VIDEO

Align Origin(s)

Align selected objects' origin Location/Rotation to:

- Cursor (Edit & Object Mode)

- Selection: Selected element normal (Edit Mode)

- Sel.Loc: Selection Location average (Edit & Object Mode)

Align View

Align the viewport to:


- Cursor : Orthographic. Toggle (Run again to restore view)

  (Cursor Fit & Align recommended for correct rotation)


- Selected : (Active) Orthographic. Toggle (Run again to restore view)

  ("Align View To Active" SHIFT-NUM7 replacement)  


- Ortho Snap : Snaps view to nearest Ortho View. No toggle.

  (Just rotate view off ortho)


Swap Places

Swap places (transforms) for two objects. loc, rot & scale. (Apply scale first if you dont want to swap scales.)


Straighten

Snap an objects rotation to the nearest 90 degree angles. Or custom degree override in the redo panel. (Also available in the Step Rotate Pie Menu)


Select Boundary+

Select Boundary ('region_to_loop') op that also sets one edge to Active. (Handy for scripts that need an Active edge.)


Inner Region Toggle: When you have a boundary selected, you can run again to toggle between region & boundary) 


VIDEO


Lock, Lock Unselected & Unlock 

Easy acces to assign shortcut(s) for locking (Same as "Disable Selection" in the Outliner).  Unlock (Selection Enable) applies to all locked objects. 


Unhide or Local Off 

Unhide hidden objects, or set Local Mode off - if currently in Local mode.


Select Inverted Linked

Inverts Edit Mode element selection - only on connected / linked mesh geo.


Mouse Side of Active

Like vanilla Side of Active, but with active vert, edge or face and mouse position to calculate which side of the active element to select


Quick VIDEO demo.

Modeling Panel

Merge To Mouse

Vert & Face Mode: Merge selected vertices to the selected (or edgelinked) vert closest to the Mouse Pointer.  VIDEO


Edge Mode: Collapse selected edges to edge(s) closest to the Mouse Pointer. VIDEO


Flat/Smooth Shading Toggle

Toggle for selected object(s) in Object or Edit mode. 

Triangulate Modifier Toggle Option: Used for more accurate shading.



Ground or Center

Ground or Center selected elements or objects. Select process in redo panel ->


Options:

Custom Z: Set custom Z-pos as ground.

Raycast: Stops on collision down the Z axis. VIDEO 

Unbevel

Removes beveled corners on meshes on non-continous edge loop(s). Start and end edges will determine the angle.

VIDEO

ZeroScale

Scales selection to zero (flatten on Z axis) using the cursor for location and rotation (Cursor Fit & Align recommended) IMAGE


Other ZeroScale variants are available in the pie menu.


Direct Loop Cut

Insert an edge loop on an edge at the mouse pointer. No selection needed (autoselects, with exceptions)  VIDEO


Slide:

Uses built-in Edge Slide afterwards


Center Cuts:

With edge(s) selected & with the mouse over nothing or another object, a center-cut will performed


Multi-Cuts:

Center Cuts, as above, on all selected edges' edge rings.


Lmit Faces:

Selected faces (on the edge ring) will limit the cut to those faces. Point the mouse over intended starting edge (or near it in space for mid-cut).  Note: This works on "checker-selected" faces too.


It also works on Loose Edges (select and point, or multi-cut as above)

BBox & Convex Hull

BBox: Generate mesh for the selection's Bounding Box.

Convex Hull: Generate a convex hull mesh for the selection.


- Supports Instance Collections

- Reference Style Shading viewport shading option. (Wire & not render)


VIDEO 


Fit 2 Grid

Snap each vert in selection to nearest grid position.

Define grid spacing to use


Fit2Grid pie menus are available with preset grid sizes.

Linear Array

Creates an array modifier in a line where instances are spaced automatically between start and end (where you point the mouse).

When used in Local Orientation the object rotation will be used. Global (or any other orientation) will apply rotation.

Update: Numerical input & adjustment (re-run on existing)

VIDEO


Radial Array

This is my circular array solution for Blender. There are many like it, but this one is mine.

(old) VIDEO


Panel toggle : Use Automatic arrange (as the video), or not.

UPD: Adjustment mode toggles (not modifier keys):

  • X - Adjust radius 
  • Z - Adjust depth
  • S - Adjust scale
  • A - Numerical Input (for array count) 

 1,2,3,4,5 -(XZS) adjustment level - very fine -> large.


Numerical input mode works simultaneously with XZS.

Unrotator

Unrotates geo using active element as new 'bottom'

OR

Places selection to face normal/position on other mesh or object under mouse pointer (if different geo than selected)


Object Mode: Resets rotation or places on mouse over.

Update: Uses modal to temporarily use object face snap in object mode. LMB to place, RMB to cancel. Snap settings will be restored.

(bonus: ESC will place the object in center of the face first under the mouse)


Note: Rotation tweak (redo-panel) will not work if you move the viewport camera, and is not available after modal.


VIDEO

FitPrim

Creates (unit or unit+height) box or cylinder primitive based on element selection. (or face under mouse in Object Mode)

Vert Mode:  Fits *along* 2 Selected verts.

Edge Mode: Fits *inbetween* selection/s.

Face Mode:  Fits *on* selection/s."

VIDEO1, VIDEO2


Update:

- Numerical input for cylinder modal mode

- Plane Primitive is also available. VIDEO


Hotkey for fast operation, and/or use FitPrim Pie Menu


MouseFlip

Flip(resize) selection based on mouse position for direction,

and Orientation type selected. (recalculated)


Global: Flip using world origo


Local: Edit Mode: BBox mode global axis.

Object mode: BBox local mode, rotation w. Ind.Origins. Any other; not.


Normal: Edit Mode - Only takes the Active Element into account for rotation/center and auto-selects connected mesh.


Cursor: Uses the cursor for center, and rotation if Pivot is also set to CURSOR, otherwise cursor rotation is ignored. 

MouseMirror

Mirror selection based on mouse position (for direction)

and Orientation type selected. (recalculated)


Global: Mirror using world origo


Local: Edit Mode: BBox mode global axis.

Object mode: BBox local mode, rotation w. Ind.Origins. Any other; not.


Normal: Edit Mode - Only takes the Active Element into account for rotation/center and auto-selects connected mesh.


Cursor: Uses the cursor for center, and rotation if Pivot is also set to CURSOR, otherwise cursor rotation is ignored. 

Quick Scale

Set dimension (in current scene unit). Unit sized from chosen axis. Obj & Edit mode (selection)


E.g: Selected model needs to be exactly 1.835m on Z. Enter into length and hit Z (with unit size option on to avoid stretch).

Subd Tools


Subd Toggle

Toggle (modifier visibility) or Assign subd modifier if none exists, using the options. (To set up your subds exactly how you like them)


Set VP Level

Set viewport subd level on selected Object(s)


Set Render Level

Set render subd level on selected Object(s)


Step Viewport Level +/-

Set render subd level on selected Object(s) one step


MultiCut

Double-cut edge rings with optional middle cut. (Like Loop Cut combined with Offset Edge Slide for the ends) VIDEO


User customizable presets to use in the panel, as hotkeys or in the MultiCut Pie Menu.


The Presets will be named automatically based on the values (see screenshot -> )

or, use the "Manual Rename" button to name manually.


You can use relative (%) or fixed offset (in real measurements, like cm etc.) The one value will be used on both ends of the edge.


Note: Saving presets with fixed offset NOT zero will be saved as a fixed offset preset (Dont forget to save keKit prefs)

ID Materials Panel

ID Materials

Applies ID Material to Object(s) / Faces. Common baking utility. Notes: IMAGE


  • Applies automatic Alpha Blend (& no shadows) setting when using transparency - for not-baking use cases (retopo etc.)


Also available in materials pie menu

Cleaning Tools Panel

Macro Mesh Clean

All the important cleaning operations in one click.

Customize options ->
Note: Edit or Object mode (also multiple objects)


IMAGE

Purge Tools

Purge specific unused data blocks - or All

Cleaning Selection Tools

Select collinear verts (Edit Mode)

Select geo by vert count in selected Object(s) in Edit or Object Mode. (Note: Ngons are 5+)


Context Tools Panel

TT Toggle

Transform Tools Toggles (the 3 icons) will set in which way the transform tools are launched: Default ("Grab" with or without handles) , Mouse Axis or ViewPlane Contextual.


TT Move, TT Rotate and TT Scale can then replace each standard transform tool hotkey. 


TT Duplicate: Launches duplicate as per TT Mode.

TT Linked Global Toggle:  Will make linked duplicates.

This will also affect Mouse Axis Dupe and VP Dupe.


The TT Mode (+Linked Global Toggle) can be also be set with viewport icons (but intended for shortcut assignment, with the icons just identifying the current mode) or with TT Mode CycleVIDEO


Note: Preferred scene default can be set by saving kekit prefs


To hide the viewport icons, check the "Hide" checkbox.

(Also available in keKit Add-on Preferences)


Mouse Axis Move / Rotate / Scale / Dupe

Runs Grab, Rotate or Resize with Axis auto-locked based on your mouse movement using recalculated orientation based on the selected Orientation type (except Gimbal). (recalculated)


Recalculated: Not the "current" Orientation, as it is not exposed and must be recalculated; If you set Normal Orientation from a face in Edit Mode and go back to Object Mode it will result in Local being used, for example. Only "fresh" orientations will behave as expected.


Dupe: Duplicates selection first. Intended for "drag to copy" operation. For example, hotkey assigned like THIS.


Move Cursor: Moves the cursor with Mouse Axis.


ViewPlane Contextual

Runs

▢ Grab Rotate or Resize with View Planes auto-locked based on your viewport rotation. VIDEO


VDupeMove - duplicates selection before running Grab.


Options:

Auto Global: Will always set Global transform.

Note: Overrides Global or Tool.


Global or Tool, runs

▢ Grab Rotate or Resize in auto locked view plane (like VPGrab etc.) when in Global transform - otherwise launches default transform tool. IMAGE



View Align Snap Contextual

View Align Selected Toggle if anything is selected - Otherwise just snaps the view to closest ortho (View Align Ortho Snap). 


Context Bevel

Launches appropriate bevel tool by selection mode:

VERTS: Vertex bevel Tool

EDGES: Edge bevel

FACES: Inset. Has Ctrl-drag to extrude (effectively "Extrude Faces Along Normal" Tool)


Korean / Flat Bevels Toggle:

Global toggle for Korean (aka Flat Bevels) or regular.

Context Extrude

Launches appropriate extrude tool by selection mode:

VERTS: Vertex Extrude

EDGES: Edge Extrude

FACES: Face Extrude Normal (Region)


Update: Toggle for TT Toggle support for transform start mode.

Context Delete

Deletes elements by type by selection mode.

(VERTS, EDGES or FACES)


Update: Toggle for hierarchy delete in Object mode.

Context Dissolve

Dissolves elements by type by selection mode.

(VERTS, EDGES or FACES)


Context Select

Performs different selection by selection mode:

EDGES: Loop select 

POLYS: Linked select

VERTS: Select Border Edges on mesh, or Linked Select if no borders.

Intended for Double-click LMB: Assign dbl-click in preferences / hotkeys


Bridge or Fill

Bridge, except when ONE continous border edge-loop is selected: Grid Fill.
F2 mode: 1 EDGE or 1 VERT selected
Face Add Mode: with two edges (sharing a vert) or 3+ verts in vert mode.

Maya Connect

  • Vert Mode selection: Connect Verts
  • Edge Mode: Subdivide
  • Face Mode: Splits along selection (single face uses mouse pos for direction)
  • Selection of resulting edge(s) (all modes)


    VIDEO

Triple Connect Spin

Vert Mode selection:  Connect Verts (smart path or pair)

Edge Mode selection: Spin Edges

Face Mode selection:  Triangulate


Frame All or Selected

Frame selection in View, or everything if nothing is selected


Geo Only Toggle

With nothing selected, will ignore non-geo objects (Lights, Cameras etc).

Context Slide

Alternative one-click option for double-G slide.

(Vert Slide in vertex mode, Edge slide in edge mode)

Pie Menu Panel

ke Pie Menus

Custom Pie Menus that either expands (and replaces) the default Blender counterparts, or tool-specific pie menus.

(old) VIDEO


Tip: If you are still using the default blender theme; IMAGE.


Blender Default Pie Menus

Mainly to contrast & compare and hotkey reference.


[ Click pie menu thumbs below for zoom. May not be latest. ]

keSnapping

Snapping layout using built in snapping tools with an options panel +

Element Mix Combo: Verts, Edge, Edge Midpoints & Face snapping.

Update: Now expanded with complete snapping settings &

Snapping Combos.

keFit2Grid

1cm to 1m preset values for Fit 2 Grid

keFit2Grid Micro

1micrometer to 1cm preset values for Fit 2 Grid

keOrientPivot

Orientation & Pivot panels + OPC combo slot 1-4

keShading

Shading pie replacement with extra options for quick access.


Note: Custom category operator, has a preset hotkey (CTRL-SHIFT-ALT-0), for you to change (RMB to assign something more useful)

keOverlays

Viewport shading pie for quick access.


All Edge Overays: Toggles the 4 edge shading modes at once. 

All Overlays: Toggles all overlay options on or off.

Fous/Super Focus Mode: Toggles all overlays and UI on or off.


(old) VIDEO

keSnapAlign

Snap/Align menu replacement with more functionality.


+ Cursor Fit & Align

+ Align Origin to Selected / Cursor

+ Aign Object to Active / Cursor

+ Swap Places


+ Zero Scale V / H / Normal / Cursor:

Scales selected elements to axis nearest screen vertical or horizontal. Normal: Using active element as basis. Or cursor.

VIDEO


keFitPrim

Pie Menu for FitPrim operator



Fit-Prim Add Pie Menu

Fit prim (FitPrim operator) pie menu variant. FitPrims on the left, "Add Menu" on the righ.


Tip: If you are still using the default blender theme; IMAGE.

keMaterials

Menu for ID Materials combined with Material Utils menu (if you have the Material Utils add-on enabled)


Update: Direct display of existing materials with automatic column sorting for large amounts of materials. IMAGE

Tip: Display cap can be set in Material Utils add-on prefs.

View & Cursor Bookmarks

Pie menu access for View & Cursor Bookmarks.


keStepRotate

Preset step rotations for selected object(s) in 45, 90 and 180 degrees based on viewport rotation. (World/Global only)


Also features "Clear Rotation" and "Straighten".

- Added Clear button for each axis

- Added mini standardrotation box

MultiCut

Pie menu access for MultiCut presets.


keSubd

(WIP)

Basic Subd-Worklflow Pie Menu.