executeMenuCommand() Command List

[jduncan]

While building Ai Command Palette I found a great list of executeMenuCommand() values extracted by Shalako Lee from the 2017 SDK. As you might imagine, some of those commands no longer work, and since I'm about to release v0.2.0 of Ai Command Palette I've been testing them all and keeping track of the results in this Google Sheet.

I'm sharing this here because I figured this might be useful to some of you who write scripts for Illustrator. The sheet includes the Original List of commands from Shalako and a working list of the commands that I'm testing in Ai v26.3.1.

Right now I'm about halfway through the original 506 commands from Shalako's list. So far, I've found about 90 that no longer work. I've also updated any verbiage that may have changed in the menu system (since 2017) and updated the ordering to match Ai v26.3.1.

I also, made a simple script to test the commands below if you want to test any yourself. I'm trying to test each command in context to ensure they are working correctly.

Let me know if you have any other that I may have missed... Cheers!

P.S. There is another list on this forum (posted in 2014) that I have yet to review but I am aware of it and plan to compare it with Shalako's.

var result = prompt("Enter Command To Test", "", "Test Built-In Commands");

try {
  app.executeMenuCommand(result);
} catch (e) {
  alert("Error executing command:\n" + result + "\n\n" + e);
}

[schroef]

Perhaps a simple escape key press will work. But doing the save action is not possible. 

You can try to record an action. If that works, than you can convert the action to something which can be added in a script.

I've done this with some items. But if it can be recorded, it can't be done.

If you need to more info about adding an action into script let me know

[sttk3]

Found new commands in Illustrator v28.6; no additions in v28.7.

menu	key	note
File > Generate Vectors (Beta)	Generate Modal File Menu	Note that there is a space after 'Menu'. Added from v28.6
Object > Gen Shape Fill (Beta)	Shape Fill Object Menu	Added from v28.6
Window > Generate Patterns (Beta)	Adobe Generative Patterns Panel	Added from v28.6

[jduncan]

Awesome, I'll get these added to my script. Thanks as always @sttk3!

[CarlosCanto]

thanks sttk3!

[sttk3]

Found new commands in Illustrator v29.0.

menu	key	note
Object > Objects on Path > Attach	Attach Objects on Path	Added from v29.0
Object > Objects on Path > Options	Options Objects on Path	Added from v29.0
Object > Objects on Path > Expand	Expand Objects on Path	Added from v29.0
Window > Type > Reflow Viewer	ReflowWindowMenu	Added from v29.0. East asian feature

And a tool.

tool	key	note
Objects on Path	Adobe Constraints Tool	Added from v29.0

[jduncan]

@sttk3, you are the BEST! Commands have been added to my sheet and AiCommandPalette v0.11.3. Thanks for your great work!

[Raymond ZJH]

Awe inspiring, that's what I'm looking for.👍👍

[krasnovpro · Accepted solution]

There is my list for app.executeMenuCommand('command'),

with some plugins and parm error:

https://www.dropbox.com/s/kr426jos9gw09ko/menu.txt?dl=0

And app.selectTool('command'):

https://www.dropbox.com/s/qjivaj753y1egwl/tool.txt?dl=0

[jduncan]

Another great list! I went through all of yours and added the ones I didn't have. Thanks so much!

[rcraighead]

I was not aware of the "app.selectTool()" command! Thank you.

[krasnovpro]

Command has been updated to AI 2023.

Also, maybe someone will need a list of aliases – commands from the kys file and their counterparts for executeMenuCommand:

https://www.dropbox.com/s/0rl0lzy6a1aswoh/kysalias.txt?dl=0

[CarlosCanto]

thanks for the update!

[krasnovpro]

I thought a bit and made a draft of the commands change log:

https://www.dropbox.com/s/nkzyv483dr4tx0t/modifiedcommands.json?dl=0

The log is inaccurate, but perhaps someone will clarify and supplement it.

[jduncan]

