# csv2languagefiles

**Repository Path**: mirrors_inloop/csv2languagefiles

## Basic Information

- **Project Name**: csv2languagefiles
- **Description**: Translates CSV containing language translations to both iOS and Android file formats.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# csv2languagefiles

Translates CSV containing language translations to both iOS and Android file formats.

## Features

* Both iOS and Android supported
* iOS support for .strings files, also for .json files using libraries like [Kekiiwaa/Localize](https://github.com/Kekiiwaa/Localize)
* Multiple variants of apps supported, for whitelabel apps or just for multiple flavors
* Multilanguage support
* Possibility to designate certain keys for certain platforms or both
* Support for parameters in strings, {string}, {float}, {integer}
* Possible to include HTML tags in texts, values are correctly handled for platforms
* All translation files are also containing original (first) language values for better orientation
* Works just as charm

## Usage

You have to have python 2.7.x installed. No libraries apart from standard ones are not required.

```
python csv2languagefiles.py exported.csv
```

After this script finishes, you can find both iOS and Android generated language files in the directory where you ran the script.

## Example

The structure of CSV is basically self explanatory, and the format (column order, etc.) must be followed for the script to work corretly.

| Key                    | Variant | iOS | Android | en                                                              | sk                                                                     | 
|------------------------|---------|-----|---------|-----------------------------------------------------------------|------------------------------------------------------------------------| 
| user_with_name         |         | yes | yes     | User {string}                                                   | Užívateľ {string}                                                      | 
| user_with_name         | sales   | yes | yes     | Customer {string}                                               | Zákazník {string}                                                      | 
| welcome_message_styled |         |     | yes     | Welcome on our <font style="color: red">red</font> website! | Vitajte na našej <font style="color: red">červenej</font> stránke! | 

### Example output

If this CSV is used as input, we get these files generated under `generated` folder:

```
- android
 - src
  - main
   - res
    - values
     - strings.xml
    - values-en
     - strings.xml
    - values-sk
     - strings.xml
  - sales
   - res
    - values
     - strings.xml
    - values-en
     - strings.xml
    - values-sk
     - strings.xml
- ios-strings
 - main
  - Localizable.en.strings
  - Localizable.sk.strings
 - sales
  - Localizable.en.strings
  - Localizable.sk.strings
- ios-json
 - main
  - lang-en.json
  - lang-sk.json
 - sales
  - lang-en.json
  - lang-sk.json
```

Example of generated `android/src/main/res/values/strings.xml`:
```
<?xml version="1.0" encoding="utf-8"?>
<resources>

    <!-- User {string} -->
    <string name="user_with_name" formatted="false">User %s</string>

    <!-- Welcome on our <font style="color: red">red</font> website! -->
    <string name="welcome_message_styled"><![CDATA[ Welcome on our <font style="color: red">red</font> website!]]></string>
</resources>
```

Example of generated `ios-strings/sales/Localizable.en.Strings`:
```
/* Customer {string} */
"user_with_name" = "Customer %@";
```

Example of generated `ios-json/sales/lang-en.json`:
```
{
    "user_with_name": "Customer %@"
}
```

# License

```
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```