Skip to content

Latest commit

 

History

History
123 lines (79 loc) · 5.58 KB

README.md

File metadata and controls

123 lines (79 loc) · 5.58 KB

It is Strings but with a Z 😬

Latest Version follow on Twitter

Stingz

Loved the project? Please share it with your friends and give it a ⭐️

Stringz is a lightweight and powerful editor that makes localizing your iOS app easy and fast.

✏️ Description

Stringz greatly simplifies localizing your Xcode apps (iOS, macOS, tvOS, and watchOS) by introducing a powerful editor for all localizable files in your project. It even imports strings from storyboard and xib files saving you a lot of time and effort finding and matching elementIds in your storyboards. Stringz also supports localizing your Info.plist file so you can easily translate your app name and permission descriptions.

Stringz will also highlight missing translations and warn you about duplicate values and has many more useful features that take a painful and tedious task like localizing your app and convert it to an easy and simple task.

✨ Features

  • ✅ Automatically finds localizable files in an Xcode project.
  • ✅ Displays translations in a table side by side and highlights missing values.
  • ✅ Supports all kinds of localizable files like .strings, .storyboard, .xib and .plist.
  • ✅ Supports adding new languages and localizing unlocalized files.
  • ✅ Easy to use and Mac in its core.
  • ✅ Continuously being improved and updated.

🚧 Table of Contents

🚀 Motivation

⬇️ Installation

  • From releases page of this repository.
  • Via Homebrew brew install --cask stringz

🔌 Usage

Open the application and select your Xcode project (.xcodeproj) in the open dialog, Stringz will then automatically crawl your project, find localizable files, and display them in the sidebar. Select a localizable file from the sidebar to view its contents. From there you can add/delete/update strings and add new languages.

Stringz also supports Undo/Redo feature so you don't have to worry about making mistakes while working just hit Ctrl+Z to take your last action back.

The application has an autosave feature to automatically save your changes as you make them (You can also disable this feature from preferences if you don't want Xcode to reload every time you update a string).

The preferences window also contains some useful options regarding importing and exporting localizable files to your project. So I would strongly advise you to check app preferences out.

There is a sample app included in this repository, Stringz was heavily tested with this sample app, So I encourage you to download the sample app and run Stringz on it to examine how Stringz should normally work, If you encounter an unexpected behavior with your own project please consider submitting an issue and I'll make sure to fix it as quickly as possible.

🤝 Contributing

This project is open-source, so you're more than welcome to contribute to the project's development. A great way to help to push this project forward is to download it and test it on your applications then submit an issue about any bugs, crashes or any unexpected behaviors you might encounter, Also suggestions and feature requests are super welcomed. If you have the time and energy please consider making a pull request and I'll work with you to improve the app (working with people gives me the motivation to keep improving) and if you encounter some kind of inconvenience please don't give up on the application, submit an issue and help make this project better.

💡 FAQ

⚒️ Dependencies

Stringz uses XcodeEditor to open Xcode projects and browse their contents.

👍 Support

If you find a bug in the app please submit an issue and I'll make sure to fix it as quickly as possible.

If you need support or have questions/feature requests regarding the app you can mention @stringz_app in a tweet or send me an email and I'll be happy to respond.

Also, don't forget to follow @stringz_app on Twitter to get the latest news regarding Stringz App. Thanks!

📝 License