Mac

SVGuru

SVG Unify · Reduce · Use

What do you need help with?

Topics

Getting started

Read full article

SVGuru optimizes SVG artwork on your Mac. Unify · Reduce · Use: choose settings, compare the result and export a smaller file. The interface is available in English and German.

Open this built-in guide with Help → SVGuru Help. Choose a topic on the left or search the contents using the search field. Help is available offline and follows the app language.

Open SVG files

  1. Click Open SVG files, or choose File → Open SVG files… (⌘O).
  2. Select one or more .svg files. You can also drag them into the app window.
  3. Select a file in the Workspace sidebar. SVGuru calculates the optimized result automatically.

The app requires macOS 14 or later. It accepts UTF-8 SVG files up to 10 MiB (10,485,760 bytes) each. Decompress SVGZ files before opening them.

Try the included example

Click Try an example on the welcome screen, or choose Help → Open example. The included “Prisma.svg” artwork is added to the workspace. Try the presets and comparison view before working with your own files.

Enter or paste SVG code

Choose File → Enter SVG code… (⌘N) to open the input dialog. Paste complete SVG markup and add it to the workspace. Press ⌘V in the workspace or choose File → SVG from clipboard (⇧⌘V) to add valid SVG markup as Untitled.svg. Additional pasted SVGs are numbered. In text fields, ⌘V pastes text. Direct clipboard import is unavailable in the sprite assistant.

The code view shown after importing is for inspecting source code; it is not an SVG editor.

Workspace

Read full article

Keep several graphics in one list. Optimization settings apply to the entire workspace.

Select and remove files

Select a filename in the sidebar to view its result. Add files adds more SVGs without removing existing entries.

Choose Optimization → Remove file from list (⌘⌫) to remove the selected graphic from the workspace only. Its file on disk remains intact. The file list is not restored automatically after restarting the app, so export any results you need before quitting.

Automatic recalculation

Changing a preset, checkbox or precision value reoptimizes every graphic in the workspace from its original source. No separate Apply action is needed.

The previous image remains visible while processing. Copying optimized code and exporting are unavailable until the current result is ready. Errors are associated with the affected file; its original remains available for inspection.

Adjust optimization

Read full article

Start with a preset, adjust individual options if needed, then compare the artwork.

Choose an optimization preset

  • Gentle largely preserves IDs, structure and descriptive content. It is a cautious starting point.
  • Balanced uses the established SVGOMG defaults.
  • Compact rounds more aggressively and removes fixed dimensions for flexible web graphics.

Even Gentle cannot guarantee identical rendering for every SVG. External CSS, scripts or animations may depend on IDs, groups or styles. Choose Optimization → Reset settings to restore the defaults.

Find individual optimizations

The right panel contains 48 options grouped under Document, Styles & Colors, Geometry, Structure and Advanced. Use the checkbox on the left to enable or disable an option. Counters show how many options are active.

Use the arrow tab on the right edge or press ⌥⌘0 to show or hide the optimization sidebar. ⌘F opens the sidebar and focuses Find optimization. Enter a search term and expand a group if needed. Esc exits or clears the active search. Use the information button beside an option or hover over it to learn what it does.

Under Document → Remove data attributes, you can remove extra attributes such as data-name="Layer 1", data-id or data-layer. This option is off by default and can be saved in custom presets. Enable it only when CSS and scripts do not depend on these attributes.

Precision and repeated optimization

Numeric precision controls numeric rounding; Transform precision controls transformation precision. Lower values can reduce size but may change curves, spacing or positions. Higher values retain more detail. If unsure, start with the defaults of 3 and 5.

Optimize multiple times lets the engine perform repeated optimization passes to find further savings. This may take longer. An already well-optimized file will not necessarily become smaller.

Custom presets

Read full article

Save frequently used optimization settings with a name and symbol of your choice.

