Download Links
shell (fat 32/64-bit) shell (UB 32-bit)

Bill Orcutt’s shell object: execute shell commands via this excellent Max object

Mac OSX (Intel, Fat 32/64-bit) + source code (for Max 6.1.0 and newer)
(last update: 13 March 2013)

old PPC/Intel 32-bit Universal Binary version remains available (for Max 6.0.x and older)
(last update: 15 August 2006)

Dec 29 2010 | 4:54 pm

I was curious about this. Does this shell object allow me to interact with the terminal shell (the way pd shell does)?

Jul 11 2013 | 11:43 am

sadly, "top" doesn’t work (anymore?) for the shell-external. Bug? Feature? ;)

Jul 15 2013 | 1:46 am

Quickly examining the code after an absence of many years and with fresh eyes, it looks to me like this object needs some serious love. I’ll try to find some time to do a major rewrite in the coming weeks. ‘top’ is a special case because it’s an interactive command and not a simple "read" operation. But using some of the advanced technologies in the uci chess object, in particular pseudoterminals, it should be possible to support that and more. Let’s see how it goes.

Jul 31 2013 | 10:59 am

killall also doesn’t work

Jul 31 2013 | 12:08 pm

seems that if i open ssh pi@ "omxplayer /home/pi/Desktop/pd_player/error/" for example then any other message wont work while clip is playing.. not only ssh -l pi "killall omxplayer.bin"

do i do something coplitely wrong here?

Jul 31 2013 | 12:10 pm

I’m sure this is the result of the general oldness and semi-awkwardness of some of this code. When I get a chance for a rewrite, I’ll post in the forum. Thanks!

Jul 31 2013 | 12:49 pm

thanks… but seems that problem is between my ears.. if i open this command in terminal.. even then i cant kill it from the same window..
is there option to open 2 shell objects like 2 different terminal windows?

Jul 31 2013 | 12:51 pm

Well… you could have 2 copies of the shell object. Or… you could put an ‘&’ at the end of your command to put it into the background on launch. Then shell won’t block for the next command. In theory, not tested.

Jul 31 2013 | 12:55 pm

like in terminal.. there is this ttys002 and ttys001 system..

Aug 02 2013 | 2:36 am

& didn’t work in practice.. but i did script where i ssh-d the player, waited a sec and killall ssh.. after that you can stop the movie! works!! keep up good work!

Apr 25 2014 | 4:32 pm

Could you pls post a help file for your shell mxo file? Thanks.

Dec 02 2014 | 11:43 pm

Hi Jeremy,
Thank you for the fantastic object, it works fine except that I have an issue with pstoedit ( the command for running that via Mac terminal is: pstoedit -f hpgl ~/Documents/test.pdf > ~/Documents/output1.hpgl But when I try doing this with shell it outputs an empty .hpgl file, is there anyway I can fix that?

Thank you

Mar 27 2015 | 2:35 am

is the shell object available for windows7?

Nov 14 2015 | 5:57 am

Hello Jeremy,

Sorry for my English

I need to do a command « minimize patch » in Max Msp
I look and I do not find in Max
I think it’s possible to command « minimize patch » with object shell
But I don’t understand script message for shell?

can you help me?

Best Regard
Serge from Paris

— Pasted Max Patch, click to expand. —
Nov 15 2015 | 4:44 am

Serge, this should do it. You may have to adjust your accessibility settings to allow Max to control your system.

All the best to you and everyone in Paris, brother.

— Pasted Max Patch, click to expand. —
Nov 15 2015 | 5:12 am

Whoops.. the above patch minimizes all open windows. Here is the script to minimize the current active window.

— Pasted Max Patch, click to expand. —
Nov 15 2015 | 10:06 am

Thank you MetaMax!
all is OK! It is great!
Thank you for Paris, the life is strong

Jan 06 2016 | 4:10 am

I’m trying to get this command line tool to work inside max:
Is it possible ?


Apr 17 2016 | 12:31 am


I’ve heard about this new feature in Windows 10 :

Is there any plan to port the shell object for windows users now? I’m developing on Mac, in particular a library using shell to run LISP code with SBCL and displaying the results with the bach library. Since SBCL is available on Windows as well, a bridge would be really welcome… :)

All the best


Viewing 20 posts - 1 through 20 (of 20 total)

Explore More

Subscribe to the Cycling ’74 Weekly Newsletter

Let us tell you about notable Max projects, obscure facts, and creative media artists of all kinds.

* indicates required