A cross-platform terminal-based termux-oriented file manager (and component), meant to be used with a Uni-Curses project or as is. This project is mainly an attempt to get more attention to the Uni-Curses project.

⚙️ Installation

sudo pip3 install tuifimanager --upgrade

pip3 install TUIFIManager --upgrade

or just ^^^ if it works for you. (eg. on termux?)

💥 Usage

Run tuifi in your terminal to use it as is or import it in one of your Uni-Curses project as a component like:

from TUIFIManager import *

for more details look into the __main__.py

📦 Features

• 📌 Current:

• Supports X11 Drag&Drop from terminals
• Supports most common mouse events
• Can be used as a component
• Uses about ~30MB of RAM
• Strong C TUI backend
• It is pretty snappy
• Supports Termux
• Cross Platform
• and more

• 🔮 Desired:

• Macros
• Treeview
• Undo\Redo
• Improved UI
• Multiple tabs
• Sixel support
• Effect on cutted Files
• Multithread performance

⌨️ Keybindings

In vim_mode both normal and vim shortcuts work

(TIP: 🐁 use ALT + CLICK for multiple mouse selection if SHIFT not working)

TERMUX only Shortcuts\Keybindings

👨‍💻 Commands

(Default & Custom Comands) - To perform a command under the normal-mode, you first have to press the space-bar and then type the command. Alternatively, use vim_mode or enable the tuifi_auto_command_on_typing env-variable (notice: it disables tuifi_auto_find_on_typing). The default commands can be seen below and can be found under the ~/.config/tuifi/cmds.conf where you can add your custom ones too:

Available Type-keywords: open, copy, cut, find

important note: o is also used for ordering in vim_mode. In this case you can first press space-bar before proceeding with owv or with any other already reserved starting key, or just change it.

Additionally there are also some "static" ones like the m+character which marks the current directory into the character, so you can navigate back to it by using ` or ;+that_character

📜 Documentation

Work in progress 🛠️🏗 ...

💭 Customization

Set tuifi_vim_mode enviroment variable to True

Set tuitilities_default_background enviroment variable to True

set tuifi_synth_dnd enviroment variable to True. pip install requests pynput PySide6 python-xlib. Know it's expirimental! You'll need to adapt to it slightly, use it as: Drag&drop + click afterwords where you want the file to be dropped. See also and this issue

Set tuifi_default_editor enviroment variable to vim or whatever you prefer

You can just set tuifi_auto_find_on_typing enviroment variable to False

You can set either or both tuifi_scroll_sensitivity, tuifi_ctrl_scroll_sensitivity enviromental variables, to the disered number of characters per scroll action (they default to 1 and 7)

This is not possible right now althought you could play around with the content of toggle_vim_mode function under __init__.py

You can set how mnay lines you want using tuifi_visible_filename_lines (Defaults to 4)

Set tuifi_config_path enviroment variable to whatever you prefer most

You can either CTRL + T or set tuifi_show_hidden enviroment variable to True

look here for more informations

💗 Donation

I do really need money to survive, I have no job, living in a basement, making things for free, because I love to.

• Paypal Address
• Monero Address: 897ehhSQJQpGF7tYDhQM51jiX7nnHmzuYAW4q8JGwJxu8JKXvaK6AivCzatuJxnifjZ2qy98ks2g2PhmTaYCMMta2Ga2LJx

🫶 Special thanks to

• @KORBEN for this article
• Bryan Lunduke for this article
• Brodie Robertson for this video
• r/linux community for their comments
• r/cyberDeck community for their comments
• r/commandline community for their comments

🕳️ Outro

• Any Idea with this issue https://github.com/unicurses/unicurses/issues/21 ?
• Btw I use TUIFI in a daily basis. As crazy as it might sound: It's my primary file manager.