Thomas-Vos/Netimobiledevice

Pure .Net Core implementation for working with iOS devices (iPhone, iPad, iPod).

Netimobiledevice

Netimobiledevice is a .Net Core implementation for working with all iOS devices (iPhone, iPad, iPod) as well the plists that they use.

• Netimobiledevice
  • Features
  • Installation
  • Usage
  • Services
  • License
  • Contributing
  • Acknowledgments

Features

• Device discovery and connection via Usbmux.
• Interact with iOS services
• Handle all Plists whether they are in XML or Binary format

Installation

To install Netimobiledevice, you can use the following command in the Package Manager Console:

Install-Package Netimobiledevice

Alternatively, you can use the .NET CLI:

dotnet add package Netimobiledevice

Usage

A few examples of how to use Netimobiledevice are below.

Get a list of all currently connected devices using:

using Netimobiledevice.Usbmuxd;

List<UsbmuxdDevice> devices = Usbmux.GetDeviceList();
Console.WriteLine($"There's {devices.Count} devices connected");
foreach (UsbmuxdDevice device in devices) {
    Console.WriteLine($"Device found: {device.DeviceId} - {device.Serial}");
}

Listen to connection events:

Usbmux.Subscribe(SubscriptionCallback);

private static void SubscriptionCallback(UsbmuxdDevice device, UsbmuxdConnectionEventType connectionEvent)
{
    Console.WriteLine("NewCallbackExecuted");
    Console.WriteLine($"Connection event: {connectionEvent}");
    Console.WriteLine($"Device: {device.DeviceId} - {device.Serial}");
}

Get the app icon displayed on the home screen as a PNG:

LockdownClient lockdown = LockdownClient.CreateLockdownClient("60653a518d33eb53b3ca2212cd1f44e162a42069");
SpringBoardServicesService springBoard = new SpringBoardServicesService(lockdown);
PropertyNode png = springBoard.GetIconPNGData("net.whatsapp.WhatsApp");

Services

The list of all the services from lockdownd which have been implemented and the functions available for each one. Clicking on the service name will take you to it's implementation, to learn more about it.

• com.apple.mobile.diagnostics_relay
  • Query MobileGestalt & IORegistry keys.
  • Reboot, shutdown or put the device in sleep mode.
• com.apple.mobile.installation_proxy
  • Browse installed applications
  • Manage applications (install/uninstall/update)
• com.apple.mobile.notification_proxy & com.apple.mobile.insecure_notification_proxy
  • API wrapper for NotifyPost() & NotifyRegisterCallback()
• com.apple.mobilebackup2
  • Backup management
• com.apple.os_trace_relay
  • Get pid list
• com.apple.springboardservices
  • Get icons from the installed apps on the device.
• com.apple.syslog_relay
  • Streams the raw syslog lines from the device.

License

This project is licensed under the MIT LICENSE.

Contributing

Contributions are welcome. Please submit a pull request or create an issue to discuss your proposed changes.

Acknowledgments

This library was based on the following repositories with either some refactoring or in the case of libraries such as libusbmuxd translating from C to C#.

• BitConverter: Provides a big-endian and little-endian BitConverter that convert base data types to an array of bytes, and an array of bytes to base data types, regardless of machine architecture.
• libusbmuxd: A client library for applications to handle usbmux protocol connections with iOS devices.
• PList-Net: .Net Library for working with Apple *.plist Files.
• pymobiledevice3: A pure python3 implementation to work with iOS devices.