Save and apply a preset

  1. Choose the optimization settings you want to reuse.
  2. Click Save under Custom presets.
  3. Enter a unique name, choose a symbol and save the preset.

A preset stores plugin switches, both precision values, repeated optimization and Beautify. Click a saved preset to apply its settings to every graphic in the workspace. Custom presets remain available after restarting the app.

Change a name, symbol or settings

Right-click a custom preset to open its menu:

  • Change name and symbol… changes its name and symbol without changing the saved settings.
  • Update with current options replaces its settings with the currently selected options while preserving its name and symbol.
  • Delete preset… deletes the preset after confirmation. The currently applied settings remain active.

Changing options in the workspace does not automatically update a saved preset.

Preview, comparison and code

Read full article

Inspect the rendered result and source code before exporting.

Compare original and result

Preview (⌘1) shows the optimized artwork. Enable Original to view the unchanged source. Compare (⌘2) displays original and result side by side.

Choose a transparent, light or dark preview background. Use +, − and Fit to zoom or fit the artwork. Preview background and zoom do not change the exported SVG. The checkerboard indicates transparency and is not exported.

Inspect fine lines, text, gradients and cutouts. A visual comparison is not an automated guarantee of identical rendering.

Inspect code and use Beautify

Code (⌘3) displays SVG source. Enable Original to inspect the unchanged original code. Beautify, beside it, formats optimized output with indentation and line breaks.

Beautify affects output: formatting is included in exports and can increase file size. It does not reformat the original. ⇧⌘C copies original code when that is displayed; otherwise it copies optimized code. Scroll within the code view when its contents exceed the available space.

Understand file sizes and Gzip

Below the artwork, SVGuru shows original size, optimized size and the difference. Compare Gzip compares compressed sizes, which can be useful when assessing web transfer size.

This setting only changes the size comparison. Export still produces a normal .svg file, not an .svgz file. Beautify or an already optimized source may mean that the result is not smaller.

Export results

Read full article

Normal export writes optimized SVG files while protecting the original files opened in the workspace.

Export one SVG file

Select a graphic, then choose File → Export optimized SVG… (⌘S) or click Export SVG. Choose a filename and location. The suggested name is similar to logo.min.svg.

Normal export always writes the optimized result, even while the original is displayed. Paths belonging to original files in the workspace are protected; choose a different name. Other existing files may be replaced after the macOS confirmation. Wait for the current optimization to finish successfully before exporting.

Export several files

Choose File → Export all results… (⇧⌘S) and select a destination folder for the completed results. You cannot start a new batch export while optimization is still running.

Export runs in the background. The sidebar shows progress and lets you Cancel. Files already fully exported are kept. You can continue working: export uses the results captured at the start; later changes to files or options apply to the next export.

Files with optimization errors are excluded. Existing destination files are preserved; SVGuru adds a number when names collide. Once finished, the sidebar shows the number exported and any failed writes. Show error details opens the affected file names and messages.

Create a maskable icon

Read full article

This tool places the selected original artwork on a square canvas for a web app icon.

Prepare artwork and background

Select a graphic in the workspace and choose Tools → Create a maskable icon…. Rectangular artwork is fitted proportionally too. The source needs a valid viewBox or fixed dimensions.

Choose Opaque background color for an opaque background. If the source has at most eight distinct recognized colors, small swatches appear with Transparent first. With more colors, the color picker remains available. Color swatches select opaque colors rather than copying the source opacity. An opaque background is recommended for maskable icons.

Check artwork and the safe zone

Fit inside safe zone centers the complete SVG canvas and fits even its corners inside the safe circle. The circle has a radius of 40% of the icon edge length. An Artwork size value of 100% means this safe fit, not filling the entire square.

Adjust size and horizontal or vertical offset as needed. Empty margins within the SVG are not removed automatically. Check the available masks and Show safe zone: important details should stay inside the circle. The status evaluates the canvas bounds, not the meaning of individual image elements.

Export PNG or SVG

