CommandTrayHost

A command line program monitor systray for Windows

简体中文

Feature

• json configure
• systray
• run privileged child
• show/hide enable/disable daemon
• multiple command line programs
• when CommandTrayHost quits, all child processes will be killed.
• Customize systray icon & console icon
• i18n
• Menu level limit is 40
• Multiple instance of startup and running
• Hotkey
• Crontab

Usage

Download or Mirrors

configure file name is config.json, in the same folder as CommandTrayHost.exe. Run once CommandTrayHost.exe, there will be a config.json with document. Supported encodings, UTF-8 UTF-8BOM UTF-16LE UTF-16BE UTF-32LE UTF32-BE.

example configure

{"configs": [{"name": "kcptun 1080 8.8.8.1:12345",// Menu item name in systray"path": "E:\\program\\kcptun-windows-amd64",// path which includes cmd exe, relative path is ok."cmd": "client_windows_amd64.exe -c client.json",// must contain .exe"working_directory": "",// working directory, for client.json path. relative to path usually. start with > symbol to use relative path from CommandTrayHost.exe"addition_env_path": "",//dll search path"use_builtin_console": false,//CREATE_NEW_CONSOLE"is_gui": false,"enabled": true,// run when CommandTrayHost starts// Optional"require_admin": false,// to run as administrator, problems keywords: User Interface Privilege Isolation"start_show": false,// whether to show when start process "ignore_all": false,// whether to ignore operation to disable/enable all"position": [0.2,// STARTUPINFO.dwX if not greater than 1, it means proportions to screen resolution. Greater than 1, value200// STARTUPINFO.dwY, same as above],"size": [0.5,// STARTUPINFO.dwXSize, as above0.5// STARTUPINFO.dwYSize, as above],"icon": "",// icon for console windows"alpha": 170,// alpha for console windows, 0-255 integer"topmost": false,// topmost for console windows// alt win shift ctrl 0-9 A-Z, seperated by space or +. You can also use "ALT+WIN+CTRL+0x20"// https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx"hotkey": {// you don't nedd to set up all"disable_enable": "Shift+Win+D",// disable/enable toggle"hide_show": "Shift+Win+H",// hide/show toggle"restart": "Shift+Win+R",// restart app"elevate": "Shift+Win+A",// elevate},"not_host_by_commandtrayhost": false,// if true, commandtrayhost will not monitor it"not_monitor_by_commandtrayhost": false,// if true, same as above. But quit with CommandTrayHost"kill_timeout": 200,// post a message to let program quit itself, if timeout killing the process"exclusion_id": 1,// kill all configs with same `exclusion_id` before to run current config. greater than 0."kill_process_tree": false,// kill all child process tree，for nginx},{"name": "kcptun 1081 8.8.8.1:12346","path": "E:\\program\\kcptun-windows-amd64","cmd": "client_windows_amd64.exe -c client.json","working_directory": "E:\\program\\kcptun-windows-amd64\\config2","addition_env_path": "","use_builtin_console": false,"is_gui": false,"enabled": true// Optional"crontab_config": {"crontab": "8 */2 15-16 29 2 *","method": "start",// start restart stop start_count_stop restart_count_stop"count": 0,// times to run, 0 infinite// Optional"enabled": true,"log": "commandtrayhost.log",// comment out this line to disable logging"log_level": 0,// log level 0 1 2"start_show": false,// comment out to use cache},"exclusion_id": 1,},{"name": "herokuapp","path": "C:\\Program Files\\nodejs","cmd": "node.exe local.js -s yousecret-id.herokuapp.com -l 1090 -m camellia-256-cfb -k ItsATopSecret -r 80","working_directory": "E:\\program\\shadowsocks-heroku.git",// We use a different working directory"addition_env_path": "","use_builtin_console": false,"is_gui": false,"enabled": true},{"name": "shadowsocks","path": "E:\\program\\shadowsocks","cmd": "Shadowsocks.exe","working_directory": "","addition_env_path": "","use_builtin_console": false,"is_gui": true,"enabled": false},{"name": "cow","path": "E:\\program\\cow","cmd": "cow.exe","working_directory": "","addition_env_path": "","use_builtin_console": false,"is_gui": false,"enabled": true},{"name": "aria2","path": "E:\\program\\aria2-win-64bit","cmd": "aria2c.exe --conf=aria2.conf","working_directory": "","addition_env_path": "","use_builtin_console": false,"is_gui": false,"enabled": true,"kill_timeout": 2000,// wait 2 seconds for saving aria2.session},{"name": "JeliLicenseServer","path": "E:\\program\\JeliLicenseServer","cmd": "JeliLicenseServer_windows_amd64.exe -u admin -l 127.0.0.251","working_directory": "","addition_env_path": "","use_builtin_console": false,"is_gui": false,"enabled": true},],"global": true,// Optional"require_admin": false,// To Run CommandTrayHost as Administrator// If you set it to true, maybe you will need https://stefansundin.github.io/elevatedstartup/ to add startup support"icon": "E:\\icons\\Mahm0udwally-All-Flat-Computer.ico",// Customize Tray Icon path// when empty, builtin default icon will be used. 256x256"icon_size": 256,// 256 32 16"cmd_menu_max_length": 0,// maximium character limit for cmd and path item in menu. 0 infinite"lang": "auto",// zh-CN en-US etc https://msdn.microsoft.com/en-us/library/cc233982.aspx"groups": [// groups is an array. Allowed element types are object and number.{"name": "kcptun",// object must have a name"groups": [0,// index of configs1,],},{"name": "shadowsocks","groups": [3,2,4,],},5,6,{"name": "empty test",// groups is optional for object, but name not.},],"enable_groups": true,"groups_menu_symbol": "+","left_click": [0,1],// left click on tray icon, hide/show configs index. Empty to hide/show CommandTrayHost"enable_cache": true,"conform_cache_expire": true,// hot reloading will be disabled, when setting it to false"disable_cache_position": false,"disable_cache_size": false,"disable_cache_enabled": true,"disable_cache_show": false,"disable_cache_alpha": false,// (only work for configs with alpha)// alt win shift ctrl 0-9 A-Z, seperated by space or +. You can also use "ALT+WIN+CTRL+0x20"// https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx"hotkey": {"disable_all": "Alt+Win+Shift+D","enable_all": "Alt Win + Shift +E","hide_all": "Alt+WIN+Shift+H","show_all": "AlT Win Shift s","restart_all": "ALT+Win+Shift+U","elevate": "Alt+wIn+Shift+A","exit": "Alt+Win+Shift+X","left_click": "Alt+Win+Shift+L","right_click": "Alt+Win+Shift+R",// work for any program of current user"add_alpha": "Alt+Ctrl+Win+0x26",// add alpha of current windows"minus_alpha": "Alt+Ctrl+Win+0x28",// Alt+Ctrl+Win+↑↓"topmost": "Alt+Ctrl+Win+T",// toggle topmost status"hide_current": "Alt+Ctrl+Win+H",// hide current window to tray menu"show_all_docked": "Alt+Ctrl+Win+S",// show all windows hiden by above hotkey},"repeat_mod_hotkey": false,// not work for XP"global_hotkey_alpha_step": 5,"show_hotkey_in_menu": true,"enable_hotkey": true,"start_show_silent": true,"auto_hot_reloading_config": false,// if true, it's same as automatically clicking clear cache prompt No button"auto_update": true,"skip_prerelease": true,"keep_update_history": false,}

Tips1: "cmd" must contain .exe. If you want to run a bat, you can use cmd.exe /c or cmd.exe /k.

Tips2: If you don't need privileged child, you can remove all "require_admin".

• CommandTrayHost run as an unprivileged user: you can run a privileged child process and restart it, but you cannot hide/show it. Because of User Interface Privilege Isolation.
• CommandTrayHost run as Administrator, everthing should work as you want. But you cannot use the builtin startup management.

Tips3: How to create ico format Here Or download from iconarchive.

Note: All paths must be "C:\\Windows" but not "C:\Windows". Json string will escape \<c>.

How to Build

1. Install VS2015 Update 3 or VS 2017
2. Install vcpkg
3. Hook up user-wide integration, run (note: requires admin on first use) vcpkg integrate install
4. Install rapidjson and nlohmann::json. vcpkg install rapidjson rapidjson:x64-windows nlohmann-json nlohmann-json:x64-windows
5. Open CommandTrayHost.sln, and build.

In order to make sure resource.h and CommandTrayHost.rc is checkouted in encoding UTF-16LE(UCS-2) with BOM. Before run git clone, you need to add following script to %USERPROFILE%\.gitconfig .

[filter "utf16"]clean = iconv -f utf-16le -t utf-8
smudge = iconv -f utf-8 -t utf-16le
required

Localization

See this file : CommandTrayHost/CommandTrayHost/language_data.h

Help wanted

• When restart process, keep the history standard output and standard error output in a ConsoleHelper. That's why there is a use_builtin_console. Maybe I have to inject some code to child process. ConEmu

• Elevated Startup

• UIPI (User Interface Privilege Isolation) Bypass. ChangeWindowMessageFilterEx

Thanks

phuslu/taskbar@lirener