Cleans up and optimizes your SketchUp model.


  • Fixes duplicate component definition names ( When in model scope )
  • Purge unused items
  • Erase hidden geometry
  • Erase duplicate faces
  • Erase lonely edges ( Except edges on cut plane )
  • Remove edge material
  • Repair split edges
  • Smooth & soft edges
  • Put edges and faces to Layer0
  • Merge identical materials
  • Merge connected co-planar faces

Menus & Toolbars

  • Plugins » CleanUp


  • TT_Lib² — 2.10.0

Related Links

  • SketchUcation Forum Thread
  • BitBucket Repository


I'd be happy if you donate a cookie (or a beer) if you find my plugins useful.


ThomThom's picture


I created an issue for this:
Can you add a comment there with exactly what version of SU14 you have? The full version number from the About dialog?

Ricardo A.'s picture


Hi! I've used this wonderful plugin successfully on previous versions of Sketchup but have problems installing it for Sketchup 2017 (all other plugins I usually use work and install fine.) Has anyone had a problem installing and using this plugin for Sketchup 2017?

I have installed Cleanup3 on my 17.2 Mac version of SketchUp. Installation went fine. Extension appears as enabled in Extension manager, but the app doesn't appear in the extension menu, nor anywhere else. Has anyone experienced this problem?

ThomThom's picture

Did you also install TT_Lib2? And did you restart SketchUp?

ThomThom's picture

Hi Anna

Can you elaborate on that isn't working? (Do you get any error messages etc) What are the steps you are doing and what is happening?

