2.9 KiB
Microw
Microw is a command-line interface (CLI) utility developed in Python to automate the conversion of tabular data (such as CSV or TXT files) into .ini configuration files compatible with the MicroSIP softphone and its derivatives.
This tool is ideal for VoIP system administrators, technical support teams, and developers who need to perform bulk provisioning of extensions quickly and accurately.
Features
- Flexible Mapping: Define the column order of your input file via the command line.
- Customizable Templates: Use custom account templates for different network scenarios.
- Label Patterns: Generate dynamic display names (DisplayName) based on input data.
- Ghost Account: Option to add a "Disconnected" profile as the first account in the list.
- Delimiter Support: Works with commas, tabs (
\t), semicolons, etc.
How to Use
Prerequisites
- Python 3.x installed.
Installation
Simply clone the repository or download the microw.py file:
git clone https://github.com/LucioCarvalhoDev/microw.git
cd microw
Basic Execution
Assuming you have a file named your_data.csv with the format extension,label:
python3 microw.py --input your_data.csv --output accounts.ini
Argument Reference
| Argument | Default | Description |
|---|---|---|
--format |
"extension label" |
Column order (use _ to ignore columns). |
--input |
./input.txt |
Path to the source file. |
--output |
./output.ini |
Path to the generated .ini file. |
--delimiter |
, |
Column separator character. |
--label-pattern |
label |
Template for the display name (e.g., "extension - label"). |
--add-ghost |
False |
Adds a 'Disconnected' account at the top. |
--set-template |
None |
Path to a custom account template file. |
Usage Examples
1. CSV Format with Semicolons
If your file follows the pattern ID;Extension;Name;Department and you want to ignore the ID:
python3 microw.py --delimiter ";" --format "_ extension label department"
2. Customizing the Display Name
To make the name appear in MicroSIP as Extension | Name (Department):
python3 microw.py --format "extension label department" --label-pattern "extension | label (department)"
3. Using a Specific Account Template
If you need different transport settings (TLS/TCP) or ports, create a template file and point to it:
python3 microw.py --set-template my_template.txt --input extensions.txt
License and Credits
Developed by Lúcio Carvalho Almeida.
This project is Open Source.
Contact: luciocarvalhodev@gmail.com
Feel free to contribute with Pull Requests!
Você gostaria que eu ajudasse a revisar o código do microw.py ou a criar um arquivo de exemplo de template para o repositório?