Latest 2.1.0
License MIT
Platforms ios 8.0, tvos 9.0, watchos 2.0

A modern device detection and querying library.

Build Status
GitHub license
Carthage compatible
CocoaPods compatible


  • [x] Swift 5 support
  • [x] Modern syntax
  • [x] Documentation
  • [x] Device detection
  • [x] Device family detection
  • [x] Device screens
  • [x] Simulator detection
  • [x] Simple querying



Swift Packager Manager (SPM)

Create a Package.swift file, and add this snippet:

import PackageDescription

let package = Package(
    name: "HelloWorld",
    dependencies: [
        .Package(url: "", "2.1.0")


Add this to your Cartfile:

github "bojan/Thingy"


Add this to your Podfile

pod 'Thingy'


Add the repository as a submodule to your project.

git submodule add Vendor/Thingy

Open the newly created folder in Finder and drag Thingy.xcodeproj to your project.

In your project’s settings, select your target and under General > Embedded Binaries, add the framework depending on the target OS (iOS, watchOS or tvOS).


Import the module where needed:

import Thingy

Device properties

Inspect the current device:

let myDevice = Device()

// Compare models or product families
if == .tv {
    print("This is an Apple TV device.")

if myDevice.model != .iPhoneXSMax {
    print("This is NOT an iPhone XS Max.")

// Pretty printed device properties

print( // e.g. iPad
print(myDevice.model.marketingName) // e.g. iPhone 7 Plus
print(myDevice.productLine.marketingName) // e.g. Air

Model comparison

let myDevice = Device()

do {
    let result = try myDevice.isEqual(to: Thingy.iPadPro12Inch)
catch {
    print("The devices are incompatible.")

do {
    let result = try myDevice.isOlder(than: Thingy.iPadPro10Inch)
catch {
    print("The devices are incompatible.")

Device size

let myDevice = Device()

if myDevice.display == .screen10_5Inch {
    print("This is the 10.5in iPad Pro.")


All contributions and suggestions are welcome and very much appreciated.

Should you have a feature request or a problem that you may experience, feel free to open an issue.

If you are willing to contribute by adding a feature or squashing a bug or two, please submit a pull request.


Bojan Dimovski


Thingy is available under the MIT license. Check the LICENSE file for more info.

Latest podspec

    "name": "Thingy",
    "version": "2.1.0",
    "summary": "Device detection and querying library.",
    "homepage": "",
    "license": "MIT",
    "authors": "Bojan Dimovski",
    "platforms": {
        "ios": "8.0",
        "tvos": "9.0",
        "watchos": "2.0"
    "source": {
        "git": "",
        "tag": "2.1.0"
    "source_files": "Sources/*.swift"

Pin It on Pinterest

Share This