Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PDF/PNG

Posted by olliewagner on Friday April 17, 2026 @11:44PM
from the show-hn dept.

I found myself reaching for SF Symbols' 'Copy Image As…' quite often during agentic design sessions, so I made a command-line tool that the agent can use by itself. It exports Apple SF Symbols as SVG, PDF, or PNG.

The vector paths come directly from macOS's symbol renderer. Internally it reaches a private ivar on NSSymbolImageRep to get the CUINamedVectorGlyph, draws into a CGPDFContext, then walks the PDF content stream back out as SVG `d` commands. The output matches what the system draws, rather than an approximation traced from rasters.

A few things about it:

- Every subcommand accepts `--json`, and `sfsym schema` returns a machine-readable description of the whole CLI. - Symbol enumeration reads the OS's Assets.car BOM tree, so the list of 8,300+ names stays current with macOS updates without a version table in the binary. - Each SVG `<path>` carries a `data-layer` attribute, so you can retheme in CSS without touching geometry.

It's been saving me a bunch of clicking. Please let me know if you have any other ideas for it.

( 10 comments | 2 points | on HN )

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by tasoeur on Saturday April 18, 2026 @06:37AM (#47814787)

This is great! I found myself asking my AI agents to generate those icons every so often (esp. for websites), so thank you for taking the time to build this.

Quick question, are you also planning on supporting animations?

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by olliewagner on Saturday April 18, 2026 @09:52AM (#47815940)

Thanks! I'm not sure how animations would translate into these exported formats. SF Symbols animations are typically state driven, and that doesn't really translate to a standalone SVG/PNG/PDF. You'd get something that autoplays on loop, or fires once. Let me know if you had something else in mind.

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by amelius on Saturday April 18, 2026 @08:15AM (#47815314)

For those wondering what SF symbols are:

https://developer.apple.com/sf-symbols/

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by difosfor on Saturday April 18, 2026 @08:19AM (#47815337)

But these are copyright by Apple so are you allowed to use them on your commercial websites and apps?

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by olliewagner on Saturday April 18, 2026 @09:36AM (#47815828)

Right, these are licensed by Apple for UI use on Apple platforms only. The README has a "Before you use this" callout up top about this. sfsym is an export tool; what you do with the output is on you.

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by rafram on Saturday April 18, 2026 @10:15AM (#47816106)

> The default format is PDF.

Genuine question: what’s your use case for having a single SF Symbols icon as a PDF file? Let alone having that as the default? In my own experience, I’d want SVG nearly every time.

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by olliewagner on Saturday April 18, 2026 @10:46AM (#47816339)

You're right. Just flipped the default to SVG on main. Honest answer: SVG wasn't fully working during early dev, so PDF was the working default and it stuck. Should've revisited.

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by daylab on Sunday April 19, 2026 @03:33AM (#47822467)

any chance for other icon sets? lucide/tabler/material. keeping icons consistent between a web app and ios app is pain when the toolchains dont overlap

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by paolatauru on Sunday April 19, 2026 @05:52PM (#47827956)

clever hack reaching into the private ivar. curious if this holds up across macos updates or if apple has been stable with NSSymbolImageRep. also, is the main value here batch exports or is it specifically for letting agents grab icons without the gui

[ Parent | on HN ]

Re:Show HN: Sfsym – Export Apple SF Symbols as Vector SVG/PD... by olliewagner on Wednesday April 22, 2026 @12:47PM (#47866094)

Based on my research the ivar has been stable since macOS 13. I'll keep things up to date if that ever changes... To your second question, it's mostly for agents to pull icons as they go without interruption or you having to find whatever it chose to replace later. I've found Claude using batch mode after it does a lookup against the list to match a set of icons.

[ Parent | on HN ]