README

This application allows to wirelessly download media from Olympus cameras to your PC.

It has been successfully tested on the following cameras:

• Olympus TG-860 (thanks Lee!)
• Olympus TG-5 (thanks Jim!)
• Olympus OMD E-M1 (thanks Jean Pierre!)
• Olympus OMD E-M5 Mark II (thanks David!)
• Olympus OMD E-M10

Also it should work out-of-the-box with other similar Olympus cameras.

This application has been successfully tested on the following operating systems:

• Linux
• Windows
• Mac OS (thanks Ola!)

Contact me if you have any issue.

Get started

Install/unzip the application

First download the application package from here.

If you use a Linux distribution I strongly suggest to download the .deb package for Debian/Ubuntu or the .rpm one for Red Hat like distributions.

If you use Windows or Mac OS I strongly suggest to download the .zip package.

Using generic packages (.zip or .tgz, suggested for Windows & Mac OS)

These packages are provided so that the application can be used without installation. Download the latest version (for instance photosync-XX.zip) and decompress it somewhere (for example in /home/user/). Then the executables will be under the unzipped directory, on the /bin/ subdirectory.

In the coming sections of this document, when requested to execute photosync you will have to:

• (if under Linux) execute /bin/photosync (you might need to set the file /bin/photosync as executable, doing chmod +x bin/photosync).

• (if under Windows) navigate to the folder \bin and execute photosync.bat.

Using Linux packages (.deb and .rpm files)

Packages .deb and .rpm are available for Linux distributions. You can install them using dpkg and rpm tools.

For instance the .deb package can be installed in Ubuntu typing:

sudo apt-get install openjdk-7-jre
sudo dpkg -i photosync_x.x_all.deb

In the coming sections of this document, when requested to execute photosync, simply execute photosync from any current directory (as it will be already in the PATH environment variable).

Configure

The application should work out-of-the-box for the cameras listed above. However you may want to customize its execution, for instance to download photos to a non-default directory.

For such cases, the application uses several parameters that can be set either through command line arguments, or by modifying the configuration file. Command line arguments take precedence over the configuration file.

Command line arguments

There are several parameters to be set. To list these parameters you can execute:

photosync --help

For instance you can set the server name that is used by executing:

photosync --server-name 192.168.0.10

Configuration file

This project uses the typesafehub/config library to cope with configuration files, Find here a valid configuration file.

Just copy its content somewhere, modify it as wished, and launch the application as follows:

photosync -Dconfig.file=/path/to/application.conf 

Run the application

To transfer media from your camera to your PC follow these steps:

1. Turn on the WIFI service of your camera using Private mode in Wi-Fi Connect Settings.

   This step is very important, if not set up correctly the camera won't let this application download media files! To change to Private mode go to the menu of your camera, and set Wi-Fi Connect Settings to Private as shown in the following image.

   

2. Connect your PC to the WIFI provided by the camera.

   The SSID of the WIFI network should be something like "E-M10-V5PG53223". Your PC should be connected to the camera WIFI. To verify such, you can open a web browser (like Explorer, Chrome, Firefox, etc.) and set as URL either http://oishare/ or http://192.168.0.10/. If browsing any of these URLs results in a nice dark web page that mentions Olympus somewhere as follows, then you can proceed:

   

3. Now you can launch the application executing photosync (depending on how you installed the application and your OS)

   The application will start copying files from your camera to a local directory (as configured).

Develop

This application is written in Scala and uses SBT. Find below some useful commands for basic actions.

sbt compile  # To compile the application
sbt test     # To test it
sbt run      # To launch it

Build packages

The project uses sbt-native-packager so you can build packages for many operating systems / distributions.

sbt universal:packageBin         # To build the multi-platform .zip package
sbt universal:packageZipTarball  # To build the multi-platform tarball
sbt debian:packageBin            # To build a Debian package (.deb)
sbt rpm:packageBin               # To build an RPM package (.rpm) (must have rpm tool installed if in Debian OS)
sbt windows:packageBin           # To build a Windows installer (from Windows)
sbt docker:publishLocal          # To build a docker image

Contribute

This project is open source so you can help make it better.

Found issues? Then please file an issue in here or send me by mail the logs you got, that will really help me trying to understand what's wrong.

Own a OMD E-MX camera not supported? Then please contact me by e-mail too. Taking only 20 minutes of your time you can help me adapt the application to your camera.

Want to simply contribute? You can create a PR in the main repository at GitHub. Keep in mind that there is a mirror repository at BitBucket that will be probably marked as deprecated in the future.

Need more information? Send me an e-mail to [email protected].

Liked the project? Then please star it!