Differences
This shows you the differences between the selected revisions of the page.
| 2014-04-01 | 2014-04-01 (current) | ||
| winscp.app (martin) | moving to guide_osx (martin) | ||
| Line 1: | Line 1: | ||
| - | ~~NOINDEX~~ | ||
| - | |||
| - | ====== Running WinSCP on OS X in Wine ====== | ||
| - | There is no native version of WinSCP for OS X. WinSCP can run on Mac in Wine though. [[http://www.winehq.org/|Wine]] allows running Windows application on other platforms, including Apple OS X. | ||
| - | |||
| - | &screenshotpict(osx_commander) | ||
| - | |||
| - | This article shows how to install Wine on Mac, using [[http://brew.sh/|HomeBrew]]. HomeBrew is a package manager, which simplifies building packages from source code. Wine is one of such packages. To build packages, Xcode Command Line Tools are also needed. The last missing piece is [[https://xquartz.macosforge.org/|XQuartz]], X Window System, that Wine uses for GUI programs like WinSCP. | ||
| - | |||
| - | ===== Installing WinSCP on Mac ===== | ||
| - | |||
| - | * Install HomeBrew, by opening terminal and running \\ ''%%ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"%%'' | ||
| - | * Once we are in terminal, install the Xcode Command Line Tools by running: \\ ''xcode-select -install'' | ||
| - | * [[http://xquartz.macosforge.org/|Download]] and install the latest XQuartz. | ||
| - | * Install Wine from terminal by running: \\ ''brew install wine'' \\ \\ &screenshotpict(osx_wine_install) \\ \\ | ||
| - | * [[&download|Download]] WinSCP installation package. | ||
| - | * And run it from terminal using Wine: \\ ''wine ~/Downloads/winscp&winscp_stable_version_filesetup.exe'' \\ \\ &screenshotpict(osx_winscp_install) \\ \\ | ||
| - | * Follow [[installation#running|installer instructions]]. | ||
| - | * Wine creates ''WinSCP.desktop'' icon on desktop. It does not work on OS X. Remove it and see next section for creating WinSCP icon. | ||
| - | |||
| - | ===== Adding WinSCP Icon to the Dock ===== | ||
| - | |||
| - | ==== Download WinSCP Launcher App ==== | ||
| - | |||
| - | To add WinSCP icon to the Dock, you can use our WinSCP launcher app: | ||
| - | |||
| - | * [[this>../../download/WinSCP.app|Download the app]]. | ||
| - | * Drag and drop it to the //Dock//. | ||
| - | * Try to run it. | ||
| - | * It gets blocked as our launcher is not signed. The message is : //"WinSCP.app" can't be opened because it is from an unidentified developer.// | ||
| - | * Now go to //System Preferences > Security & Privacy//; On //General// tab click //Open Anyway// next to message //"WinSCP.app" was blocked from opening because it is from from an identified developer//. | ||
| - | * Now you should be able to run the app (You will probably be asked to allow running application downloaded from Internet, the first time only). | ||
| - | |||
| - | ==== Manually Creating Automator Application ==== | ||
| - | |||
| - | Alternatively, you can create your own launcher app, using [[wp>Automator_(software)|Automator]]: | ||
| - | |||
| - | * Launch //Automator//. You can do it by opening //Launchpad//, typing "Automator" in the search field and then clicking the icon of "Otto" the Automator robot. | ||
| - | * A new Automator workflow window will appear. If not click //New// in the //File// menu. | ||
| - | * Choose //Application// document type. | ||
| - | * Add new action //Run Shell Script// and write following to the editor window: \\ ''/usr/local/bin/wine ~/.wine/drive_c/Program\ Files/WinSCP/winscp.exe'' \\ \\ &screenshotpict(osx_automator_run) \\ \\ | ||
| - | * Test the script by using the //Run// button. WinSCP should be started. | ||
| - | * Save the script as an application //WinSCP// in the //Applications// folder and quit //Automator//. | ||
| - | * Find //WinSCP// in the //Applications// folder. Drag and drop it to the //Dock//. Now you can run WinSCP from the //Dock//. | ||
| - | |||
| - | ===== Specifics of Using WinSCP on Mac/Wine ===== | ||
| - | |||
| - | Contrary to Windows drive letters, OS X presents file system in virtual single hierarchy. This hierarchy in accessible in Wine (and as a consequence in WinSCP too) under ''Z:'' drive letter. For example user's home folder is accessible on ''Z:\Users\username'' path and user's //Documents// folder on ''Z:\Users\username\Documents'' path. | ||
| - | |||
| - | ===== Further Reading ===== | ||
| - | |||
| - | * [[http://appdb.winehq.org/objectManager.php?sClass=application&iId=1285|WinSCP entry on Wine AppDB]]. | ||