CommandTrayHost 一个Windows命令行程序系统托盘管理工具

CommandTrayHost 一个Windows命令行程序系统托盘管理工具

CommandTrayHost

A command line program monitor systray for Windows

简体中文

Feature

json configuresystrayrun privileged childshow/hide enable/disable daemonmultiple command line programswhen CommandTrayHost quits, all child processes will be killed.Customize systray icon & console iconi18nMenu level limit is 40Multiple instance of startup and runningHotkeyCrontab

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, value 200 // STARTUPINFO.dwY, same as above ], "size": [ 0.5, // STARTUPINFO.dwXSize, as above 0.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 configs 1, ], }, { "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 \.

How to Build

Install VS2015 Update 3 or VS 2017Install vcpkgHook up user-wide integration, run (note: requires admin on first use) vcpkg integrate installInstall rapidjson and nlohmann::json. vcpkg install rapidjson rapidjson:x64-windows nlohmann-json nlohmann-json:x64-windowsOpen 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

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。