Latest 11.0.0
License MIT
Platforms ios 8.0, osx 10.10, tvos 9.0, requires ARC
Dependencies StarscreamSocketIO

Build Status


Socket.IO-client for iOS/OS X.


import SocketIO

let socket = SocketIOClient(socketURL: URL(string: "http://localhost:8080")!, config: [.log(true), .compress])

socket.on(clientEvent: .connect) {data, ack in
    print("socket connected")

socket.on("currentAmount") {data, ack in
    if let cur = data[0] as? Double {
        socket.emitWithAck("canUpdate", cur).timingOut(after: 0) {data in
            socket.emit("update", ["amount": cur + 2.50])

        ack.with("Got your currentAmount", "dude")


Objective-C Example

@import SocketIO;
NSURL* url = [[NSURL alloc] initWithString:@"http://localhost:8080"];
SocketIOClient* socket = [[SocketIOClient alloc] initWithSocketURL:url config:@{@"log": @YES, @"compress": @YES}];

[socket on:@"connect" callback:^(NSArray* data, SocketAckEmitter* ack) {
    NSLog(@"socket connected");

[socket on:@"currentAmount" callback:^(NSArray* data, SocketAckEmitter* ack) {
    double cur = [[data objectAtIndex:0] floatValue];

    [[socket emitWithAck:@"canUpdate" with:@[@(cur)]] timingOutAfter:0 callback:^(NSArray* data) {
        [socket emit:@"update" with:@[@{@"amount": @(cur + 2.50)}]];

    [ack with:@[@"Got your currentAmount, ", @"dude"]];

[socket connect];


  • Supports 2.0+ (For 1.0 use v9.x)
  • Supports binary
  • Supports Polling and WebSockets
  • Supports TLS/SSL
  • Can be used from Objective-C


Requires Swift 3/Xcode 8.x

If you need swift 2.3 use the swift2.3 tag (Pre-Swift 3 support is no longer maintained)

If you need swift 2.2 use 7.x (Pre-Swift 3 support is no longer maintained)

If you need Swift 2.1 use v5.5.0 (Pre-Swift 2.2 support is no longer maintained)

If you need Swift 1.2 use v2.4.5 (Pre-Swift 2 support is no longer maintained)

If you need Swift 1.1 use v1.5.2. (Pre-Swift 1.2 support is no longer maintained)

Swift Package Manager

Add the project as a dependency to your Package.swift:

import PackageDescription

let package = Package(
    name: "YourSocketIOProject",
    dependencies: [
        .Package(url: "", majorVersion: 11)

Then import import SocketIO.


Add these line to your Cartfile:

github "nuclearace/Starscream" ~> 8.0.1
github "socketio/" ~> 11.0.0 # Or latest version

Run carthage update --platform ios,macosx.

CocoaPods 1.0.0 or later

Create Podfile and add pod 'Socket.IO-Client-Swift':


target 'YourApp' do
    pod 'Socket.IO-Client-Swift', '~> 11.0.0' # Or latest version

Install pods:

$ pod install

Import the module:


import SocketIO


@import SocketIO;


Add this line to your Seedfile:

github "socketio/", "v11.0.0", :files => "Source/*.swift" # Or latest version

Run seed install.


Detailed Example

A more detailed example can be found here

An example using the Swift Package Manager can be found here



Latest podspec

    "name": "Socket.IO-Client-Swift-Q",
    "module_name": "SocketIOQ",
    "version": "11.0.0",
    "summary": "Socket.IO-client for iOS and OS X",
    "description": "Socket.IO-client for iOS and OS X.nSupports ws/wss/polling connections and binary.nFor 2.0+ and Swift.",
    "homepage": "",
    "license": {
        "type": "MIT"
    "authors": {
        "Erik": "[email protected]"
    "platforms": {
        "ios": "8.0",
        "osx": "10.10",
        "tvos": "9.0"
    "requires_arc": true,
    "source": {
        "git": "",
        "tag": "v11.0.0",
        "submodules": true
    "source_files": "Source/*.swift",
    "dependencies": {
        "StarscreamSocketIO": [
            "~> 8.0.1"
    "pushed_with_swift_version": "3.0"

Pin It on Pinterest

Share This