Yeah, so I built a new spreadsheet for my latest version of Ai Command Palette which you can see here. It has the min and max versions for menu and tool commands that I was last aware of. I plan to go through your list and add them there as well. It has a bunch of other stuff, including the localization for DE and RU. This python script I created ingests these spreadsheets (as CSV's) and creates JavaScript objects very similar to your last post (see below).

Ai Command Palette uses this to know which menu commands and tools should be available for each user depending on their system. It would be great if we could all work together to try and complete this list as much as possible. I did a bunch of testing for the last version and plan to do the same for this one when I have time.

// generated localized commands data object
{
  tool: {
    "tool_Adobe Add Anchor Point Tool": {
      action: "Adobe Add Anchor Point Tool",
      type: "tool",
      minVersion: 24,
      maxVersion: null,
      loc: {
        en: "Add Anchor Point Tool",
        de: "Ankerpunkt-hinzufügen-Werkzeug",
        ru: "Добавить опорную точку Инструмент",
      },
    },
  },
  // ...
}

[jduncan]

@krasnovpro, I went through your updated lists and got everything I didn't have added to my spreadsheet. Ai Command Palette is updated with these in v0.4.1 too. Thanks!

[笠間38198967ieha]

The app.selectTool command for AstuteGraphicsPlugins doesn't seem to work. When I tested it, it caused Adobe Illustrator 2024 to crash. I used the command from your tool.txt file: app.selectTool('AG Dynamic Shapes');`, but it didn't work even though the plugin is installed. Could there be an error in the documentation?

[krasnovpro]

Correct code:

app.selectTool('Dynamic Shapes Tool');

Read the file more carefully.

[笠間38198967ieha]

Where did you find these tool names, I have another aip plugin but I don't know the tool names for it!

[krasnovpro]

Go to Edit → Keyboard Shortcuts.

Bind your tool to the 0 (zero key).

Save set with name test.

Run Notepad and open this file:

%AppData%\Adobe\Adobe Illustrator 28 Settings\en_US\x64\test.kys

(fix the path if you have a different version or locale).

Find all occurrences of /Key 48.

One of them will look something like this:

	/Snap\ To\ Collisions\ Tool {
		/Context 0
		/Modifiers 0
		/Represent 48
		/Key 48
	}

Remove the leading slash and all backslashes, and you get the command name.

In this example, it's Snap To Collisions Tool.

Now you can use it with app.selectTool.

[CarlosCanto]

awesome work, thanks to all that contributed to put the list together.

[Disposition_Dev]

So many great resources here. Thanks to everyone for contributing and compiling these lists and even testing them in different versions.

On the topic of menu commands, my biggest gripe has always been the naming convention of the commands. In many cases, the argument required for app.executeMenuCommand() is cryptic, nonsensical, or not at all descriptive of what the command does. Additionally, the variable naming convention makes it very difficult to remember how to format the argument for the command you need. And incorrectly formatting your menu command argument brings about the dreaded MRAP/PARM. 

Would there be any interest in, or do you think you might use some kind of framework for app.executeMenuCommand() allowing the freedom to effectively namespace "app.executeMenuCommand" with a custom function name (personally, id choose emc("commandName"); but any user could choose whatever function name they want. Then within the function, the custom arguments are assigned to the appropriate argument for executeMenuCommand(). Errant arguments could also be handled more gracefully and with more useful info than a generic mrap.

This also gives freedom to the user to customize their command/argument pairs to best suit their workflow. As an example, to select all same fill colors, the default argument is "Find Fill Color menu item" in a frustrating variable letter case scheme.. I'd like to call that command with emc("sameFill"); so in my emc() function, i'd assign "sameFill" to "Find Fill Color menu item", then input the appropriate argument into executeMenuCommand();

It would also be possible to include custom logic before/after the actual menu command for certain commands. As an example, the live pathfinder effects often need to be expanded. But not always. emc() could accept another argument for enabling or disabling the paired functionality, or even just passing it in as one of the parameters. perhaps an object literal for feeding custom params to different functions.

You could also bind multiple menu commands together for common tasks, all while keeping your main code nice and tidy (a big priority of mine after many years of writing disgusting spaghetti code) with menu command arguments that make sense to YOU and are customizable for your own workflow.

If optimization is desired.. I.E, not including a giant function with 500+ commands to every script just so you can use one or two.. The commands could be split into smaller chunks by category like "File", "Edit", etc. Or even compact custom sets for production that only include the commands your code actually uses.

What do you guys think? I know extendscript/scripting-as-we-know-it is dying anyway and transitioning to UXP.. But I think this would be a pretty straightforward build that could still be useful in the interim.

[Sergey Osokin]

Small emc() chunks can be manually written for the current task. I haven't seen any scripts that use a lot of different app.executeMenuCommand().

ES will not die as long as there are users of old versions of Illustrator. And there are a lot of them, because Adobe updates are unpredictable, break paid plugins and user workflow.

[EyeballDoc]

Thank you so much for all your work!

[schroef]

Nice, i jsut noticed that some columns are hidden For instance the English column

[jduncan]

Hmm, I'm not sure why they were hidden. There were some columns also missing for additional languages. The linked Google Sheet pulls from another Google Sheet where I track more stuff for one of my projects and I had an error in the importrange formula. Cheers!