• A tool to execute DCL scripts at a remote server -

What's Remote-DCL

Remote-DCL is a Ruby script to execute a script at a remote server. DCL calles in the script creates PNG images at the remote, and send them to local and then display the images. It avoids X connection between the local and the remote, so could reduce execution time.


Install / Download


% gem install remote-dcl


You can get from the git repository

% git clone

or the repository snapshot, <a href=“./remote-dcl-snapshot.tar.gz”>remote-dcl-snapshot.tar.gz</a>.



At remote server

If you do not use xvfb-run command, you should lounch Xvfb server before execution of remote-dcl. e.g.)

% Xvfb :99 -screen 0 640x480x8 -nolisten tcp

Note: xvfb-run command lounch Xvfb server internally, and the lounching is occuer at every execution of remote-dcl. It takes some seconds, so lounching Xvfb server by your self reduces execution time of remote-dcl.

At local

% remote-dcl [--display=] [--dir=] [--user=] [--password=] [--remote] server_name script_name [args]
  • server_name: server name at which the script is execued

  • script_name: script name which is executed at the remote server

  • display (optional): x server number of Xvfb (e.g. –display=:99) If this is ommited, xvfb-run comand is used.

  • dir (optional): directory name of the remote server at which the script is executed If this is ommited, the script is executed at the home directory.

  • user (optional) user name of remote server for ssh connection. User name can be specified by [email protected]_name format as server_name

  • password (optional) password of user for ssh connection If this is ommited, password is asked in prompt.

  • remote (optional): If –remote option is set, the script should be at the remote server, otherwise at local.

User Interface

Actions with key and mouse events are the followings:

  • return key, space key, mouse click: go the next frame

  • “s” key: skip wait and go the next frame automatically

  • “q” key: quit