SF Viewer for iOS
SF Viewer is the best way to view, compare and export SF Symbols on your iOS device.
Features:
- View all SF Symbols
- Change weight and scale to see how each icon is displayed in a certain setting.
- View additional metadata for a symbol, easily copy it's unicode encoding.
- Export to SVG, PDF, PNG, Squared PNG.
- You can also export icons explicitly for use with Shortcuts on your Home Screen.
Follow me on Twitter at @aaron_pearce.
Getting involved
Please feel free to participate in this open source project. I'd love to see Pull Requests, Bug Reports, ideas and any other positive contributions from the community!
Building the code
- Clone the repository:
git clone https://github.com/aaronpearce/SF-Viewer.git
- Pull in the project dependencies:
cd Symbals sh ./bootstrap.sh
- Open
Symbals.xcworkspace
in Xcode. - Find a source for the following fonts and drop them into the Fonts directory in Xcode:
SF-Pro-Text-Bold.otf SF-Pro-Text-Heavy.otf SF-Pro-Text-Light.otf SF-Pro-Text-Medium.otf SF-Pro-Text-Regular.otf SF-Pro-Text-Semibold.otf SF-Pro-Text-Thin.otf SF-Pro-Text-Ultralight.otf
- Build the
Symbals
scheme in Xcode.
Code Signing
If bootstrap.sh fails to correctly offer your Apple Team ID, please follow this guide to manually add it.
- After running the bootstrap.sh script in the setup instructions navigate to:
Symbals/Configuration/Local/DevTeam.xcconfig
- Add your Apple Team ID in this file:
LOCAL_DEVELOPMENT_TEAM = KL8N8XSYF4
Team IDs look identical to provisioning profile UUIDs, so make sure this is the correct one.
The entire Local
directory is included in the .gitignore
, so these changes are not tracked by source control. This allows code signing without making tracked changes. Updating this file will only sign the Symbals
target for local builds.
Finding Team IDs
The easiest known way to find your team ID is to log into your Apple Developer account. After logging in, the team ID is currently shown at the end of the URL: https://developer.apple.com/account/
Use this string literal in the above, DevTeam.xcconfig
file to code sign
Thanks
Thanks to everyone for their support in development and throughout the initial releases and then the review that failed and a particular thanks to @kylehickinson for the suggestion to use Brave's .xcconfig
based setup for local development signing. Credit to @jhreis for the initial implementation that I based this upon.
Thanks to @davedelong for his sfsymbols project which helped with the exporter code within SF Viewer.
Open Source & Copying
SF Viewer is licensed under MIT so that you can use any code in your own apps, if you choose.
However, please do not ship this app under your own account. Paid or free. Not that Apple will accept it.