Editing Octave for macOS

GNU Octave is primarily developed on GNU/Linux and other POSIX conformal systems. GNU Octave for MacOS X is readily available using [http://en.wikipedia.org/wiki/Package_management_system package managers] such as [http://www.finkproject.org/ Fink], [http://www.macports.org/ MacPorts], and [http://mxcl.github.com/homebrew/ Homebrew].

About version numbers (May 2012):
*The 3.6.x are current releases.
*The 3.4.x are previous releases.
*The 3.2.x are very old releases.

==Installing a MacOS X Bundle==

A reliable App bundle for Octave on MacOS is not presently available. The developers would like to be able to provide an App bundle, but need volunteers to support the effort.  An approach for producing an App Bundle using [http://www.macports.org MacPorts] is being documented [[Create a MacOS X App Bundle Using MacPorts|here]].  This approach shows promise, but a few problems must be resolved before a bundle will become available.

Octave and many other software packages may be installed and updated using one of the three package managers available for MacOS. To install using a package manager, see the section on [http://www.octave.org/wiki/index.php?title=Octave_for_MacOS_X&action=submit#Package_Managers Package Managers] below.

{{Warning|Octave-Forge does have [https://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary/ App bundles] for old Octave, versions and have problems running on MacOS 10.6 and above.  The latest App bundle does not provide full support for the printing, or the documentation features of Octave. Other features may be missing as well. For individuals who'd like to use it anyway please carefully follow the instructions for [[Installing MacOS X Bundle]].}}

==Manual Installation from Source==

The page [[Octave for Mac]] provides minimalistic instructions for building Octave from source on MacOS X. Additional [http://www.gnu.org/software/octave/support.html support] for those who need assistance in building Octave is available.

==Package Managers==

A package manager, is a collection of software tools to automate the process of installing, upgrading, configuring, and removing software packages for a computer's operating system in a consistent manner. It typically maintains a database of software dependencies and version information to prevent software mismatches and missing prerequisites.
Packages are distributions of software, applications and data. Packages also contain metadata, such as the software's name, description of its purpose, version number, vendor, checksum, and a list of dependencies necessary for the software to run properly. Upon installation, metadata is stored in a local package database.
Operating systems based on Linux and other Unix-like systems typically consist of hundreds or even thousands of distinct software packages; in the former case, a package management system is a convenience, in the latter case it becomes essential.

There are three reputable package managers available for MacOS X. GNU Octave for MacOS X is readily available using [http://en.wikipedia.org/wiki/Package_management_system package managers] such as [http://www.finkproject.org/ Fink], [http://www.macports.org/ MacPorts], and [http://mxcl.github.com/homebrew/ Homebrew].

The most recent version of Fink's Octave package, MacPorts' Octave port, and Homebrew's Octave formula are generally not the same. Please check the web sites for these package managers to determine if the version of Octave you desire is available.

===XCode Dependency===

Each package manager requires that XCode be installed. In part this is to provide an initial set of development tools. It *may* be possible to substitute the [https://github.com/kennethreitz/osx-gcc-installer MacOS X gcc Installer] by Kenneth Reitz, but this alternative has not yet been tested. If any curious/industrious users experiment with using Kenneth's solution over Apple's XCode, please let Octave's developers know of the results. Or, if you prefer, just update the itemized list below. It is recommended that users with XCode already installed avoid installing Kenneth's solution, as it may break your existing XCode installation.
* Fink: The MacOS X gcc Installer has not been tested.
* MacPorts: The MacOS X gcc Installer has not been tested.
* Homebrew: The MacOS X gcc Installer has not been tested.

===Fink===

[http://www.finkproject.org/ The Fink project] is an effort to port and package open-source Unix programs to MacOS X. Fink uses [http://en.wikipedia.org/wiki/Dpkg dpkg] and [http://en.wikipedia.org/wiki/Advanced_Packaging_Tool APT] ([http://en.wikipedia.org/wiki/Debian Debian's] package management system), as well as its own frontend program, fink (which is implemented as a set of [http://en.wikipedia.org/wiki/Perl_module Perl modules]).

====Simple Installation Instructions====

*Install XCode: This is done via the MacOS X App Store.
*Follow [http://www.finkproject.org/download/srcdist.php Fink's installation instructions].
*Fink has excellent support for Octave and includes recent as well as dated versions. A list of what Fink has available for Octave is [http://pdb.finkproject.org/pdb/browse.php?summary=octave here]. To install the latest Octave, type {{Codeline|<nowiki>sudo fink install octave</nowiki>}} at the Terminal's command line.  For those running the 64 bit version of Fink, it is recommended that {{Codeline|octave-atlas}} be installed instead as there are some bugs/features with Apple's vecLib for the X86_64 architecture.  Octave has many dependencies which will be downloaded and installed prior to Octave. The entire installation process can take a few hours.
* Fink should also be used to install [[http://octave.sourceforge.net/packages.php packages] for Octave.  For example, the control systems package for Lion may be installed by typing {{Codeline|fink install control-atlas-oct362}} at a terminals command line.

===MacPorts===

[http://www.macports.org/ MacPorts], formerly called DarwinPorts, is a package management system that simplifies the installation of software on the MacOS X and Darwin operating systems. It is a free/open source software project to simplify installation of other free/open source software. Similar in aim and function to Fink and the BSDs' ports collections, DarwinPorts was started in 2002 as part of the OpenDarwin project, with the involvement of a number of Apple Inc. employees including Landon Fuller, Kevin Van Vechten, and Jordan Hubbard.

====Simple Installation Instructions====

*Install XCode: This is done via the MacOS X App Store.
*Follow [http://www.macports.org/install.php MacPorts' installation instructions].
*MacPorts has good support for Octave. A list of what MacPorts has available for Octave is [http://www.macports.org/ports.php?by=name&substr=octave here]. To install the most recent version of Octave, type {{Codeline|<nowiki>sudo port install octave-devel</nowiki>}} at the Terminal's command line. Octave has many dependencies which will be downloaded and installed prior to Octave. The entire installation process can take a few hours.

===Homebrew===

Homebrew is a package management system that simplifies the installation of software on the Mac OS X operating system. It is a free/open source software project to simplify installation of other free/open source software. It is similar in aim and function to MacPorts and Fink. It was written by Max Howell and has gained popularity in the Ruby on Rails community and earned praise for its extensibility.

====Simple Installation Instructions====

*Install XCode: This is done via the MacOS X App Store.
*Follow [https://github.com/mxcl/homebrew/wiki/installation Homebrew's installation instructions].
*[http://mxcl.github.com/homebrew/ Homebrew] has good support for Octave. To install Octave, type {{Codeline|<nowiki>brew install octave</nowiki>}} at the Terminal's command line. Octave has many dependencies which will be downloaded and installed prior to Octave. The entire installation process can take a few hours.

==Create a launcher app with AppleScript==

* Open the "AppleScript Editor" application
* write the following text in the editor window:

<code>

 tell application "Terminal"
  do script "/path/to/octave; exit"
 end tell

</code>

or if Octave is in your default path:

<code>

 tell application "Terminal"
  do script "`which octave`; exit"
 end tell

</code>

* Select "Save as ..." from the "File" menu
* In the menu that appears, select "Application" from the "File format" menu, then navigate to the "Applications" folder and save your script there as "Octave.app"


To change the application icon 

* Open [http://www.octave.org/wiki/images/9/96/Icon.png this link] in a web browser, right-click an select "copy image"
* Select "Octave.app" in the Finder, then press command-i to bring up the file info dialog
* In the file info dialog select the icon and press command-v to paste the Octave icon over it