This project contains an example of an application for Mac that employs the Lightstreamer macOS Client library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
StockList Demo for macOS.xcodeproj
StockList Demo for macOS

Lightstreamer - Basic Stock-List Demo - macOS Client

This project contains an example of an application for Mac that employs the Lightstreamer macOS Client library.

Live Demo


View live demo

(download "StockList Demo for OS"; unzip it; launch "StockList Demo for macOS")


This app, compatible with macOS, is an Objective-C version of the Stock-List Demos.

This app uses the macOS Client API for Lightstreamer to handle the communications with Lightstreamer Server. A simple user interface is implemented to display the real-time data received from Lightstreamer Server.


If you want to install a version of this demo pointing to your local Lightstreamer Server, follow these steps:

  • Note that, as prerequisite, the Lightstreamer - Stock- List Demo - Java Adapter has to be deployed on your local Lightstreamer Server instance. Please check out that project and follow the installation instructions provided with it.
  • Launch Lightstreamer Server.
  • Download the file, which you can find in the deploy release of this project and extract the StockList Demo for folder.
  • Launch "StockList Demo for macOS". The Gatekeeper may signal the app is not signed. You can safely run the app or rebuild it with the included Xcode project.


To build your own version of the demo, instead of using the one provided in the file from the Install section above, you need to install CocoaPods to handle the project dependency on the Lightstreamer macOS client library (see also the Lightstreamer Compatiblity Notes below).

Follow these steps:

  • open a terminal and run the following command:
$ sudo gem install cocoapods
  • cd into the directory where you downloaded this project and run the following command:
$ pod install
  • CocoaPods should now resolve the dependency on the Lightstreamer macOS client library and prepare a workspace for you.

Done this, open the workspace with Xcode and it should compile with no errors. In case of errors during dependency resolution, you can find more information on CocoaPods official website.


With the current settings, the demo tries to connect to the demo server currently running on Lightstreamer website.
The demo can be reconfigured and recompiled to connect to the local installation of Lightstreamer Server. You just have to change SERVER_URL, as defined in StockList Demo for macOS/StockListWindowController.m; a ":port" part can also be added. The example requires that the QUOTE_ADAPTER has to be deployed in your local Lightstreamer server instance; the LiteralBasedProvider is also needed, but it is already provided by Lightstreamer server.

See Also

Lightstreamer Adapters Needed by This Demo Client

Related Projects

Lightstreamer Compatibility Notes

  • Code compatible with Lightstreamer macOS Client Library version 3.0.0-beta or newer.
  • Ensure that macOS Client API is supported by Lightstreamer Server license configuration. Server compatibility depends on the macOS Client Library in use, which is specified in the Podfile:
    • By default the project uses macOS Client Library version 4.0.0, which requires a Server version 7.0 or newer.
    • Use macOS Client Library version 3.0.1 for compatibility with Server version 6.1.
  • For a version of this example compatible with Lightstreamer macOS Client API version 1.x, please refer to this tag.