(Btw, these types of questions are often easier to follow up in the forums. If you start a thread there and mention my username "@thomthom" then I'll get notified.)


Hola Tom! A mi realmente me pasa lo mismo instalo el pluggin en sketch up pro 2016 y no se me activa el mismo! A pesar de activar la otra extension de tt lib 2! Porque podria ser esto?

I just tried Cleanup on my very large model. It had 8.7m edges and just over 4m faces. With Cleanup it only reduced by <5% to 8.5m edges and 3.99 faces. Is there a safe way to increase this?
Before I do that, it seems I have to do something to fix the following errors? Ignore Normals are already unchecked, but how do I scale up the geometry 10 or 100 times (or at all)?
My 100-story building may eventually reach 4-6GB. It is 200MB now.

10 errors occurred.

10 of these errors was face merging errors. This is typically due to small faces/edges.

Please undo and scale up the geometry 10 or 100 times and try CleanUp again.

You can also try to disable Ignore Normals.

you should use cleanup on not the whole model, but on parts of the model which have a lot of polygons. Say a couch or a tree. If you can select each part of the model and lower the size piece by piece, you can get nice results.

Artisan S.'s picture


I know that this problem has come up before, but I was wondering if you have found a definitive solution. I have SketchupPro 17.1.174 (64b) installed, the latest TT_Lib, and have installed, uninstalled, and reinstalled CleanUp3 several times. My issue is that when I open the CleanUp window, the window is completely blank. No options at all. The only thing I can do is use Clean with Last Settings, and that always wipes out all of my individual edges. Please help! Thanks!

ThomThom's picture

Can you start a thread on the SketchUp forums, and tag me (mention my username "thomthom" using an @ in front; "@thomthom")

It's easier to follow up with questions like this in the forum as it's possible to share images and files there.


Artisan S.'s picture

Changed the %SCRIPT% lines in window.html as follows:






Artisan S.'s picture

Ruby Console shows nothing... CleanUp3 Window shows:

file:///ARTISAN-SERVER/fileshare/UserFolders/dpennington/AppData/Roaming/SketchUp/SketchUp 2017/SketchUp/Plugins/TT_Lib2/webdialog/js/inputbox.js file:///ARTISAN-SERVER/fileshare/UserFolders/dpennington/AppData/Roaming/SketchUp/SketchUp 2017/SketchUp/Plugins/TT_Lib2/webdialog/js/inputbox.js

When I run it.

I am on a Windows 7 computer connected to a 2008r2 server using folder redirection and roaming profiles.

Artisan S.'s picture

Also tried replacing %SCRIPTS% with

Jo W.'s picture

This tool is the BOMB.

I've used ThomThom's plugins before, and this is EXQUISITE. Simple, stupid problems begin to popup with coplaner faces, and then my model is doomed -- or it USED TO BE! Now, I can select the area, merge the coplaner faces that Sketchup would magically insert, clean up the edges -- and I got back to having beautiful, solid polygons.

Are you... are you a wizard?

Cameron T's picture

I feel that this plugin isn't finished. There is something wrong with the purging process, because whenever I try to clean the model, it SketchUp doesn't respond, and for hours on end, too. Some models are easily purge-able, but there are some weird components/groups that don't seem to want to be purged, and then cause SketchUp to be "unresponsive". What can I do to keep this from happening, and what can I do to speed purging time up??

ThomThom's picture

Large models will take longer to process. And some options will make the process longer because it require more computation. The one option I do warn about (and it's seen in the tooltip of the option) is the Remove Duplicate Faces. Keep that unchecked until you know you have a problem with overlapping duplicate faces - because this one really slows things things.

Other than that - the more geometry the slower it will be.

Cameron T's picture

Before this plugin, I actually had to manually clean the models, and that was a pain in the @**, but now, cleaning a model has never been easier, and what was surprising was that the models that I already cleaned had hundreds of thousands of other entities that I had completely overlooked. Thanks!

seeley's picture

Hi ThomThom
I have high hopes for this plugin... as I often use models imported from other platforms with way too much info... I'm currently working on a model I inherited from a client with over 5 million entities!!! Doing anything in sketchup is crazy cumbersome because it's bogged. I'd love a way to "shell tool" it because there is tons of internal geometry I don't want... AND it is built mostly from 6 sided bricks that give a double thickness and tons of coplanar redundant faces when stacked together. Shell tool, per usual, seems to do nothing. I found you a couple of days ago, and tried it on a part of the model, and it did delete some of the internal geometry, though not all, and ran for a couple of hours even though it seemed to think it would take much longer. I'm now 36 hours in to using Cleanup3 on the entire model, and it says there are 12,000 hours left, and it is .3 percent through with duplicate face removal. I'm on a 12 core mac pro w 64gb memory and the stock vid card.

If I cancel... will it leave the deleted entities deleted, or go back to the state where I began? Thanks

seeley's picture

yes on duplicate faces.... thinking that might be a large percentage of my 5 million entities... but can't invest 12,000 hours in my work flow... ;-)
Not talking about force-quitting the process, but hitting the "cancel" button within the Cleanup3 interface... Does that put you back to square one, or keep any deletions to date?


ThomThom's picture

Once CleanUp start it cannot be cancelled I'm afraid. The API have no facility to this.

The duplicate face feature doesn't check for faces overlapping across instances. Only within each group/instance - which should be rare occurrences as SU doesn't really allow duplicates like that.

seeley's picture

OK... I'll kill it and try without the faces box checked.
it was only only 37 hours of "virtual" work that will be lost... ;-)
I'll let you know if there is a significant reduction in file size with only "erase hidden geometries" checked. Essentially, I have a volume within which there is lots of geometry... Will Cleanup remove that geometry if the volume has no "holes?"

seeley's picture

So I force quit, and ran Cleanup3 to only erase hidden geometries... and it completed in 18 seconds... and didn't reduce my 365mb file at all, or delete the interior geometries I'd hoped it would. I must be misinterpreting what is meant by hidden geometries.

ThomThom's picture

Hidden Geometry is what is explicitly hidden by turning off the layer the geometry on, or using the Hide functionality. It's not in terms of what is visually seen from the camera's point of view.

ThomThom's picture

Ouch, 36 hours sounds much, even for 5M entities. Any chance you have duplicate faces checked in the options? (That is extremely slow - use only if you know you need it. For such a large one I'd omit it.)

If you kill SU to cancel what it's doing you will lose the changes its one.

Olá ThomThom.

Salvei a extensão em meu computador.
Em preferencias consegui instalar.
Mas, recebi uma mensagem, que diz: TT_Lib² não esta instalado, então o Sketchup sugere fazer o download de TT_lib² direto da warehouse, mas não consigo. Porque diz erro de autenticação.
Como posso resolver? Pode me ajudar, por favor?

Hello, ThomThom.

I saved the extension on my computer.
In preferences I was able to install.
But, I got a message that says: TT_Lib² is not installed, so Sketchup suggests downloading TT_lib² straight from the warehouse, but I can not. Because it says authentication error.
How can I solve? Can you help me please?


ThomThom's picture

"authentication error" would be an issue with Extension Warehouse. I don't know what causes that. I don't manage this website. I'd recommend contacting support to assist you in signing in to Extension Warehouse.

Hello ThomThom.

Okay I will try.


A hug.

Jamie S's picture

I updated TT_Lib_2.10.6_19-09-2016.rbz to TT_Lib_2.10.8_24-11-2016.rbz and when restart of SU I get the following errors;

Error Loading File C:/Program Files (x86)/SketchUp/SketchUp 2013/Plugins/TT_Lib2/core.rb
uninitialized constant TT::CExtensionManager::PLUGIN_ID
Error Loading File TT_Lib2.rb
uninitialized constant TT::CExtensionManager::PLUGIN_ID

Windows 10, Sketchup Pro 2013, please help.

ThomThom's picture

That's odd. That bug was introduced in 2.10.7. 2.10.8 was supposed to fix that.
Can you double check the version reported to be installed?
And you restarted after installing?

Jamie S's picture

Thom, yes I’ve restarted after install, have both performed install direct from extension warehouse and again from downloaded file using install extension in preferences. Also I was having bug splats when attempting to import a .obj with quad faced tool. Previously cleanup worked fine and I used it frequently.

Jamie S's picture

After twice trying the install of both latest TT_Lib_2.10.8_24-11-2016 and cleanup tt_cleanup-3.4.2, I just went back to previous versions of both (TT_Lib_2.10.6_19-09-2016 & tt_cleanup_v3.4.2 respectively) and now can clean SU files again. I was never able to import obj's with Quad faced tool and had always received a bugsplat when attempting to, so I'll leave that one alone. Thank you for the previous version of cleanup (tt_cleanup_v3.4.2), it works fine.

Windows 10, Sketchup Pro 2013.

ThomThom's picture

As for the QuadFace Tool issue, please report it here:

Jamie S's picture

Thank you Thom, Your latest TT Lib v11.25 fixed error issues at SU start up and clean up works fine. I still have the error however when selecting any obj import using quad faced tool and did submit an error report where directed.

ThomThom's picture

I just found what I think is the issue. It would only happen when the user don't have write access to Plugins folder, which can happen on SU2013 and older if the user don't have full admin access.

I just uploaded 2.10.9 - please download that version and see if that resolves your issue.

Hi, beautiful plugin.
what's the fastest way to do this Process? I mean, just the options that will give me a smaller file.. but not take much time.

I am working with a 1 GB impoted 3DS model... it's just a building shell. should be ideally much smaller file (we are not showing close up details).
I tried the pkugin... It purged in 20 minutes, but it says 3 hours for the next one.

Sketchup 2017 Make and Windows 7

ThomThom's picture

It's hard to tell exactly on a specific model without knowing too much about it. CleanUp have a lot of options, and ticking them all isn't always the "best" choice. For instance, the remove duplicate faces is off by default because it is VERY slow and only needed in some models where you know you have that problem.

And when it comes to reducing file size, there could be a number of causes of that. It could be due to lots and lots of geometry, but it could also be related to lots of really big textures.

CleanUp will in large part merge co-planar faces and co-linear edges. If your model is very organic there might not be that much to optimise.

I'd recommend that you create a thread on the SketchUp forums where you post some screenshots of your model to get some more specific response to the particular model you are working with. Also including a screenshots of the model statistics help, as filesize alone doesn't say much. But the number of edges, faces and instances describe the model much better.

Michael P.'s picture

I installed TT_Lib, and I'm getting a 'signature outdated' error.

ThomThom's picture

I haven't had time to re-sign everything for SU2017. Unless you are using Secure mode for your extension preferences it have no effect though.

I am unable to use TT Cleanup3 under Sketchup 2017. It's a very useful extension! Not only does it complain that the TTLib is out of date, but while it says that TT Cleanup was installed, I don't see it in any menus or anywhere.

Any help on this?

ThomThom's picture

Did you install TT_Lib?

Scott B's picture

Hi I love this app. I have just upgraded to SketchUp 2017 and the extension will not load. The message it says in the extension manager it says that the extension has an outdated signature. Is there a way that I can bypass that.

Thomas T.'s picture

I have to reupload the extension to have it signed with the new extension. With 50 extensions that's quite a bit of work - I'm hoping that the EW can bulk-resign extensions for SU2017.

However, unless you have Extension Security in Approve or Secure mode an out of date signature is of no significance.

Robert K's picture

Thomas, your plugin skills are paramount! Thank you for your effort!
Seems as though SU2017 will not permit TT_Lib² to install the 2.10.6 version, constantly throwing back the error "TT_Lib² 2.10.6 not installed"
regardless of extension security settings.

Thomas T.'s picture

TT_Lib 2.10.6 should work fine with SU2017. Not sure what might cause your troubles. I'd recommend you start a thread on the SketchUp forums - it's a lot easier to follow up to questions like this there as we can then share files and images.

Had up to 8M vertices showing in Unity stats window.

Run twice actually, just in case it would maybe optimize twice as much.

Have up to 8M vertices showing in Unity stats window.

Will give another try in case I missed something.

Christopher V.'s picture

Well, sounds like a great app- but when I run it, half of my model disappears (SU-pro-8). It seems to depend on what scene is active. If there are items in the scene that are turned off by layer- those hidden items and layer disappear....

ThomThom's picture

Hmm... hard to tell what might be going on there. Can you make a post on and share the model or some screenshots? (It's easier to follow up on the forums.)

Hey I got an error when I tried the merge faces tool on a test file using Sketchup 2015.

Here is the file and the error as a screenshot:

I was just curious if something like that would work. Don't know if you want to fix it.

ThomThom's picture

hm... don't think there is much I can do about that file. It has issues - SketchUp's own validation check yields errors for it: "Repeated edge (CEdge (2727)) removed from CLoop (2815)"

How was that mesh created? There's a lot of edges and faces there that should have been merged as they where created.