FengNiao is a command-line tool for cleaning unused image resources from Xcode projects.
The tool solves the problem of accumulating unused image assets in iOS and macOS projects, which can bloat app size and create maintenance confusion. It works by extracting resource file names from standard asset folders, scanning source code files with regular expressions to identify which resources are actually referenced, and then reporting the unused files for deletion. The approach covers common image formats and asset types while searching through Swift, Objective-C, and interface builder files.
Developers managing iOS or macOS projects should consider this tool if they want to periodically audit and remove dead image assets. It suits projects that have grown over time and may contain forgotten or deprecated resources. The tool can run interactively from the command line for manual review, or be integrated into Xcode build phases with the force flag for automated cleanup. A graphical app version is also available in the repository, though it requires manual compilation.
The project maintains active development with regular commits addressing bug fixes and feature improvements. The codebase includes comprehensive test coverage to validate the scanning and detection logic. Documentation is thorough, covering installation via package managers, command-line usage with various filtering options, and integration patterns for continuous cleanup workflows.
