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).
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)
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)
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.
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.
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)
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)
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.
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."
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)
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 Cycle. VIDEO
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)
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 &
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.
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.
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
keSubd
(WIP)
Basic Subd-Worklflow Pie Menu.
© Copyright Kjell Emanuelsson
(Unless otherwise noted/fan projects)
Contact:
sendtonulldevice (at) gmail (dot) com
