Differences
This shows you the differences between the selected revisions of the page.
| guide_osx 2014-04-02 | guide_osx 2019-03-28 (current) | ||
| Line 2: | Line 2: | ||
| ====== Running WinSCP on OS X in Wine ====== | ====== 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. | + | There is no native version of WinSCP for OS X. WinSCP can run on Mac in Wine though. [[https://www.winehq.org/|Wine]] allows running Windows application on other platforms, including Apple OS X. |
| &screenshotpict(osx_commander) | &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. | + | WinSCP can be run using Wine installed from [[·http://winebottler.kronenberg.org/downloads | WineBottler project ]] (search for standalone Wine download) or installed by [[http://brew.sh/|HomeBrew]]. We recommend the WineBottler project for its simplicity. After installing wine download [[this>../../download/winscp553wineosx.zip | WinSCP.app ]] unpack using Archiver and move to the Applications folder -- WinSCP.app is ready now. |
| - | ===== Installing WinSCP on Mac ===== | + | ===== Specifics of Using WinSCP on Mac/Wine ===== |
| - | ··* Install HomeBrew, by opening terminal and running \\ ''%%ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"%%'' | + | ==== Drive Letters ==== |
| - | * 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 ===== | + | 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. |
| - | ==== Download WinSCP Launcher App ==== | + | ==== Keyboard Shortcuts ==== |
| - | To add WinSCP icon to the Dock, you can use our WinSCP launcher app: | + | Remember that even on Mac, in WinSCP you need to use the ''Ctrl'' key instead of the ''Cmd'' key, e.g., ''Ctrl+X'' for //Cut//, ''Ctrl+C'' for //Copy//, ''Ctrl+V'' for //Paste//. |
| - | + | ||
| - | * [[this>../../download/WinSCP-wine-1.0.zip|Download the app]] and unpack by double-clicking downloaded zip archive. | + | |
| - | * Drag and drop unpacked WinSCP launcher app to the //Applications// folder, now drag it from there 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.// To override your security settings and open the app anyway: | + | |
| - | * Press the Control key, then click the app icon. | + | |
| - | * Choose Open from the shortcut menu. | + | |
| - | * Click Open. | + | |
| - | * The WinSCP launcher app is saved as an exception to your security settings, and you will be able to open it in the future by double-clicking it, just like any registered app. | + | |
| - | + | ||
| - | + | ||
| - | ==== 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 ===== | ===== Further Reading ===== | ||
| - | * [[http://appdb.winehq.org/objectManager.php?sClass=application&iId=1285|WinSCP entry on Wine AppDB]]. | + | * [[https://appdb.winehq.org/objectManager.php?sClass=application&iId=1285|WinSCP entry on Wine AppDB]]. |