plucky (1) megatools.1.gz

NAME

       megatools - Mega.nz command line tools

SYNOPSIS

              megatools df [--free|--total|--used] [--mb|--gb|-h]
              megatools ls [-e] [-h] [--header] [-l] [-R] [-n] [<remotepaths>...]
              megatools test [-f|-d] <remotepaths>...
              megatools export <remotepaths>...
              megatools put [--no-progress] [--path <remotepath>] <paths>...
              megatools mkdir <remotepaths>...
              megatools mkdir /Contacts/<contactemail>
              megatools get [--no-progress] [--path <path>] <remotepaths>...
              megatools get --path - <remotefile>
              megatools copy [-n] [--no-progress] --local <path> --remote <remotepath>
              megatools copy [-n] [--no-progress] --download --local <path> --remote <remotepath>
              megatools rm <remotepaths>...
              megatools rm /Contacts/<contactemail>
              megatools dl [--no-progress] [--path <path>] <links>...
              megatools dl --path - <filelink>
              megatools reg [--scripted] --register --email <email> --name <realname> --password <password>
              megatools reg [--scripted] --verify <state> <link>

DESCRIPTION

       Megatools  is  a collection of programs for accessing Mega service from a command line of your desktop or
       server.

       Megatools allow you to copy individual files as well as entire directory trees to and from the cloud. You
       can  also  perform  streaming downloads for example to preview videos and audio files, without needing to
       download the entire file.

       Megatools are robust and  optimized  for  fast  operation  -  as  fast  as  Mega  servers  allow.  Memory
       requirements and CPU utilization are kept at minimum.

       You  can  register account using a megatools-reg(1) tool, with the benefit of having true control of your
       encryption keys.

       Mega website can be found at ⟨https://mega.nz⟩.

       Megatools can be downloaded at ⟨https://xff.cz/megatools/⟩

TOOLS OVERVIEW

       megatools-reg(1)
              Register and verify a new mega account

       megatools-df(1)
              Show your cloud storage space usage/quota

       megatools-ls(1)
              List all remote files

       megatools-test(1)
              Test for existence of files or folders

       megatools-export(1)
              Create public links for remote files

       megatools-mkdir(1)
              Create remote directory

       megatools-rm(1)
              Remove remote file or directory

       megatools-put(1)
              Upload individual files

       megatools-get(1)
              Download individual files

       megatools-dl(1)
              Download file from a "public" Mega link (doesn’t require login)

       megatools-copy(1)
              Upload or download a directory tree

CONFIGURATION FILES

       See megarc(5) for information about mega configuration file.

       Each of the individual tools have help that can be accessed using --help parameter.

SESSION CACHE

       If you modify cloud filesystem from the Mega.nz website or from another computer, you’ll need to  refresh
       your  session cache. This can be done by using the --reload option to any tool, or by waiting for a cache
       timeout (default timeout is set to 10 minutes).

REMOTE FILESYSTEM

       Mega.nz filesystem is represented as a tree of nodes of various  types.  Nodes  are  identified  by  a  8
       character node handles (eg. 7Fdi3ZjC). Structure of the filesystem is not encrypted.

       Megatools maps node tree structure to a traditional filesystem paths (eg.  /Root/SomeFile.DAT).

       NOTE:  By  the nature of Mega.nz storage, several files in the directory can have the same name. To allow
       access to such files, the names of conflicting files are extended by appending dot and their node  handle
       like this:

       /Root/conflictingfile
       /Root/conflictingfile.7Fdi3ZjC
       /Root/conflictingfile.mEU23aSD

       You need to be aware of several special folders:

       /Root  Writable directory representing the root of the filesystem.

       /Trash Trash  directory  where  Mega.nz  web  client  moves  deleted files. This directory is not used by
              megatools when removing files.

       /Inbox Not sure.

       /Contacts
              Directory containing subdirectories representing your contacts list. If you want to  add  contacts
              to the list, simply create subdirectory named after the contact you want to add.

       /Contacts/<email>
              Directories  representing  individual  contacts  in  your contacts list. These directories contain
              folders that others shared with you. All shared files are read-only, at the moment.

SEE ALSO

       megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-get(1), megatools-ls(1),  megatools-
       mkdir(1), megatools-put(1), megatools-reg(1), megatools-rm(1), megatools-copy(1).

MEGATOOLS

       Part of the megatools(1) suite of commands.

BUGS

       There is no upstream support for bugreports and feature requests. But you can send code patches to
       megatools@xff.cz ⟨mailto:megatools@xff.cz⟩ to get them integrated into upstream repository.

AUTHOR

       Megatools was written by Ondrej Jirman < megatools@xff.cz ⟨mailto:megatools@xff.cz⟩ >, 2013-2022.

       Official website is ⟨https://xff.cz/megatools/⟩.

                                                 7 February 2025                                    megatools(1)