https://github.com/corrupt952/xckit
CLI tool for managing Xcode String Catalogs (.xcstrings)
https://github.com/corrupt952/xckit
cli go i18n ios localization xcode xcstrings
Last synced: 8 months ago
JSON representation
CLI tool for managing Xcode String Catalogs (.xcstrings)
- Host: GitHub
- URL: https://github.com/corrupt952/xckit
- Owner: corrupt952
- License: mit
- Created: 2025-07-15T01:11:22.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-15T04:31:17.000Z (8 months ago)
- Last Synced: 2025-07-15T10:14:36.548Z (8 months ago)
- Topics: cli, go, i18n, ios, localization, xcode, xcstrings
- Language: Go
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xckit
A command-line tool for managing Xcode String Catalogs (.xcstrings files).
## Features
- List all localization keys with their translation status
- Find untranslated keys for specific languages
- Update translations directly from the command line
- View translation progress and statistics
- Support for multiple languages
## Installation
Download the latest release from the [Releases](https://github.com/corrupt952/xckit/releases) page.
### Build from source
```bash
go build -o xckit
```
## Usage
### List all keys
Show all localization keys with their translation status:
```bash
xckit list
```
Filter keys by prefix:
```bash
xckit list --prefix "login"
```
### Find untranslated keys
Find all untranslated keys across all languages:
```bash
xckit untranslated
```
Find untranslated keys for a specific language:
```bash
xckit untranslated --lang ja
```
Filter untranslated keys by prefix:
```bash
xckit untranslated --prefix "error"
xckit untranslated --lang ja --prefix "login"
```
### Set translations
Set a translation for a specific key and language:
```bash
xckit set --lang ja "hello_world" "こんにちは世界"
```
### View translation status
Get an overview of translation progress for all languages:
```bash
xckit status
```
### Specify a custom file
By default, xckit looks for `Localizable.xcstrings` in the current directory. You can specify a different file:
```bash
xckit list -f path/to/your/file.xcstrings
```
## Command Reference
### `list`
Lists all keys with their translation status. Use `--lang` to filter by language.
### `untranslated`
Shows keys that need translation. Use `--lang` to check a specific language.
### `set`
Updates a translation for a specific key and language. Requires `--lang`, key, and value.
### `status`
Displays translation progress summary for all languages.
### `version`
Shows the xckit version.
## Examples
```bash
# Check translation status
xckit status -f MyApp.xcstrings
# Find missing Japanese translations
xckit untranslated --lang ja -f MyApp.xcstrings
# Add a Japanese translation
xckit set --lang ja "welcome_message" "ようこそ" -f MyApp.xcstrings
# List all keys with their current translations
xckit list -f MyApp.xcstrings
```
## Development
### Running tests
```bash
make test
```
### Building
```bash
make build
```
### Coverage
```bash
make coverage
```
## License
See [LICENSE](LICENSE) file for details.