65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
# iasync - sync files to iOS app folders
|
|
|
|
**iasync** uses [libimobiledevice] to sync a local directory tree with an iOS device. This is intended as a replacement to pairing ifuse and rsync, where users might have issues with fuse (or be unable to use fuse at all).
|
|
|
|
## Building
|
|
|
|
This project requires the following:
|
|
|
|
- [libimobiledevice] for the actual iOS bits.
|
|
- [libbsd] on non-BSD/macOS systems.
|
|
- [meson] and [ninja] as the build system.
|
|
|
|
To build in the directory `build`, run:
|
|
|
|
```
|
|
meson setup build/
|
|
ninja -C build/
|
|
# To install:
|
|
ninja -C build/ install
|
|
```
|
|
|
|
## Usage
|
|
|
|
See the manpage for more details (`man 1 iasync`).
|
|
|
|
Primarily, if you have more than one iOS device connected to your system, you'll need the name or UDID of your device:
|
|
|
|
```
|
|
$ iasync lsdevs
|
|
Name Conn. UDID
|
|
My Iphone USB 00000000-0000000
|
|
```
|
|
|
|
Then, get the Bundle ID for the app you want to sync:
|
|
|
|
```
|
|
$ iasync lsapps
|
|
App Name Bundle ID
|
|
[...]
|
|
Doppler co.brushedtype.doppler-ios
|
|
```
|
|
|
|
To sync a directory tree to the app, you could run:
|
|
|
|
```
|
|
$ iasync sync ~/Music co.brushedtype.doppler-ios
|
|
```
|
|
|
|
If you want to delete files that exist on the device but not locally, use the `--allow-delete` flag:
|
|
|
|
```
|
|
$ iasync sync --allow-delete ~/Music co.brushedtype.doppler-ios
|
|
```
|
|
|
|
## License
|
|
|
|
iasync is provided under the BSD 3-Clause license. For more information, please see the LICENSE file.
|
|
|
|
Multiple functions (`idevfs_canonpath()` and `idevfs_mkpath()`) use code from [NetBSD]. These licenses are included in the NOTICES file.
|
|
|
|
[libimobiledevice]: https://libimobiledevice.org/
|
|
[libbsd]: https://libbsd.freedesktop.org/wiki/
|
|
[meson]: https://mesonbuild.com/
|
|
[ninja]: https://ninja-build.org/
|
|
[NetBSD]: https://www.netbsd.org
|