Desktop application that uses Cloudinary's CLI to automatically sync a local folder (and it subfolders) to a Cloudinary folder.

For Mac: There is an installer available. Prequisites for the installation are:

1. Having Python 3.6 or later. You can install Python from https://www.python.org.
2. Make sure that in your Mac System Preferences-> Security & Privacy-> General you select the option Allow Apps downloaded from: AppStore and identified developers

Next, download cloudydesktop-signed.pkg from the Releases section and double click to install.

For Windows: You need to compile the code on your local machine as explained below.

In order to compile the app on your machine Node and git are required to be installed. To confirm they are installed run (on Mac use terminal, on windows use powershell):

# These commands should print the version of each process when they are installed
% node -v
% npm -v
% git -v

Cloudinary CLI is required for the application to work, to install it:

• Install Python version 3.6 or later.
• To install the Cloudinary CLI, run (on Mac use terminal, on windows use powershell):

pip3 install cloudinary-cli

Cloudydesktop compile and run:

# Clone the cloudydesktop repository
% git clone https://github.com/cloudinary-labs/cloudydesktop

# Go into the repository
% cd cloudydesktop

# Get the dependencies and run the app from the local folder
% npm install
% npm start

# Build an app and install it on your machine
% npm run make
% cd out/cloudydesktop-<os-name>
# On windows create a shortcut to the .exe file in the folder
# On Mac copy the .app in the folder to your Computer Applications folder

Run the Cloudydesktop application, set your Cloudinary account details (cloud name, API key and API secret) and save them. Select the local folder you want to upload to Cloudinary and the Cloudinary folder name in which files will be stored.

Notes:

• Files are uploaded as public to Cloudinary.
• The Cloudinary folder you set will be created under cloudydesktop folder in Cloudinary (and not under the root directory) so that there are less chances of messing up an existing folder.
• When the sync is running, a file that is updated (with the same file name) on your local directory will be updated in the Cloudinary folder as well. In case you want to keep historic versions of updated files you need to enable backup on your Cloudinary account.
• When the sync is running, unique files deleted from your local directory, won't be deleted and will be kept in the Cloudinary folder.

To start the sync operation click Sync Now, if all is well the button will show Sync On and the sync icon will keep rotating. After performing an initial sync the application will continue to monitor changes done to your local folder and it will update the Cloudinary folder with changes automatically. Once the Sync is on you can no longer change the path of the local or cloudinary folders.

To stop the Sync or to change folders call stop sync. On Mac it is in the dock menu and on Win it is in the taskbar thumbnail menu or exit the application. Closing the window, on Mac it leaves the app running and on Win the application exits. To close the app on Mac select quit on the dock menu.

In case you want to see more details on a Sync Error message or to see which files are uploaded, you can see that in the Dev Tools console. To open the Dev Tools, on Mac hit <Cmd, Opt, I> when the app is in focus and on Windows it is in the taskbar thumbnail menu, click the gear icon that will show when you hover on the taskbar app icon.