Command Click

Shellscript gui platform made with 100% shell script (fzf, yad, etc)

It's a shellscript manager app from gui that have execution, edit, delete, and create as feature.

Pros

• Easily turn shellscript into a GUI application.
• Versatile usage for Terminal, Crome, OS setting, etc.
• Ritch key bind.
• List shellscript.

Table of Contents

<!-- vim-markdown-toc GFM -->

• Installation
  • For windows 10
  • For Ubuntu or Debian
  • For other Linux
• Upgrading
  • Upgrading for windows 10
  • Upgrading for Ubuntu or Debian
• Demo
• Usage
  • Launch
  • Add
  • Run
  • Edit
    • by gui
    • by editor
    • description by gui
  • Exit
  • Move
  • Install
  • Setting
  • Delete
  • App directory manager
    • Launch
    • Add
    • Change directory
    • Edit
    • Exit
    • Delete
  • Shell to Gui
  • Shortcut table
  • Trouble Shouting
    • Not Startup
  • Android version

Installation

For windows 10

1. Downlaod installer.bat from google drive

2. Double click installer.bat

   • Support Ubuntu20.04+
   • for windows 11, disable wayland, but it's unconfirmed operation

For Ubuntu or Debian

• Only X11 support (wayland not support)
• Support Ubuntu20.04+

git clone https://github.com/kitamura-take/cmdclick.git ~/.cmdclick
cd ~/.cmdclick/linux/install
bash installer.sh

For other Linux

• Only X11 support (wayland not support)
• It's unconfirmed operation

git clone https://github.com/kitamura-take/cmdclick.git ~/.cmdclick
cd ~/.cmdclick/linux/install
vi installer.sh
# please replace apt with your package system cmd, which is yum
bash installer.sh

Upgrading.

Upgrading for windows10

1. delete $HOME/cmdclick directory
2. same as installation.

Upgrading for Ubuntu or Debian

1. delete $HOME/.cmdclick directory
2. same as installation.

Demo

demo flow

1. add -> run -> edit by gui -> run -> edit by editor -> run
2. edit by gui -> set editExecute(ONCE) -> run -> setVariableType(CB) -> run
3. edit by gui -> set editExecute(ALWAYS) -> run -> setVariableType(NUM) -> run
4. Install shellscript -> run -> add -> run
5. edit by gui -> set editExecute(ALWAYS) -> run
6. edit by gui -> set TerminalDo(OFF) -> run

Usage

CommandClick will launch shellscript platform, read shellscript from $HOME/cmdclick/default or etc.

Launch

for windows

First, type windows key and "cmdclick", then click cmdclick icon
Or key down ctrl+alt+c as shrotcut key. (if your shortcut key is this, change by right click at cmdclick_shortcut.link in desktop)

for Linux

Type cmdclick for search in menu. (It's easier to make a keybind)

Add

Add file to command click

1. Type alt+a, that way, open source file.

2. Write the file name you want to set at shellFileName between SETTING_SECTION_START and `SETTING_SECTION_END.

   • Set the various settingVriables below as necessary

   | settingVariable| set value | description | | --------- | --------- | ------------ | | terminalDo | ON/OFF | whether to run in terminal | | openWhere | CW/NT | when runing in terminal, whether to run current tab or new tab | | terminalFocus | ON/OFF | whether to forcus to terminal | | editExecute | N/C/E | before running shellscript, you can edit settingVriable(NO: no, ONCE: one time edit ALWAYS:always edit) | | setVariableType | string | when edit, whether to set variable type to commandVariable. You also have multiple specifing this. In detail, follow bellow. | | afterCommand | command | before run shellscript, run command | | afterCommand | command | before run shellscript, run command | | ExecBeforeCtrlCmd | command | before run shellscript, run cmdclik crtl command (prefix NO: only apply when editExecute is NO, prefix ONCE: only apply when editExecute is ONCE, prefix ALWAYS: only apply when editExecute is ALWAYS. no prefix is apply to all editExecute value), prefix #: escape ctrl cmd execute| | execAfterCtrlCmd | command | after run shellscript, run command, detail above same | | shellFileName | string | shellscript file name | | appIconPath | string | icon file path for Shell2Gui |

3. Insert the variables you want to set in the gui between. CMD_VARIABLE_SECTION_START and `CMD_VARIABLE_SECTION_END.

   • Set the various commandriables below as optional | settingVariable| set value | description | | --------- | --------- | ------------ | | shellArgs | string | shellscript args. You also have multiple specifing this. |

4. after Please write bellow with shell script, write shellscript.

5. come back Command Click screen, and if it correct, type ctrl+enter if not, esc.

• setVariableType option | option| description | example | | --------- | --------- | ------------ | | CB | checkbox | {variablebName}:CB=value1!value2!|.. | | CB | editable checkbox | {variablebName}:CBE=value1!value2!|.. | | H | hidden input | {variablebName}:H={password ..etc} | | NUM | increment or decrement number | {variablebName}:NUM={init_value}!{min}..{max}!{step}(!{number of decimal places}) | | FL | file select button | {variablebName}:FL={default file path} | | SFL | create file button | {variablebName}:SFL={default file path} | | DIR | directory select button | {variablebName}:SFL={default directory path} | | CDIR | create directory button | {variablebName}:CDIR={default file path} | | DT | create file button | {variablebName}:SFL={default file path} | | SCL | scale | {variablebName}:SCL={default number} | | CLR | select color | {variablebName}:SCL={default value} | | LBL | text label | {variablebName}:LBL={label text} | | BTN | botton | {variablebName}:BTN={command} | | FBTN | botton | {variablebName}:BTN={command} |

Run

Run shellscript

1. Cursor move to script file name you wonts run by mouse or up or down
2. Enter or double click this.
   • When inputExecute is C or E, before runninig, you will edit the script.

Edit

Cmdclick can edit shellscript by gui or editor

by gui

1. Move cursor to script file name you wonts edit by up or down.
2. Type Alt+e or run shellscript when inputExecute in seting secttion is C.
3. Soon cmdclick open the edit's gui, then set each variable you wont to change.
4. When you wont to set the setting variable, type alt+e. (when not setting cmd variable, cmdclck automaticaly display setting variable's edit screen)
5. When finishing editing, type ctrl+enter.
6. Soon apear confirm screen, if it correct, type ctrl+enter if not, esc.

by editor

1. Move cursor to script file name you wonts edit by up or down.
2. Yype Alt+w or run shellscript when inputExecute in seting secttion is E.
3. Soon editor open the target script , then edit.
4. Come back cmdclick gui screen, and, type ctrl+enter.

description by gui

1. Move cursor to script file name you wonts edit by up or down.
2. Type Alt+W.
3. Soon cmdclick open description edit screen , then edit.
4. When finishing editing, type ctrl+enter.
5. Soon apear confirm screen, if it correct, type ctrl+enter if not, esc.

Delete

delete shellscript file

1. Move cursor to script file name you wonts edit by up or down.
2. Type Alt+d.
3. Soon cmdclick open delete screen , if it correct, type ctrl+enter if not, esc.

Exit

Exit cmdclick

1. Type esc.
   • Besides this, esc can exit all process (add, run, edit, delete)

Move

Move shellscript file to other app directory

1. Move cursor to script file name you wont to move by up or down.
2. Type Alt+m.
3. Soon cmdclick open app directory list.
4. Move cursor to app direcotry path name you wont to move by up or down. (if selecting current app directory, target file is copied)
5. Type enter.

Install

Install mean copy selected shellscript

1. Type Alt+i.
2. Soon cmdclick open file manager.
3. Select file you wont to install.
4. Soon cmdclick open app directory list.
5. Move cursor to app direcotry path name you wont to insert by up or down.
6. Type enter.

Setting

change setting in cmdclick

1. Type Alt+C.

2. Soon cmdclick open the setting gui, then set each column you wont to change.

   • bellow setting column detail

     | settingVariable| set value | description | | --------- | --------- | ------------ | | pasteAfterEnter | ON/OFF | after pasting cmd to terminal, whether to type enter | | pasteTargetTerminalName | terminal name | past target terminal app name | | openEditorCmd | editor cmd | editor command | | shiban | shell shiban | running shellscript's shiban | | runShell | shell name | run shell name |

   • pasteTargetTerminalName's example
     windows) WindowsTerminal, `ubu