Choose 192, 512 or 1024 pixels, then click Export PNG… or Export SVG…. Export always contains the full square. Masks, checkerboard and safe circle are preview guides only and are not exported. A selected transparent background remains transparent.

SVG output embeds the source as an SVG image resource and may therefore be larger. PNG is rasterized; any animation may be captured as a single moment. To use the result as a maskable web app icon, add purpose: "maskable" in the web app manifest.

Close the assistant using × at the top right, Done or Esc. The tool does not change the original or the optimization presets.

Monochrome artwork and Safari icons

Read full article

Create monochrome output from the selected original artwork and inspect it in the before/after preview.

Fixed color or currentColor

Open Tools → Make monochrome… and choose an output mode:

  • Fixed color recolors fills, strokes and gradient colors. Unpainted areas (none), geometry, stroke width and supported transparency remain intact.
  • currentColor uses the embedding context’s CSS color property. The separately selected preview color is not exported. Use it for inline SVGs and symbols; an SVG embedded with <img> does not inherit the page color.

Inspect Before / After or SVG code, then choose Export SVG…. The tool creates separate output and does not replace the graphic in the workspace.

Create safari-pinned-tab.svg

In Make monochrome, select Safari Pinned Tab. This produces black vector artwork on a transparent square canvas, centered proportionally with viewBox="0 0 16 16". The suggested filename is safari-pinned-tab.svg.

Choose Safari’s display color separately from the black SVG output. Copy embed code copies an HTML link using rel="mask-icon". Adjust its file path to match the location on your website, then check the result in Safari.

This preset does not convert artwork to SVG Tiny.

Cutouts and complex sources

White shapes and existing background shapes are recolored too. They are not automatically identified as cutouts or removed. If details disappear, create actual transparent cutouts in a vector editor first.

Colors inside masks are generally preserved as mask data. Images, filters, dynamic CSS, CSS variables, animations and some shared definitions can prevent conversion; follow the specific error message. The Safari preset additionally requires resolving masks and patterns and converting text to paths.

Export is unavailable while recalculating or when an error occurs. Close the tool with ×, Done or Esc.

SVG sprites and symbol sets

Read full article

Combine workspace graphics into one SVG file containing individually reusable symbols.

Select and name graphics

Choose Tools → Create SVG sprite…. Set the viewBox, padding, and prefix, then select a graphic in the grid preview. Keep existing grid retains positions and stroke widths when the source viewBox matches the library.

Untitled graphics appear together in the next step with a thumbnail and name field. The prefix appears before the field. In the editor you can rename other symbols or exclude graphics.

Export options and embedding

Choose an external SVG file or Inline in HTML. Beautify indents the code.

Inspect the preview and the sample under Embedding. Copy example copies the embedding code. The snippet URL-encodes filenames that contain spaces or special characters. For external use, match the file path and symbol ID; serve the sprite from the same website. Inline code is inserted once into the HTML page; the symbol set itself takes no visible space.

Give meaningful icons an appropriate accessible label on the SVG that uses them. A decorative example using aria-hidden is not sufficient for meaningful content.

Export a sprite and understand its limits

Use Export sprite… to save the file. Each graphic becomes a <symbol> with the shared viewBox. SVGuru converts basic shapes to paths and replaces fixed fill and stroke colors with currentColor.

The tool is intended for static SVGs. Scripts and event handlers are removed. Animations, foreignObject, external resources, missing references and CSS rules that cannot be resolved may prevent export. The message identifies the affected file; prepare it separately or deselect it.

Also check the sprite in the target browser and your website’s CSS. Close the assistant with ×, Done or Esc.

Continue editing an SVG library

Reopen a library previously exported by SVGuru using File → Open SVG files… (⌘O). SVGuru restores the existing symbols, viewBox, padding, and name prefix. You can add more files and rename symbols.

