PHPackages                             openl10n/cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. openl10n/cli

ActiveProject[CLI & Console](/categories/cli)

openl10n/cli
============

Command-line tool to interact with Openl10n

v0.2.1(10y ago)1349311[1 issues](https://github.com/openl10n/openl10n-cli/issues)[2 PRs](https://github.com/openl10n/openl10n-cli/pulls)MITPHPPHP ^5.5

Since Sep 12Pushed 10y ago3 watchersCompare

[ Source](https://github.com/openl10n/openl10n-cli)[ Packagist](https://packagist.org/packages/openl10n/cli)[ RSS](/packages/openl10n-cli/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (4)Dependencies (9)Versions (6)Used By (0)

OpenLocalization CLI tool
=========================

[](#openlocalization-cli-tool)

[![Build status...](https://camo.githubusercontent.com/c99c03150f730361d96c42e6c58b43d7a7171d175b1dc7550dab64e4a8903e78/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6f70656e6c31306e2f6f70656e6c31306e2d636c692e737667)](http://travis-ci.org/openl10n/openl10n-cli)[![Code quality...](https://camo.githubusercontent.com/c6cfe1f4e73ce489e55d9e93b42840fb7d204917df517f845f7ad73c09b07d1c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6f70656e6c31306e2f6f70656e6c31306e2d636c692e737667)](https://scrutinizer-ci.com/g/openl10n/openl10n-cli/)[![License MIT](https://camo.githubusercontent.com/74ea3d774c5103e6783dc09d57ef2525e1ddb80fee772cd83c2f766cf7e62e78/687474703a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/openl10n/openl10n-cli/blob/master/LICENSE)[![Packagist](https://camo.githubusercontent.com/1ff208a9de00a54a43be1a4d4898666ab4e0a93bdc967bafb306c9dd183caa7c/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f70656e6c31306e2f636c692e737667)](https://packagist.org/packages/openl10n/cli)[![Dependency Status](https://camo.githubusercontent.com/25a0b864b11ea7af59d268afcf7b7aa19c57900511047b8bde979237c0e5f0f5/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3534336365353138363465343361333461333030303033312f62616467652e737667)](https://www.versioneye.com/user/projects/543ce51864e43a34a3000031)

Install
-------

[](#install)

Download the last PHAR file from the [releases panel](https://github.com/openl10n/openl10n-cli/releases)and add it to your `$PATH`:

```
VERSION=vX.X.X
curl -LO "https://github.com/openl10n/openl10n-cli/releases/download/${VERSION}/openl10n.phar"
chmod +x openl10n.phar
mv openl10n.phar /usr/local/bin/openl10n
```

Or clone the source and build it manually using [Composer](https://getcomposer.org/)and [Box Project](http://box-project.org/).

```
git clone https://github.com/openl10n/openl10n-cli.git; cd openl10n-cli
composer install
box build
mv openl10n.phar /usr/local/bin/openl10n
```

You can also include it directly in a PHP project by adding it in your Composer dependencies:

```
composer require openl10n/cli
```

Usage
-----

[](#usage)

Write a `.openl10n.yml` file on the root of your project:

```
# Server configuration
server:
    hostname: openl10n.dev # Location of your openl10n instance
    port: 80               # Specify port if needed (optional)
    use_ssl: true          # If openl10n is protected by ssl (optional)
    username: user         # User credentials (login)
    password: userpass     # User credentials (password)

# Project identifier
project: foobar

# Path to the translation files
files:
    # Example of patterns for a standard Symfony application
    - pattern: app/Resources/translations/*..*
    - pattern: src/*Bundle/Resources/translations/*..*
```

If you use versionning with this configuration file then it's better to specify server credentials outside of the project.

You can use an alias in the `.openl10n.yml` file:

```
# Server configuration
server: foobar
```

and reference the credentials for this alias into the `$HOME/.openl10n/server.conf` file:

```
[foobar]
hostname: openl10n.dev
port: 80
use_ssl: true
username: user
password: userpass
```

Upload translations:

```
openl10n push --locale=all
```

Download translations:

```
openl10n pull --locale=all
```

### Select files to upload

[](#select-files-to-upload)

You can select the files you want to push to the server by adding a file name list at the end of the command:

```
openl10n push --locale=all app/Resources/fr.yml config/translations/de.yml
```

### Select files to download

[](#select-files-to-download)

Same thing here:

```
openl10n pull --locale=all app/Resources/fr.yml config/translations/de.yml
```

License
-------

[](#license)

OpenLocalization is released under the MIT License. See the [bundled LICENSE file](LICENSE) for details.

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~179 days

Total

4

Last Release

3772d ago

PHP version history (2 changes)v0.1PHP >=5.4

v0.2.1PHP ^5.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/efa59158e76767abf1663e27b2980f2ca16eda5070c2b8f50a81c10ccd4ac12b?d=identicon)[MattKetmo](/maintainers/MattKetmo)

---

Top Contributors

[![MattKetmo](https://avatars.githubusercontent.com/u/334996?v=4)](https://github.com/MattKetmo "MattKetmo (71 commits)")[![olaurendeau](https://avatars.githubusercontent.com/u/1516110?v=4)](https://github.com/olaurendeau "olaurendeau (19 commits)")[![b-durand](https://avatars.githubusercontent.com/u/554218?v=4)](https://github.com/b-durand "b-durand (5 commits)")[![jdeniau](https://avatars.githubusercontent.com/u/1398469?v=4)](https://github.com/jdeniau "jdeniau (3 commits)")[![franmomu](https://avatars.githubusercontent.com/u/720690?v=4)](https://github.com/franmomu "franmomu (1 commits)")[![nervo](https://avatars.githubusercontent.com/u/95935?v=4)](https://github.com/nervo "nervo (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/openl10n-cli/health.svg)

```
[![Health](https://phpackages.com/badges/openl10n-cli/health.svg)](https://phpackages.com/packages/openl10n-cli)
```

###  Alternatives

[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M482](/packages/pimcore-pimcore)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k45](/packages/friendsoftypo3-content-blocks)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1301.6M2.7k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M534](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)