You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+34-5Lines changed: 34 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
# Lychee Upload
2
-
A command line tool for uploading photos on a hard drive to a [Lychee](http://github.com/electerious/Lychee) installation on a remote server via SSH.
3
-
Based on [lycheesync](https://github.com/GustavePate/lycheesync) by Gustave Paté
2
+
A command line tool for uploading photos in a directory or from iPhoto/Aperture libraries to a [Lychee](http://github.com/electerious/Lychee) installation on a remote server via SSH.
3
+
Based on [lycheesync](https://github.com/GustavePate/lycheesync) by Gustave Paté and [Phoshare](https://code.google.com/p/phoshare/) by Google.
4
4
5
5
6
6
# Description
7
7
8
-
Performs a batch image import from a location on hard drive to the Lychee installation on a remote server via SSH. Subdirectories are automatically converted to Lychee albums. As Lychee does not support sub-albums, photos in subsubdirectories are uploaded to the respective album. Photos in the root directory are uploaded to the Unsorted album.
8
+
Performs a batch image import from a location on hard drive or from an iPhoto/Aperture library to the Lychee installation on a remote server via SSH. When importing from a directory, subdirectories are automatically converted to Lychee albums. As Lychee does not support sub-albums, photos in subsubdirectories are uploaded to the respective album. Photos in the root directory are uploaded to the Unsorted album. In the iPhoto/Aperture mode you can specify what to export. Possible options are events, albums and smart albums.
9
9
If you want to replace albums in the Lychee database, then you can use *-r* option. All photos in the existing album will be deleted in the Lychee database and replaced with new ones from the hard drive location.
10
10
11
11
# Installation
@@ -42,21 +42,50 @@ Finally install dependencies using *pip*
-`username@hostname:path` Server connection string with a full path to the directory where Lychee is installed.
48
50
-`-h`, `--help` show a help message
49
-
-`-d DIR`, `--dir DIR` path to the photo directory where to export photos from.
50
51
-`-r`, `--replace` replace albums in Lychee with local ones
51
52
-`-p`, `--public` make uploaded photos public
52
53
-`-v`, `--verbose` print verbose messages
53
54
55
+
Directory import options
56
+
57
+
-`-d DIR`, `--dir DIR` path to the photo directory where to export photos from.
58
+
59
+
iPhoto / Aperture options
60
+
61
+
-`--iphoto [path]` Import from iPhoto. If path is not provided, then default location is used.
62
+
-`--aperture [path]` Import from Aperture. If path is not provided, then default location is used.
63
+
-`-e [pattern]`, `--events [pattern]` Export matching events. The argument is a regular expression. If the argument is omitted, then all events are exported.
64
+
-`-a [pattern]`, `--albums [pattern]` Export matching regular albums. The argument is a regular expression. If the argument is omitted, then all events are exported.
65
+
-`-s [pattern]`, `--smarts [pattern]` Export matching smart albums. The argument is a regular expression. If the argument is omitted, then all events are exported.
66
+
-`--originals` Export originals instead of modified images
67
+
-`-x pattern`, `--exclude pattern` Don't export matching albums or events. The pattern is a regular expression.
68
+
69
+
At very least you must specify a connection string and a source where photos should be imported from (`--dir`, `--iphoto` or `--aperture` options).
70
+
54
71
For example to import photos from the directory */home/user/photos/* to the remote server *example.com* with Lychee installed in the */home/user/mydomain.com/* directory, issue the following command
0 commit comments