Choose File → New → Create SVG sprite… to start with an empty library. Choose 16 × 16, 20 × 20, 24 × 24 (default), or a custom viewBox when creating a library. Choose Add files to import SVGs. Basic shapes such as circles, rectangles, and polylines are converted to paths. New icons inherit their color through currentColor.

Icons are scaled to fit and centered by default. Select Keep existing grid before importing to preserve position and stroke width. The source viewBox must have the same width and height as the library. Padding is not reapplied. Use Export sprite… to save the library under its existing name or as a new file.

Settings and file associations

Read full article

Adjust appearance and optionally open SVG files directly from Finder.

Light, dark or follow macOS

Open SVGuru → Settings… (⌘,) and choose Follow macOS, Light or Dark under Appearance. The same choices are available under View → Appearance.

App appearance and the SVG preview background are separate settings.

Under Accent color, choose Violet, Blue, Green, Orange or Pink. Your choice applies immediately to controls, highlights, the Dock icon, and the sample artwork, and is saved across restarts. SVG artwork colors and optimization presets are unaffected.

Make SVGuru the default app

Under SVGuru → Settings… → Open SVG files, check the current default app. Click Make default and confirm any macOS prompt. SVG files will then open in SVGuru when double-clicked in Finder.

The welcome screen offers the same action. Dismiss the hint permanently with ×; the option remains available in Settings. The association changes only when you explicitly request it.

This requires the built .app package. Individual files with their own Finder association may differ from the default. To switch to another app, select an SVG in Finder → Get Info (⌘I) → Open with → choose an app → Change All….

Choose the app language

SVGuru follows the language macOS selects for the app. English and German are available.

To choose English for SVGuru without changing your Mac’s overall language, open System Settings → General → Language & Region → Applications, add SVGuru and select English. Quit and reopen SVGuru if needed. Existing presets, their names and optimization options are preserved.

Questions and troubleshooting

Read full article

Find guidance on unsupported files, rendering differences and local processing.

A file cannot be processed

Check the .svg extension, UTF-8 encoding and file size. Renaming PNG, PDF or Illustrator files does not convert them to SVG; export SVG from a suitable program first. Invalid XML can also prevent processing.

Tools such as Make monochrome and Create SVG sprite support fewer SVG features than general optimization. A file appearing in the preview does not mean every tool can convert it. Follow the specific error message.

The result looks different

Switch to Compare, choose Gentle and increase precision if needed. Disable potentially relevant options one at a time, such as ID, style or group cleanup, and compare again.

The preview does not load external resources. External images or fonts may therefore be missing or appear differently. Also check SVGs intended for a website in their actual embedding context. Complex files can take longer; an optimization step already in progress does not stop immediately.

Local processing and licenses

SVGuru runs the embedded SVGO engine locally on your Mac. Optimization does not require uploading your graphics. The app uses macOS file dialogs to open and save files. Settings and custom presets are stored locally.

The interface is native; artwork previews use WebKit for rendering. The network permission needed by that renderer does not mean graphics are sent to a server for optimization.

Choose Help → Open-source licenses to view bundled license notices for SVGO, SVGOMG and other included components.

Keyboard shortcuts

Read full article

Common workspace commands. ⌘ is Command and ⇧ is Shift.

Files, views and search

  • ⌘O: open SVG files.
  • ⌘N: enter SVG code.
  • ⌘V in the workspace or ⇧⌘V: import SVG from the clipboard.
  • ⌘S: export the selected optimized SVG.
  • ⇧⌘S: export completed results as individual files.
  • ⇧⌘C: copy original code when it is displayed; otherwise copy optimized code.
  • ⌘⌫: remove the selected file from the list without deleting it from disk.
  • ⌘1 / ⌘2 / ⌘3: preview / comparison / code.
  • ⌘F: find an optimization.
  • ⌘,: open Settings.
  • Esc: leave the active search or close an assistant when an ongoing export does not prevent it.

Some commands are available only when a file is selected and the required result has finished processing.