FIMA

Documentation

---

FIMA (File Manager) is a simple and fast file manager, written in C++.

Warning

This program is in its early stage of development, so there might be some bugs.

Customization

Config file

FIMA supports a config file in TOML format, it's located here:

• linux: $HOME/.config/fima/config.toml
• windows: $APPDATA/fima/config.toml

If the file doesn't exists it will create it.

Default config:

You can dump it using --dump-default-config.

depth = 8
process_directory_size = false

[ls]
icons = false
all = false
one-line = false
group-directories-first = false
group-directories-last = false
long = false
verbose = false
headers = false

[tree]
all = false
no-gitignore = false
verbose = false

[rm]
recursive = false

[cloc]
ignore = [ "" ]
sort = "total"
quiet = false
no-gitignore = false

[info]
verbose = false
tags = false
remotes = false

Icons

The icons can be customized.

You customize them in the config file like this:

[icons.files]
# <extension without the ., it can be a custom one> = "<icon>"

[icons.dirs]
# <name of the dir> = "<icon>"

[icons.name]
# <name in quotes (support glob, all the comparisons are case-insensitive)> = "<icon>"

Example:

[icons.files]
cpp = "󰙲"

[icons.dirs]
custom_name = ""

[icons.name]
"*cat*" = "" # *cat* converts to ^.*cat.*$

Theme

The FIMA's colors can be changed how you want.

The theme file is located here:

• linux: $HOME/.config/fima/theme.toml
• windows: $APPDATA/fima/theme.toml

All the colors can be written in 3 different formats:

• HEX string (#76946a)
• RGB array ([118, 148, 106])
• Color name (green)

Available color names:

• black
• dark grey
• light grey
• dark gray
• light gray
• white
• blue
• light blue
• cyan
• light cyan
• green
• light green
• magenta
• light magenta
• red
• light red
• yellow
• light yellow

Default theme:

You can dump it using --dump-default-theme.

[general]
primary = "green"
secondary = "white"
border = "green"
info = "green"
warning = "yellow"
error = "red"

[specific]
directory = "green"
executable = "red"
symlink = "blue"
archive = "blue"
media = "yellow"
normal_file = "white"

[permissions]
read = "green"
write = "yellow"
execute = "red"
null = "light gray"

[ls]
permissions = "yellow"
size = "green"
user = "red"
date_modified = "blue"
name = "green"

Road Map

• add the following commands:
  • create
  • remove
  • copy
  • rename
  • permissions
  • cloc
  • info
• add config file support (TOML format)
• add zip and unzip functionality
• version 0.1.0:
  • general improvement
  • polish
  • add verbose mode to info
• add theming features
• create docs website using vitepress
• add trash features

See CONTRIBUTING.md if you want to contribute!

License

This product is under the GPL 3.0 license, see LICENSE for more details.