tcim-portable - terminal commands in menus

An easy way to call hard to remember or complex terminal commands or scripts from a menu.

This is the non-packaged, portable version. It is made to keep things more minimalistic. It's just some scripts in one single directory.

supported menu systems

• dmenu
• xdg desktop menu

files

commands.tsv contains your commands. It can be edited using the menu (see usage) or manually using your favourite text editor. Since it is a .tsv file, you could even use a spreadsheet program like libreoffice calc.

file format

commands.tsv is a tab-separated values file:

name <tab> comment <tab> command

example:

list filesystems	report file system space usage	df -h

If you don't want to keep the terminal open after the command has finished, prepend the command with [NOKEEP]. If you don't want to run the command in a terminal, prepend the command with [NOTERM].

The command can't contain double quotes ". If you need double quotes, move the command into a script file and use it in the command field.

installation

git clone https://github.com/wups/tcim-portable

usage

Customize your commands.tsv.

dmenu

Call tcim-dmenu to list the available commands in a dmenu.

Currently xterm is used to display the result of the command and it is expected to be installed.

xdg desktop menu

Call tcim-update-xdg-menu to update your desktop menu, used by many desktop environments. Once called, everything (e.g. editing the commands-file) is available from the menu.

uninstall

Just delete the tcim-portable directory. You can use this command to get rid the .desktop files installed by the tcim-update-xdg-menu script:

xdg-desktop-menu uninstall command-menu.directory ~/.local/share/applications/command-*

todo

• new field for optional working directory
• support more menu systems (e.g. rofi, openbox)