Repository files navigation

This repository contains a library of Parts to be used in FreeCAD. It is maintained by the communityof users of FreeCAD and is not part of the FreeCAD project, although it is made with the aim to beused as a repository of parts by FreeCAD in the future.

If you made some interesting objects with FreeCAD, why not share them here? Others might find themuseful. The procedure is simple:

1. Create a github account for yourself
2. Fork this repository using the "Fork" button on the top right corner of this page
3. Follow thegithub instructions to clone your fork on your computer
4. Make all the changes you need, create more folders if necessary, and place your files in them
5. Upload (push) your changes to your fork on github (refer to the github help for instructions)
6. When your fork has been updated, you can submit apull request to have your changes merged into the official library. A member of the community will review your proposed additions and accept the merge.

Each Part should be correctly named, and placed into subdirectories by family or type. They should alsobe available in both .FcStd and .stp formats, and optionally in .stl format (because github lets youvisualize them). They should also be as simple as possible, and parametricso users can easily change their dimensions. In the file properties of each .FcStd file, the authorshould also be mentioned, and the license information if available.

Note: Please DO NOT use accented characters in your file names, thanks!!!

If you are interested in contributing to this library on a more long-term basis, please ask for writeaccess to this repository on this FreeCAD forum thread:http://forum.freecadweb.org/viewtopic.php?f=19&t=4205

All Parts in this repository are licensed under CC-BY 3.0http://creativecommons.org/licenses/by/3.0/Each Part is copyrighted by and should be attributed to its respective author(s).See commit details to find the authors of each Part.

If you are uploading parts to this repository, please make sure you are the author of the model,or otherwise that you have right to share it here under the CC-BY 3.0 license, and make sure the authoris mentioned in the commit message.

As the library is part of theFreeCAD addons, the easiest wayto install and keep the library updated is through the addons installer, where you will find it thereunder the name 'parts_library'.

Warning: the library is huge in size (+/- 5 Gb) and therefore might take a very long time to download

There are currently two workarounds to this problem:

1. You can download and install this library manually by following these steps:

• In FreeCAD, find which is your usermodules folder by entering or pastingApp.getUserAppDataDir()+"Mod" and your usrmacros folder by enteringApp.getUserMacroDir() in the Python console (found under menu View->Panels)
• Download the library as a zip file using the green "clone or download" button in the top right corner of this page
• Unzip the zip file you just downloaded. You will get a "FreeCAD-library" folder
• Rename that folder from "FreeCAD-library" to "parts_library"
• Move that renamed folder to themodules folder location that we got above
• Inside the FreeCAD-library folder, you will find a PartsLibrary.FCMacro file. Copy that file to themacros folder that we got above
• Restart FreeCAD. The parts library will be installed, and the addons manager will recognize it as installed. You can launch and use the library by executing the PartsLibrary macro from menu Macro -> Macros...

2. TheBIM addon has aLibrary tool that features an experimental "online" option. With that option enabled, the BIM Library tool is able to access and use this library online, without the need to install it.

The library is a simple container for FreeCAD (.fcstd) and STEP (.stp) files. You can download itanywhere and import its files in your FreeCAD projects. Inside the library, there is a FreeCADmacro (PartsLibrary.FCMacro) that you can place in your FreeCAD macros folder. That macro createsa browser window inside FreeCAD, from which you can easily add the parts by double-clicking them.

1. Make sure FreeCAD was restarted after installing the PartsLibrary addon
2. Launch the execute macro window (Macro menu => macros...)
3. Execute the PartsLibrary.FCMacro
4. If the macro asks for the folder for the Parts Library point it in to the right folder (under Windows11 it should be under C:\Users%username%\AppData\Roaming\FreeCAD\Mod\parts_library or %appdata%\FreeCAD\Mod\parts_library)
5. The parts library should open on the right side, double click on a part to add it to your current model

The macro also allows a couple of other possibilities, such as adding new objects, andsharing your objects with others. To share, you will need the python-git packageinstalled on your computer, and an online git repository you have permission to write to. Theeasiest way to obtain that is using the "fork" button on top of this github page.

Once you have made your fork, you will get an URL from it, that you can use in the macro'sconfig dialog. After that, once you have saved your models to the library, you can push them toyour online git repository, and, if you wish, make a pull request on this page to see yourmodels integrated to the official library.