README.md

diagrams.net Libraries

Create and share custom libraries:

1. Use the scratchpad or create a new library by clicking File, New Library
2. Once the library appears in the sidebar, you can drag and drop cells and images from the diagram or your harddrive
3. Supported image formats are PNG, JPG, SVG and GIF (including animated GIFs). If you are adding SVG files, you can make the colors of the SVG configurable using this method: https://desk.draw.io/support/solutions/articles/16000079239
4. When all elements have been added, click the pen icon, add titles to the entries and click Export
5. This will download the library file to your computer
6. To share it, the file must be uploaded to the web and made available via a public URL. One way to do this is to upload it to a public GitHub repository.
7. If you are using GitHub, use the RAW URL of the library which is of the form https://raw.githubusercontent.com/ORG/REPO/REF/PATH/FILENAME.xml, eg. https://raw.githubusercontent.com/jgraph/drawio-libs/master/libs/templates.xml
8. Once you have the URL of the library, you can share it by encoding the URL and adding it the clibs parameter. To encode the URL, paste it into the text box at https://jgraph.github.io/drawio-tools/tools/convert.html and click URL Encode. For our example, this will yield https%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Ftemplates.xml
9. Then add this to https://app.diagrams.net/?splash=0&clibs=U, eg. https://app.diagrams.net/?splash=0&clibs=Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Ftemplates.xml (where splash=0 bypasses the splash screen). Multiple libraries can be specified by separating them with semicolons. Each value must be prefixed with a U if it's a URL, eg. https://app.diagrams.net/?splash=0&clibs=Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Fun-ocha-icons-bluebox.xml;Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Fun-ocha-icons.xml
10. You can then share this link and clicking on it will open and install your custom libraries in draw.io

See also: https://desk.draw.io/support/solutions/articles/16000067790

General Libraries

• Templates: A sample library with basic building blocks for technical diagrams. The Comic template needs Humor Sans.
• UN-OCHA Icons: United Nations Office for the Coordination of Humanitarian Affairs (OCHA) Humanitarian Icons 2012.
• Genogram: A library with icons for genograms (also known as family diagrams).

Vector Libraries

Not compatible with Microsoft Internet Explorer 8 and below.

• Checkout & Delivery Icons: The icon set by EpicPxls contains 35 icons depicting various actions and entities for the common checkout process on an e-commerce site.
• OSA Icons: Open source free technical icons to create security architecture or other technical drawings Open Security Architecture/.
• Flat Color Icons: A set of colorful flat icons.
• Flat Business Icons: Modern UI style icons for your next web or mobile app project by Nucleo.
• Voyage Icons: 40 free icons to spice up your travel agency or the airline website by PrintExpress.
• Gesture and Fingerprints Icons: 100 useful gesture and fingerprints line icons by TheSquid.
• Material Design Icons: Material design icons are the official icon set from Google that are designed under the material design guidelines by Google.
• Chart Icons: A set of light color chart icons.
• Windows 10 Icons: A set of Windows 10 icons.
• Gnome Icons: Network icons scheme based on Gnome Gorilla's theme.
• Font Awesome: The iconic font and CSS toolkit Font Awesome.
• Arista Icons: A set of Arista networking icons.
• Commvault Icons: A set of Commvault networking icons.
• Fortinet Icons: A set of Fortinet networking icons.
• Integration Icons: A set of MS Integration icons.
• Kubernetes Icons: A set of Kubernetes icons. Obsolete, as there is currently an integrated set in the app.

Click on a link above to open a library or go to File, Open Library from URL in draw.io and enter an URL of the form https://jgraph.github.io/drawio-libs/libs/templates.xml