Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/petabyt/camlib
Picture Transfer Protocol client library
https://github.com/petabyt/camlib
canon mtp usb
Last synced: 1 day ago
JSON representation
Picture Transfer Protocol client library
- Host: GitHub
- URL: https://github.com/petabyt/camlib
- Owner: petabyt
- License: apache-2.0
- Created: 2022-09-03T16:38:09.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-04T04:08:26.000Z (15 days ago)
- Last Synced: 2025-01-12T22:15:01.544Z (6 days ago)
- Topics: canon, mtp, usb
- Language: C
- Homepage: https://danielc.dev/camlib/
- Size: 1.51 MB
- Stars: 26
- Watchers: 5
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# camlib
This is a Picture Transfer Protocol (PTP) library written in C.
[Documentation](https://danielc.dev/camlib/structPtpRuntime.html)
*(This library doesn't have a stable release yet, use at your own risk)*
## Roadmap
- [x] Complete working implemention of PTP as per ISO 15740
- [x] Implement PTP/IP
- [x] Tested and working on Linux, MacOS, Windows, Android, and iOS
- [x] Work natively on Windows witout libusb ([libwpd](https://github.com/petabyt/libwpd))
- [x] Fcuntions to convert most data structures to JSON
- [x] Implement most EOS/Canon features
- [x] Optional lua bindings
- [x] Thread safety
- [x] CI/Regression testing (vcam)
- [x] Fujifilm support: Available [here as libfudge](https://github.com/petabyt/fudge)
## Design
- Thread-safe
- No macros
- Uses a single in/out buffer (no memory allocations between operations)
## Sample
Get device info:
```
#include
int main() {
struct PtpRuntime *r = ptp_new(PTP_USB);
if (ptp_device_init(r)) {
printf("Device connection error\n");
return 0;
}
struct PtpDeviceInfo di;
char buffer[2048];
ptp_get_device_info(r, &di);
ptp_device_info_json(&di, buffer, sizeof(buffer));
printf("%s\n", buffer);
ptp_device_close(r);
ptp_close(r);
return 0;
}
```
Calling a custom opcode:
```
// Send a command, and recieve packet(s)
struct PtpCommand cmd;
cmd.code = 0x1234;
cmd.param_length = 3;
cmd.params[0] = 420;
cmd.params[1] = 420;
cmd.params[2] = 420;
return ptp_send(r, &cmd);
// Send a command with data payload
struct PtpCommand cmd;
cmd.code = 0x1234;
cmd.param_length = 1;
cmd.params[0] = 1234;
uint32_t dat[2] = {123, 123};
return ptp_send_data(r, &cmd, dat, sizeof(dat));
```
Explore the filesystem:
```
struct PtpArray *arr;
int rc = ptp_get_storage_ids(r, &arr);
int id = arr->data[0];
free(arr);
rc = ptp_get_object_handles(r, id, PTP_OF_JPEG, 0, &arr);
for (int i = 0; i < arr->length; i++) {
struct PtpObjectInfo oi;
ptp_get_object_info(r, arr->data[i], &oi);
printf("Filename: %s\n", oi.filename);
}
free(arr);
```
## License
Camlib is licensed under the Apache License 2.0.
lua-cjson: http://tools.ietf.org/html/rfc4627 (MIT License)