Console application for managing INI files, which allows you to perform basic operations on INI files, such as saving and reading key values, creating and deleting sections, renaming and deleting keys, adding and removing a file comment and section comment, etc.
Download
Description
IniMod is a small console application for managing INI files.
The program allows you to perform basic operations on INI files, such as saving and reading key values, creating and deleting sections, renaming and deleting keys, adding and removing a file comment and section comment, etc.
Screenshots
Usage
Usage: IniMod.exe COMMAND FILES OPTIONS
Options are case-insensitive. Options and values in square brackets are optional.
All parameters that do not start with the - or / sign are treated as file names/masks.
Options and input files can be placed in any order, but -- (double dash followed by space) indicates the end of parsing options and all subsequent parameters are treated as file names/masks.
Commands
| Command | Description | Usage |
|---|---|---|
w, Write | Writes a key value. | IniMod w FILES -s Section -k Key -v Value |
r, Read | Reads and displays the value of a key. | IniMod r FILES -s Section -k Key |
rnk, RenameKey | Renames the given key. | IniMod rnk FILES -s Section -k OldKeyName -kn NewKeyName |
rmk, RemoveKey | Removes the key. | IniMod rmk FILES -s Section -k Key |
rms, RemoveSection | Removes the given section. | IniMod rms FILES -s Section |
ras, RemoveAllSections | Removes all sections. | IniMod ras FILES |
rs, ReadSection | Displays section keys and values. | IniMod rs FILES -s Section |
rk, ReadKeys | Displays section keys. | IniMod rk FILES -s Section |
ls, ListSections | Displays the names of all sections. | IniMod ls FILES |
wsc, WriteSectionComment | Adds one line to the section comment. | IniMod wsc FILES -s Section -c Comment [-x NUM] |
rsc, RemoveSectionComment | Clears section comment. | IniMod rsc FILES -s Section |
wfc, WriteFileComment | Adds one line to the file comment. | IniMod wfc FILES -c Comment [-x NUM] |
rfc, RemoveFileComment | Clears file comment. | IniMod rfc FILES |
Options
| Option | Description |
|---|---|
-s, --section=NAME | Section name. |
-k, --key=NAME | Key name. |
-kn, --new-key-name=NAME | Key name. |
-v, --value=STR | Key value. |
-c, --comment=STR | Section or file comment. |
-x NUM | Padding spaces (for comments). NUM – a positive integer. |
-rd, --recurse-depth=NUM | Recursion depth when searching for files. NUM – a positive integer. |
--silent | Do not display some messages. |
-h, --help | Show this help. |
--version | Show application version. |
--license | Display program license. |
--home | Opens program homepage in the default browser. |
--github | Opens the GitHub page with the program’s source files. |
FILES
Any combination of file names/masks.
Eg.: file.ini *config*.ini "long file name.ini"
Exit codes
| Exit code | Description |
|---|---|
| 0 | OK (no error) |
| 2 | Syntax error |
| 1 | Other error |
Hints
INI files are saved using UTF-8 encoding.
To create a new section, run the program with the Write command and specify the name of the desired section. If this section does not exist in the INI file, it will be created automatically.
All lines in INI files that start with the character ; are comments.
The file comment is the comment before the first section.
Each time the program is run with the WriteFileComment command, one line is added to the end of the current file comment.
A section comment is between the section name and the first section key.
Each run of the program with the WriteSectionComment command adds one line to the end of the current comment for the specified section.
Note
I wrote this program many years ago for my own use. I use it very often, maybe it will also be useful to someone.