dani-garcia/cloud-manager

CloudManager

TODO: Write a project description

Installation

Compile the project natives as shown below and install them on your system. These native files don't require Java to be installed on the target system, as they already include it.

Alternatively, if you wish to run the program in a portable fashion, simply compile the jar file. This requires Java 8 and JavaFX 8 to be installed on the target computer.

• On Windows and OSX, it's as simple as installing the latest Java 8 JRE Download link.

• On Debian/Ubuntu, this requires the openjdk-8-jre and openjfx packages. As Java 8 is relatively new, these packages are only available in recent versions of these distributions. At the time of writing this readme, the packages are available on Debian 7 Jessie on jessie-backports and on Ubuntu 15.04 vivid and newer.

# On Debian 8 Jessie:
$ sudo apt-get -t jessie-backports install openjfx

# On Debian 9 Stretch and Ubuntu 15.04 Vivid or later:
$ sudo apt-get install openjfx

Developing

The project is a normal Maven project, to open it simply import the project in your preferred IDE (IntelliJ has Maven support by default, other IDEs may need a plugin).

This project requires API keys from Google Drive and Dropbox. As these cannot be distributed publicly, you will need to get your own.

To do this:

• Go here for Google Drive.

  • Click Create project, name it and click Create
  • On the project main page, search for Drive API and enable it
  • Click on the Go to credentials button that appeared
    • on Where will you be calling the API from? select Other UI
    • on What data will you be accessing? select User Data
  • Click What credentials do I need?
  • Name the credentials and click Create client ID
  • Select your email, input a product name and click Continue
  • Download your credentials

• Go here for Dropbox.

  • Click Create App, choose the Dropbox API and wichever access you want, give it a name and click Create App
  • On the settings page, take note of the App key and theApp secret
  • On that same page, set Allow implicit grant to true, and add the redirect URL under Redirect URIs ( by default, use http://localhost:41325/auth)

Once you have the API keys, go to each plugins folder, copy apikeys.properties.sample to apikeys.properties and fill the data.

If running the project from the IDE returns an error saying the API keys are not set, you might need to run maven install before (This can usually be configured in the IDE's run configuration).

Compiling and running

To run the application:

$ mvn clean install
$ cd cm-gui
$ mvn jfx:run

To compile a .jar and native program (.exe or .msi installer on Windows, .deb or .rpm on Linux, .dmg on OSX):

$ mvn clean install
$ cd cm-gui
$ mvn jfx:jar       # To compile the .jar only
$ mvn jfx:native    # To compile the .jar and the natives

This will place the .jar file and the required libraries in the cm-gui/target/jfx/app folder and the native files in the cm-gui/target/jfx/native folder.

Credits

Daniel García García [email protected]

License

CloudManager Copyright (C) 2016 Daniel García García

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.