-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
45 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,43 @@ | ||
lilsync | ||
------- | ||
======= | ||
|
||
lilsync is a tool that takes images from an s3 compatible cloud storage, creates optimised/resized versions of those images and reuploads them. | ||
lilsync is a tool that takes images from an s3 compatible cloud storage, creates optimised/resized versions of those images and reuploads them. | ||
|
||
Get Started | ||
----------- | ||
|
||
Install: | ||
``` | ||
npm install -g lilsync | ||
``` | ||
|
||
Then create a config file in your home directory called `.lilsyncrc.yaml`. | ||
|
||
Config | ||
------ | ||
lilsync requires a config file called .lilsyncrc.yaml either in the current directory or in your home directory. | ||
|
||
An example config file is as follows: | ||
``` | ||
bucketName: milkyway | ||
credentials: | ||
accessKeyId: "abc" | ||
secretKey: "def" | ||
endpointUrl: "https://s3.somewhere.tld" | ||
inputConfig: | ||
outputPath: "out/" | ||
inputPath: "images/" | ||
outputImages: | ||
- width: 1250 | ||
quality: 95 | ||
- width: 500 | ||
quality: 95 | ||
ext: png | ||
``` | ||
|
||
- bucketName: string representing the bucket where images will be stored | ||
- credentials: s3 compatible credentials. Instead of providing this section you can also have the following environment variables: `ACCESS_KEY_ID`, `SECRET_KEY` and `ENDPOINT_URL` | ||
- inputConfig: | ||
- outputPath: all images created by lilsync will be put in this folder. it doesnt have to exist in the bucket | ||
- inputPath: lilsync will look inside this folder and find images to convert | ||
- outputImages: a list of the formats you want to be created. all images from the input folder will have a new image created in the output folder for each format in this section. Requires at least a `width` or `height` to be defined. Available keys: `width`, `height`, `quality`, `ext` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters