Libimobiledevice: Difference between revisions

← Older edit

VisualWikitext

@@ Line 1: / Line 1: @@
+{{DISPLAYTITLE:libimobiledevice}}
+The [https://libimobiledevice.org/ libimobiledevice] project provides libraries and tools to connect and transfer data between iOS devices and Linux machines.
 == Usage ==
-In order to be able to automatically mount your iOS device (such as an iPhone) when connecting it, you need to install <code>libimobiledevice</code> and to activate the <code>usbmuxd</code> service.
+=== Preparation ===
+In order to be able to automatically mount your iOS device (such as an iPhone) when connecting it or to enable USB tethering, you need to install <code>libimobiledevice</code> and to activate the <code>usbmuxd</code> service.
 Add the following to your <code>configuration.nix</code>:
@@ Line 8: / Line 12: @@
 <syntaxhighlight lang="nix">
 services.usbmuxd.enable = true;
 environment.systemPackages = with pkgs; [
    libimobiledevice
@@ Line 14: / Line 19: @@
 </syntaxhighlight>
-You can then mount your device using ifuse:
+If you experience issues mounting or pairing your device (for example as described [https://github.com/NixOS/nixpkgs/issues/152592 here]), you can try to switch the <code>usbmuxd</code> daemon package to an alternative more updated implementation, <code>usbmuxd2</code>.
+<syntaxhighlight lang="nix">
+services.usbmuxd = {
+  enable = true;
+  package = pkgs.usbmuxd2;
+};
+</syntaxhighlight>
+=== Mounting ===
+Mounting the device via iFuse is possible with the following commands
 <syntaxhighlight>
 $ mkdir /tmp/iphone
 $ ifuse /tmp/iphone
 </syntaxhighlight>
-If you get an error about <code>ERROR: No device found!</code>, check the status of <code>usbmuxd</code>:
+=== Tethering ===
+Tethering on iOS is possible via Wifi hotspot, Bluetooth or USB. In order to enable USB tethering, first enable tethering in the iOS networking settings. After that run following command
 <syntaxhighlight>
-$ sudo systemctl status usbmuxd.service
+$ idevicepair pair
 </syntaxhighlight>
-If you see an error
-<syntaxhighlight>
-ERROR: Could not connect to lockdownd on device [...], lockdown error -8
-</syntaxhighlight>
-you may need to restart the usbmuxd service as reported [https://github.com/NixOS/nixpkgs/issues/152592 here]:
-<syntaxhighlight>
-$ sudo systemctl restart usbmuxd.service
-</syntaxhighlight>
-(it may take a bit of time)
-== Maintainence ==
+Confirm pairing by accepting the connection on your iOS device. After that an ethernet device will appear in your network device list.
+== Maintenance ==
 === Factory reset ===