MEGAcmd for Java

This is an open source Java library for the mega.nz API, working on top of the MEGAcmd CLI. There is a Quick Start available for developers who want to start using the library right away.

Features

If you have any doubt about how each feature works, please run

    MegaClient <MEGAcmd> --help

Additional Features

This features have no corresponding Megacmd command, but they are infered from the existing ones

Count

Show the amount of elements in a folder or that match the query mask. E.g.

    final long amountOfFilesAndDirectories = sessionMega.count("remote/path");

But what if you want to filter that counting and it a Predicate to, for instance, just get the files and not the directories.

    final long amountOfFiles = sessionMega.count("remote/path", FileInfo::isFile);

Exists

This is pretty much the equivalent of java.io.File.exists. It checks if the remote path or mask indicates any non null response. E.g.

    sessionMega.exists("remote/path/filesprefix*.ext");

Export with an expiration date

With a premium mega account, you can export and generate public folder links by setting the option expire date.

    LocalDate expireDate = LocalDate.of(2020, 9, 2);
    final ExportInfo exportInfo = sessionMega.export(exportFolder)
            .setExpireDate(expireDate)
            .call();

or you can just specify a duration using TimeDelay.

    final ExportInfo exportInfo = sessionMega.export(exportFolder)
        .setExpirationTimeDelay(TimeDelay.of(
             Period.ofYears(3).plusMonths(11).plusDays(15)
         ))
        .call();

MEGAcmdServer

Thanks to the class io.github.eliux.mega.MegaServer you can now start and stop the local MEGAcmdServer on command.

System requirements

• Install MEGAcmd. Available packages for MEGAcmd in all supported platforms should be found here.

Environment variables to set

• MEGA_EMAIL: Email used as username (lowercase)
• MEGA_PWD: Corresponding password
• CMD_TTL_ENV_VAR: Maximum time to live of a running MEGAcmd command. By default, 20 seconds.

Setup your credentials

1. The most common way to setup your credentials would be using the environment variables MEGA_EMAIL and MEGA_PWD.

2. Use an existing session can be a saver way. You can use it from your app as long as it don't be closed.

Continuous Integrations

As most OSS projects in github, this one uses Travis CI. I you want a CLI for your project, its recommend to install the correspondent ruby gem:

    gem install travis

For users

• Once installed MEGAcmd in your system, execute mega-help to check all commands. You will be able to notice those who are already implemented in this library and those who don't. Try them out.

Contributing

Make sure your contact data is included in the Contributors section, and

• Follow the Google Java Style Guide as much as possible: Its recommended that you install the Google Java Style Guide settings in your IDE.
• Respect as much as possible the format of the provided templates for issues and PRs.

Contributors

Add your name, email and your account for Twitter, Github or LinkedIn:

• Cenyo Medewou - [email protected] | Github | Linkedin

Built With

• Java SDK 8 - Java™ Platform
• Maven - Dependency Management
• MEGAcmd - Command Line Interactive and Scriptable Application

Author

• Eliecer Hernandez - [email protected]. For more information, please visit my website.

License

This project is licensed under the MIT License - see the LICENSE.md file for details