SYM - macOS Crash Log Symbolication Tool

SYM is a graphical tool specifically designed for macOS, dedicated to symbolizing crash logs of iOS/macOS applications. It aims to simplify the complex process of analyzing crash reports for developers and testers, converting difficult-to-read hexadecimal memory addresses into readable function names and line numbers.

Key Features

1. Support for Multiple Crash Log Formats

• Standard Apple Crash Reports: Full support for .crash files generated by iOS, macOS, tvOS systems.
• CPU Usage Logs: Capable of analyzing performance logs containing CPU usage details.
• Third-party Service Integration:
  • Fabric/Crashlytics: Supports parsing crash reports from Firebase Crashlytics.
  • Umeng: Supports parsing crash log formats from Umeng, a popular domestic analytics service in China.

2. Intelligent dSYM File Management

• Automatic Search and Matching: The app automatically scans directories such as ~/Library/Developer/Xcode/, Spotlight index, and common locations to intelligently locate dSYM files matching the build UUID of the crash log.
• Custom Download Scripts: If dSYM files are not stored locally, users can write custom scripts (e.g., to download from internal company servers or CI systems), and SYM can invoke these scripts to automatically retrieve required symbol files.

3. Convenient Data Import and Management

• Import from Devices: Connect iPhone, iPad, or other devices via USB and directly import .crash log files without manual export.
• Sandbox File Browser: Includes a simple sandbox file browser to help developers view and manage files within the app’s sandbox (primarily for macOS applications).

4. Clean and Efficient User Experience

• Drag-and-Drop & Paste: Simply drag crash log files into the SYM window, or paste the log text content directly.
• One-Click Symbolication: Click the Symbolicate button in the top-left corner of the interface to automatically complete the entire symbolication process, with results clearly displayed.

Core Advantages

• Graphical Interface, Lower Barrier to Entry: Eliminates the need to memorize complex commands and parameters for tools like atos or symbolicatecrash in the terminal, offering great convenience for users who are not comfortable with command-line tools or new developers.
• Open Source and Free, Secure and Transparent: SYM is open-sourced on GitHub under the MIT license. Users can use it freely, inspect the code, and even contribute improvements—without concerns about cost or privacy.
• High Automation: Most processes—from locating dSYM files to completing symbolication—are automated, significantly improving crash analysis efficiency.
• Focus on Native macOS Experience: As a pure Mac application, its interface and interactions follow macOS design guidelines, ensuring smooth performance and seamless system integration.

Usage Instructions

1. Method 1 (Recommended): In Finder, locate the crash log file (.crash or .txt), right-click and select “Open With” -> “SYM”.
2. Method 2: Open the SYM application, drag the crash log file into the window, or copy the log text and paste it into the main editing area.
3. Click the “Symbolicate” button in the top-left corner of the application window.
4. Wait for processing to complete; the symbolicated, readable stack trace will be displayed directly in the window.

How to Obtain

• Build from Source: Developers can also clone the source code from the GitHub repository and compile it themselves using Xcode.

System Requirements: Requires macOS. It is recommended to keep dSYM files (generated with each app build) properly archived, as they are essential for symbolication.