Skip to content

An open source Universal Plug and Play library with a focus on media streaming coordination using the UPnP A/V profile; written in Swift but for both Objective-C and Swift apps.

License

katoemba/UPnAtom

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UPnAtom: Modern UPnP in Swift Version Platform License Build Status

Try SwiftUPnP

After working for some time with UPnAtom I created a new swift based framework to communicate with UPnP servers, with several advantages:

  • Full support both the AV profile and OpenHome profile
  • Complete implementations of these profiles, including all meta-data according to DIDL specification
  • A smaller code footprint
  • Based on async/await and combine

Find out more at https://github.com/katoemba/swiftupnp

Description

An open source Universal Plug and Play library with a focus on media streaming coordination using the UPnP A/V profile; written in Swift but for both Objective-C and Swift apps. Supports only iOS 8 and higher due to iOS 7's limitation of not supporting dynamic libraries via Clang module.

Requirements:

  • iOS 12.0+
  • OSX 10.15+
  • Xcode 12.0

Install:

Include via Swift Package Manager

// swift-tools-version:5.0

import PackageDescription

let package = Package(
  name: "MyProject",
  dependencies: [
  .package(url: "https://github.com/katoemba/UPnAtom.git", from: "0.8.2")
  ],
  targets: [
    .target(name: "MyProject", dependencies: ["UPnAtom"])
  ]
)

Usage:

Swift
import UPnAtom
More documentation is on the way.

For now, it is highly recommended you check out the example projects. They are exactly the same app however one is in Swift, and the other is in Objective-C. They demonstrate almost all of the library's features minus the ability to add your own UPnP service/device classes. If you create your own service/device classes simply register them following UPnAtom.swift as an example.

Note: On iOS, transport security has blocked cleartext HTTP (http://) resource loads since it is insecure. Since many, if not most, UPnP devices serve resources over http, temporary exceptions can be configured via your app's Info.plist file. Remove this restriction at your own risk.

Milestones:

  • Usable in Swift projects via Swift Package Manager
  • Create your own service and device object via class registration
  • UPnP Version 1 Compliance
  • Ability to archive UPnP objects after initial discovery and persist somewhere via NSCoder/NSCoding
  • OSX 10.9+ support
  • Swift 5.0
  • In-house implementation of SSDP discovery
  • A/V Profile Feature parity with upnpx library
  • Documentation (Until then please check out the example projects)
  • UPnP Version 2 Compliance

Tested Support On:

UPnP Servers:
UPnP Clients:

Contribute:

Currently I'm only taking feature requests, bugs, and bug fixes via Github issue. Sorry no pull requests for features or major changes until the library is mature enough.

  • If you'd like to ask a general question, use Stack Overflow.
  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.

About

An open source Universal Plug and Play library with a focus on media streaming coordination using the UPnP A/V profile; written in Swift but for both Objective-C and Swift apps.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 100.0%