Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chaoyangnz/usbcopy
A utility to watch removable SD cards, USB Drive, CF Express and import photos from camera to a destination folder
https://github.com/chaoyangnz/usbcopy
camera cfexpress lightroom mtpdrive nikon photography sdcard usbcopy
Last synced: 24 days ago
JSON representation
A utility to watch removable SD cards, USB Drive, CF Express and import photos from camera to a destination folder
- Host: GitHub
- URL: https://github.com/chaoyangnz/usbcopy
- Owner: chaoyangnz
- Created: 2024-08-18T11:24:44.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-08-19T22:48:27.000Z (4 months ago)
- Last Synced: 2024-10-21T04:01:21.242Z (2 months ago)
- Topics: camera, cfexpress, lightroom, mtpdrive, nikon, photography, sdcard, usbcopy
- Language: Go
- Homepage:
- Size: 33.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# usbcopy
A utility to watch USB/Removable drives and copy files to the destination folder automatically.
The destination folder can be either synced to cloud or import into Lightroom catalog
With this tool, it can largely improve your photography post-processing workflow.
> Inspired by Synology USB Copy add-on package.
## How to use
### CLI
- simple
```
C:\> usbcopy.exe -volume Z
```
```
Usage of usbcopy.exe:
-dst string
absolute path to the destination folder (default "E:/Photos/raw/%year%-%month%-%day%/%name%_%counter%.%extension%")
-filters string
a comma seperated list of file extensions without prefixed dot (default "NEF,JPEG,JPG,MOV,MP4")
-src string
absolute path to the source folder (default "%volume%:/DCIM")
-volume string
volume letter (default "Z")
```
- watch
```
C:\> usbcopy.watch.exe
```
```
Usage of usbcopy.watch.exe:
-dst string
absolute path to the destination folder (default "E:/Photos/raw/%year%-%month%-%day%/%name%_%counter%.%extension%")
-filters string
a comma seperated list of file extensions without prefixed dot (default "NEF,JPEG,JPG,MOV,MP4")
-interval int
watch interval in seconds (default 3)
-src string
absolute path to the source folder (default "%volume%:/DCIM")
-volume string
volume name to watch, no need to be full name (default "Z 6_2")
```
### GUI
```
C:\> usbcopy.gui.exe
```
You should be able to see the icon in system tray of right corner.
In GUI mode, there is a `usbcopy.yml` beside for configurations and `usbcopy.log` for logging.
Notifications will be sent when something needs your attention.
- USB injected
- USB ejected
- file copying complete
### variables
When you specify `src-path`, `dst-path`, some variables can be used to dynamically build the path
- `src-path`
- `%volume%`: volume letter which was detected by `usbcopy`
- `dst-path`
- `%filename%`: file name with extension
- `%name%`: file name only
- `%extension%`: file extension
- `%dir%`: file base folder relative to `source-path`
- `%year%`: modification year
- `%month%`: modification month
- `%day%`: modification day
## SD Card / CF Express
You need a card reader to plug in PC and it is mounted as a USB massive storage, then use `usbcopy` to scan the disk and copy photos.
## MTP/PTP
If your camera only allows MTP/PTP device when connecting to PC using USB cable, you have to mount MTP device as a Massive Storage,
[MTPDrive](https://www.mtpdrive.com/) is a good companion to help you set it up automatically.
Once MTP device is mapped to a removable storage, then you can use `usbcopy` to scan the disk and copy photos.
## Roadmap
- [x] System tray
- [x] Windows desktop notification integration
- [x] better logging & configuration
- [x] flexible file renaming strategies and directory layout
- [ ] Windows service wrapper