Mac OS X

2023-07-17T13:13:37Z

Alfla: /* Building from source using Homebrew */

This page describes how to build the sigrok subprojects on Mac OS X.

== Binary Disk Images (DMG) ==

We provide nightly Mac OS X disk image files (DMG) for [[PulseView]] and [[sigrok-cli]] (64bit x86 only; require OSX 10.9 Mavericks or higher). Please test and [http://sigrok.org/bugzilla/ report] any issues you encounter.

<gallery widths="120px" heights="70px" perrow="5">
File:Pulseview macosx dmg.png
File:Pulseview macosx.png
</gallery>

Downloads:

* [https://sigrok.org/download/binary/pulseview/PulseView-NIGHTLY.dmg Pulseview-NIGHTLY.dmg]
* [https://sigrok.org/download/binary/sigrok-cli/sigrok-cli-NIGHTLY.dmg sigrok-cli-NIGHTLY.dmg]

The files are self-contained and ship with all required libraries, decoders and all freely distributable firmware files.

If you need to provide additional firmware files, you can copy them to any of the standard paths where [[libsigrok]] searches for firmware files. See [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] for details.

== Building from source ==

'''Note:''' This should generally not be necessary for users, please just use the provided [[Mac_OS_X#Binary_Disk_Images_.28DMG.29|nightly installers]] (see above).

=== Building from source using Homebrew ===
This is the recommended way of building sigrok from source on Mac OS X.

Install [http://brew.sh Homebrew] (not covered here, see Homebrew docs for details) and all sigrok build dependencies:


$ '''brew install libzip libftdi libusb libtool glibmm doxygen autoconf-archive sdcc python3 boost qt pkg-config cmake glib autoconf automake swig check'''


Clone [http://sigrok.org/gitweb/?p=sigrok-util.git sigrok-util]:


$ '''git clone git://sigrok.org/sigrok-util'''
$ '''cd sigrok-util/cross-compile/macosx'''
$ '''./sigrok-native-macosx'''


This script will download all the code, compile and install it in the '''$HOME/sr_macosx''' directory.

To conveniently use the tools you need to export the additional path.


$ '''export PATH=$HOME/sr_macosx/bin:$PATH'''


=== Building from source using MacPorts ===

Not supported by us. Please use one of the methods described above.

While it shouldn't be too much work to adapt the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script to also work for [https://www.macports.org/ MacPorts], this is currently not recommended or supported. Patches to support both Homebrew and MacPorts in that script are welcome, though.

=== Building from source manually ===

Not supported by us. Please use one of the methods described above.

While this is technically possible if you know what you're doing, we don't recommend or support it. It's a lot easier to use the provided DMG files or build using the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script (see above).

=== Building from source using existing Homebrew packages/taps ===

Not supported by us. Please use one of the methods described above.

There are various Homebrew recipies for sigrok, e.g. in [https://github.com/Homebrew/homebrew-science homebrew-science] or in [https://github.com/rene-dev/homebrew-sigrok rene-dev's homebrew-sigrok repo]. However, none of them are officially maintained or recommended or supported by us, and they might be incomplete and/or outdated, YMMV.

Mac OS X

2023-07-17T13:13:06Z

Alfla: /* Building from source using Homebrew */

This page describes how to build the sigrok subprojects on Mac OS X.

== Binary Disk Images (DMG) ==

We provide nightly Mac OS X disk image files (DMG) for [[PulseView]] and [[sigrok-cli]] (64bit x86 only; require OSX 10.9 Mavericks or higher). Please test and [http://sigrok.org/bugzilla/ report] any issues you encounter.

<gallery widths="120px" heights="70px" perrow="5">
File:Pulseview macosx dmg.png
File:Pulseview macosx.png
</gallery>

Downloads:

* [https://sigrok.org/download/binary/pulseview/PulseView-NIGHTLY.dmg Pulseview-NIGHTLY.dmg]
* [https://sigrok.org/download/binary/sigrok-cli/sigrok-cli-NIGHTLY.dmg sigrok-cli-NIGHTLY.dmg]

The files are self-contained and ship with all required libraries, decoders and all freely distributable firmware files.

If you need to provide additional firmware files, you can copy them to any of the standard paths where [[libsigrok]] searches for firmware files. See [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] for details.

== Building from source ==

'''Note:''' This should generally not be necessary for users, please just use the provided [[Mac_OS_X#Binary_Disk_Images_.28DMG.29|nightly installers]] (see above).

=== Building from source using Homebrew ===

'''Linking pulseview fails on osx with glib 2.58 [https://sigrok.org/bugzilla/show_bug.cgi?id=1281 Bug 1281]. glib 2.56.1 is known to work.'''

This is the recommended way of building sigrok from source on Mac OS X.

Install [http://brew.sh Homebrew] (not covered here, see Homebrew docs for details) and all sigrok build dependencies:


$ '''brew install libzip libftdi libusb libtool glibmm doxygen autoconf-archive sdcc python3 boost qt pkg-config cmake glib autoconf automake swig check'''


Clone [http://sigrok.org/gitweb/?p=sigrok-util.git sigrok-util]:


$ '''git clone git://sigrok.org/sigrok-util'''
$ '''cd sigrok-util/cross-compile/macosx'''
$ '''./sigrok-native-macosx'''


This script will download all the code, compile and install it in the '''$HOME/sr_macosx''' directory.

To conveniently use the tools you need to export the additional path.


$ '''export PATH=$HOME/sr_macosx/bin:$PATH'''


=== Building from source using MacPorts ===

Not supported by us. Please use one of the methods described above.

While it shouldn't be too much work to adapt the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script to also work for [https://www.macports.org/ MacPorts], this is currently not recommended or supported. Patches to support both Homebrew and MacPorts in that script are welcome, though.

=== Building from source manually ===

Not supported by us. Please use one of the methods described above.

While this is technically possible if you know what you're doing, we don't recommend or support it. It's a lot easier to use the provided DMG files or build using the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script (see above).

=== Building from source using existing Homebrew packages/taps ===

Not supported by us. Please use one of the methods described above.

There are various Homebrew recipies for sigrok, e.g. in [https://github.com/Homebrew/homebrew-science homebrew-science] or in [https://github.com/rene-dev/homebrew-sigrok rene-dev's homebrew-sigrok repo]. However, none of them are officially maintained or recommended or supported by us, and they might be incomplete and/or outdated, YMMV.

sigrok - User contributions [en]

Mac OS X

Mac OS X