🌊 A clean wave - report unused localized strings

Edoardo Benissimo

Last update: Sep 16, 2022

Related tags

Command Line swift xcode clean-code resources cleanup spm command-line-tool

Overview

Ripple 🌊

Ripple - a command line tool that reports unused localization strings in your Xcode project.

Install

Clone from repo

git clone 
cd Ripple
swift build -c release
sudo cp .build/release/Ripple /usr/local/bin/ripple

Usage

Navigate to your project folder, then:

ripple

This command will scan current folder to find unused localized strings.

To get help you can use:

ripple --help

   -p, --project: 
       Root path of your Xcode project. Default is current folder.
   -e, --exclude:
     Exclude paths from search.
   --version:
       Print tool version.
   -h, --help:
       HELP ME!

Command line example

 ripple --exclude Pods

This command will search in current folder and skip Pods folder. It is recommended that you exclude third party folders.

Use in Xcode build phase

You can integrate Ripple into your Xcode build process, so every time you build your project Ripple informs you about all unused localized strings.

Add a "Run Script" phase in the Build Phases tab:

And add this:

if which Ripple > /dev/null; then
  Ripple -e Pods
else
  echo "warning: Ripple not installed, download from https://github.com/EdoardoB/Ripple"
fi

How Ripple works

Search all .strings file and extract all localized keys 🔎
Use regular expression to search unused localized key in project ⚙️
Reports unused localized key ⚠️

You might also like...

A minimal iOS AR app that displays a wave animation using RealityKit2 Geometry Modifier

AR Simple Sea A minimal iOS AR app that displays a wave animation using RealityKit2 Geometry Modifier. Xcode 13.3 Target: iOS / iPadOS 15.0+ SwiftUI,

15 Dec 29, 2022

Wave is a spring-based animation engine for iOS that makes it easy to create fluid, interruptible animations that feel great.

Wave is a spring-based animation engine for iOS and iPadOS. It makes it easy to create fluid, interactive, and interruptible animations that feel great.

1.2k Jan 8, 2023

Butterfly is a lightweight library for integrating bug-report and feedback features with shake-motion event.

Butterfly is a lightweight library for integrating bug-report and feedback features with shake-motion event. Goals of this project One of th

410 Sep 9, 2022

Flexible bug report framework for iOS

Clue is a simple smart-bug report framework for iOS, which allows your users to record full bug/crash report and send it to you as a single .clue file

279 Nov 3, 2022

A tool for finding missing and unused NSLocalizedStrings

nslocalizer This is a command line tool that is used for discovering missing and unused localization strings in Xcode projects. Contributing and Code

155 Sep 17, 2022

A Github action for creating generic run report using Markdown

create-report A Github action for creating generic run report (using Markdown!) - uses: michaelhenry/[email protected] with: report-title: "

4 Apr 19, 2022

A danger-swift plug-in to report xcresult in your PR

DangerSwiftKantoku A danger-swift plug-in report xcresult in your PR. Install DangerSwiftKantoku SwiftPM (Recommended) Add dependency package to your

9 Nov 18, 2022

A phantom type is a custom type that has one or more unused type parameters.

PhantomTypes A phantom type is a custom type that has one or more unused type parameters. Phantom types allow you to enforce type-safety without sacri

3 Nov 4, 2022

Setting up application specific localized string within xib file.

LocalizedView ##What is this? LocalizedView is a helper class for setting up application specific localized string within Xib file. Here is a video de

8 Oct 2, 2017

OS font complements library. Localized font supported.

SwiftFontName SwiftFontName is font name complements and supports localized font library. You don't need to search font name any more with SwiftFontNa

114 Nov 3, 2022

ScreenshotFramer - Create localized App Store screenshots

ScreenshotFramer With Screenshot Framer you can easily create nice-looking and localized App Store Images. How does it work? It's super simple: Screen

699 Dec 16, 2022

A μlibrary in Swift containing all the countries with their localized name, ISO code, phone code, country code, flag image and emoji.

CountryKit CountryKit A μlibrary in Swift containing all the countries with their localized name, ISO code, phone code, country code, flag image and e

24 Nov 11, 2021

EmbeddedStringsKit: Representation localized string in code

EmbeddedStringsKit Representation localized string in code Usage public struct L

1 Jul 13, 2022

Provides API access to localized musical instruments and their tunings.

instruments.fyi instruments.fyi provides API access to localized musical instruments and their tunings provided by InstrumentKit. Table of Contents Wo

10 Sep 5, 2022

Provides type-safe access to localized musical instruments and their tunings.

InstrumentKit InstrumentKit provides type-safe access to localized musical instruments and their tunings. Table of Contents Work In Progress Installat

14 Nov 3, 2022

The Swift code generator for your assets, storyboards, Localizable.strings, … — Get rid of all String-based APIs!

SwiftGen SwiftGen is a tool to automatically generate Swift code for resources of your projects (like images, localised strings, etc), to make them ty

8.3k Dec 31, 2022

Localization/I18n: Incrementally update/translate your Strings files from .swift, .h, .m(m), .storyboard or .xib files.

Installation • Configuration • Usage • Build Script • Donation • Migration Guides • Issues • Contributing • License BartyCrouch BartyCrouch incrementa

1.3k Jan 1, 2023

Localize is a framework writed in swift to localize your projects easier improves i18n, including storyboards and strings.

Localize Localize is a framework written in swift to help you localize and pluralize your projects. It supports both storyboards and strings. Features

279 Dec 24, 2022

Super lightweight library that helps you to localize strings, even directly in storyboards!

Translatio Example To run the example project, clone the repo, and run pod install from the Example directory first. Requirements iOS 9 or higher. Swi

19 Jan 29, 2022