clip gain reduction macro

this should do it:

sf.ui.proTools.appActivateMainWindow();

// separate Clip
sf.ui.proTools.menuClick({
    menuPath: ["Edit","Separate Clip","At Selection"],
});

//press shortcut for lowering clip gain (3x  for -18 - assuming clip gain nudge is set for 6 db increments)
sf.keyboard.press({
    keys: "ctrl+shift+down",
    repetitions: 3,
    fast: true,
});

//extend start of selection 
sf.keyboard.press({
    keys: "alt+shift+numpad minus",
});

// extend end of selection
sf.keyboard.press({
    keys: "cmd+shift+numpad plus",
});

//create fades (this assumes that your default fade settings are correct)
sf.keyboard.press({
    keys: "f",
});

// move start of selection to original position
sf.keyboard.press({
    keys: "alt+shift+numpad plus",
});

// move end of selection to original position
sf.keyboard.press({
    keys: "cmd+shift+numpad minus",
});

Hi! Fairly new at this, and very very eager to learn ways to do this better. But here's how I've been doing this so far:

Pro Tools has a shortcut for nudging clip gain: Shift Control Up-Arrow, or Shift Control Down-Arrow. It nudges based on the value you have set in Preferences... Editing...

So I built a very basic macro using Press Keys to essentially put that pre-existing PT shortcut into a stream deck button. It'll nudge the clip gain for the region, or part of a region, you have highlighted.

The script looks like this:

sf.keyboard.press({
keys: "ctrl+shift+down",
});

My next step is to do the same with the PT shortcut to fade/cut the clip gain line, (shift control x). This is basically what Command X does to a volume automation line, like when you want to smooth out a vertical automation move, but to do it in the clip gain line, the shortcut is shift control x, which is more fun to press via one stream deck button than the awkward claw shaped movement for the hand to make over the keyboard :)