# CLI configuration

The Telosys-CLI configuration is defined in the file **`telosys-cli.cfg`**.   

This file is located in the directory where Telosys-CLI has been installed.  It can be edited with any text editor.

For now, this file simply allows you to define a **specific external editor** that will be launched for all "edit" commands (eg "eb", "ecfg", etc.) and a **specific file explorer** for "fx" command.

## Text editor configuration

Telosys-CLI comes with its own text editor, but this editor is quite basic and requires a graphical interface (eg GNOME or KDE for Linux). So you might prefer to set another text editor.

Telosys allows you to define a command to launch your favorite text editor for example     \
 "Visual Source Code", "Atom", "Sublime Text", "Notepad++", etc

Use the **`EditorCommand`** property to define the command that will be launched by Telosys-CLI.

The value is the OS command to execute to launch the editor. If the executable file is accessible via the "PATH", you can use it as a simple command (without full path). Otherwise, you need to find where the editor is installed and use the full path.

The **`$FILE`** variable is a placeholder representing the file to edit.

### EditorCommand examples

**Visual Studio Code** ( executable file is "code" )

```
EditorCommand = code $FILE
EditorCommand = D:/Tools/Microsoft VS Code/code.exe $FILE 
```

**Atom editor** ( executable file is "atom" )

```
EditorCommand = atom $FILE
EditorCommand = D:/Tools/atom/atom.exe $FILE
```

**Sublime Text** ( executable file is "subl" )

```
EditorCommand = subl $FILE
EditorCommand = D:/Tools/SublimeText/subl.exe $FILE
```

**Notepad++** ( executable file is "notepad++" )

```
EditorCommand = notepad++ $FILE
EditorCommand = C:/Program Files (x86)/Notepad++/notepad++.exe $FILE
```

**Linux Mint editors**

```
EditorCommand = /usr/bin/xed $FILE
EditorCommand = /usr/bin/gnome-terminal -e "vi $FILE"
EditorCommand = /usr/bin/gnome-terminal -e "nano $FILE"
```

**Linux Lubuntu editors**

```
EditorCommand = /usr/bin/leafpad $FILE & 
EditorCommand = /usr/bin/lxterminal -e "vi $FILE"
EditorCommand = /usr/bin/lxterminal -e "nano $FILE"
```

## File explorer configuration 

The "**fx**" command launches a file explorer in the current directory (since ver 4.1.0). 

2 commands are defined by default : "explorer" for Windows and "open" for MacOS.

You can set your own command to use your favorite explorer   \
by using the  **`FileExplorerCommand`**   property

The variable **`$DIR`** is a placeholder for the directory where to start the explorer.

### FileExplorerCommand examples 

**Windows - 'TotalCommander'**  

```
FileExplorerCommand = C:/Program Files/totalcmd/totalcmd64.exe $DIR
```

**Linux Ubuntu - 'Nautilus'** ( executable file is "nautilus" )

```
FileExplorerCommand = nautilus $DIR
```