Differences
This shows you the differences between the selected revisions of the page.
| guide_osx 2014-04-04 | 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. |
| - | + | ||
| - | **IMPORTANT:** Note that the installation of WinSCP on Mac is not difficult. However, the whole process may take 30 minutes or more, as you need to install several 3rd party components. It is not an exercise recommended for absolute beginners. | + | |
| - | + | ||
| - | ===== 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-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" can't be opened because it is from an unidentified developer.// | + | |
| - | * To override your security settings and open the app anyway: | + | |
| - | * Click the WinSCP icon, while holding down the ''Control'' key. | + | |
| - | * Choose //Open// from the shortcut menu. | + | |
| - | * Click //Open//. | + | |
| - | * An exception for the WinSCP launcher app is saved 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 ===== | ===== Specifics of Using WinSCP on Mac/Wine ===== | ||
| Line 62: | Line 20: | ||
| ===== 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]]. |