Skip to content
A cross-platform (wxPython) GUI to launch a secure remote desktop (VNC over SSH) session for the MASSIVE Desktop - https://www.massive.org.au/userguide/cluster-instructions/using-the-massive-desktop or for the Characterisation Virtual Laboratory (CVL) - https://www.nectar.org.au/characterisation-virtual-laboratory. Because the Launcher is not sp…
Python C Shell TeX Objective-C CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
IconPngs
IconPys
cvlsshutils @ bd3e146
help
helpfiles
logger
menus
openssh-cygwin-stdin-build
pyinstaller-2.1
release
rpmbuild/SPECS
scripts
sikuli-tests
system_build_scripts
wsgidav
.gitignore
.gitmodules
DEPENDENCIES
GPL.txt
LICENSE
LauncherOptionsDialog.py
LoginTasks.py
MAC_DMG_BUILD.txt
MASSIVE Launcher.desktop
MASSIVE.icns
MASSIVE.ico
MASSIVE_icon.py
MASSIVElogo.png
MacMessageDialog.py
README
README_LINUX
WindowsMessageDialog.py
create_commit_def.py
create_mac_bundle.py
create_windows_bundle.py
dmgBackgroundMacOSX.png
import_remote_test_module.py
kill-charade-processes.bat
launcher.py
launcherWindowsSetupWizardScript.iss
launcher_progress_dialog.py
launcher_version_number.py
massive-launcher.desktop
massiveLauncher.sh
new_version_alert_dialog.py
optionsDialog.py
package_centos_version.sh
package_debian_version.sh
package_linux_version.sh
package_mac_version.py
package_ubuntu_version.sh
package_windows_version.bat
package_windows_version.py
questionDialog.py
test.py
test_module_for_remote_importing.py
utilityFunctions.py

README

#  MASSIVE/CVL Launcher - easy secure login for the MASSIVE Desktop and the CVL
#
# Copyright (c) 2012-2013, Monash e-Research Centre (Monash University, Australia)
# All rights reserved.
# 
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# any later version.
# 
# In addition, redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
# 
# -  Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 
# -  Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# 
# -  Neither the name of the Monash University nor the names of its
# contributors may be used to endorse or promote products derived from
# this software without specific prior written permission.
# 
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
# IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. SEE THE
# GNU GENERAL PUBLIC LICENSE FOR MORE DETAILS.
# 
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#
# Enquiries: James.Wettenhall@monash.edu or help@massive.org.au

MASSIVE/CVL LAUNCHER
====================

MASSIVE Desktop: https://www.massive.org.au/userguide/cluster-instructions/using-the-massive-desktop

CVL: https://www.nectar.org.au/characterisation-virtual-laboratory

MASSIVE/CVL Launcher is an attempt to offer MASSIVE/CVL users an easier login 
method, beginning with Mac OS X users.  Until TurboVNC v1.2, Mac OS X users had
to install TurboVNC, only to find that there was no double-clickable TurboVNC 
application in their Applications folder, so they had to run TurboVNC from the 
command-line after creating an SSH tunnel.  MASSIVE/CVL Launcher provides a 
double-clickable GUI launcher for MASSIVE users, which creates the SSH tunnel 
automatically, and then calls TurboVNC to launch the MASSIVE/CVL Desktop.  This
allows the user to launch the MASSIVE/CVL Desktop without having to use the 
command-line.

MASSIVE/CVL LAUNCHER CONFLUENCE DOCUMENTATION AND BUILD INSTRUCTIONS

https://confluence-vre.its.monash.edu.au/display/CVL/MASSIVE+Launcher+%28wxPython+client-side+GUI%29

PYTHON VERSION

A 32-bit version of Python is required to use wxPython. It is best to install
Python from python.org, rather than trying to use a pre-installed version
bundled with the operating system. James uses python-2.7.3-macosx10.3.dmg from 
Python.org.

WXPYTHON VERSION

The wxPython version you use must match the Python version being used 
(e.g. 2.7).  James uses wxPython2.8-osx-unicode-2.8.12.1-universal-py2.7 from 
http://wxpython.org/download.php 

ICON

The MASSIVE.icns icon file is for the Mac OS X operating system only. 
It was created using the free Img2icns application. http://www.img2icnsapp.com/
There is also a built-in Mac OS X application, Icon Composer. It used to live
in the /Applications/Utilities/ folder, or the /Developer/Applications/ folder.
Now you have to install Xcode first (from the App Store), then launch Xcode, 
and from the Xcode menu, choose "Open Developer Tool". The image used to create
the icon was taken as a screenshot (cmd-shift-4) from the MASSIVE website. The
white background was then made transparent, by using Gimp 2.8's 
"Color to Alpha..." menu item in the "Colors" menu. 

The create_mac_bundle.py script can be used to specify the icon file
(MASSIVE.icns), which will be included in MASSIVE.app/Contents/Info.plist by
the py2app module. The MASSIVE.icns file will be copied into
MASSIVE.app/Contents/Resources/ by the py2app module.

wxPython provides a handy tool (/usr/local/bin/img2py) for encoding a bitmap 
image (e.g. an icon) in a platform-independent Python script.  A Python version
of the MASSIVE icon has been created as MASSIVE_icon.py

Something went wrong with that request. Please try again.