NAME

       megatools dl - download exported files and directories from Mega.nz

SYNOPSIS

              megatools dl [--no-progress] [--path <path>] <links>...
              megatools dl --path - <filelink>

DESCRIPTION

       Downloads exported files and folders from Mega.nz. Handles links like:

       • ⟨https://mega.nz/#!7YVWhCzZ!bauBlAkKKvv8hIm-8-qFmGOYS289ToQWN7rGFPzXB_w⟩

       • ⟨https://mega.nz/#F!HIlFDajT!HLiVvQQkSe1d0ogxZuaOJg⟩

       When  downloading  individual files, these are placed into <path>. When downloading folders, the contents
       of the folder are placed into directory specified by <path>.

       To export files, you can use Mega.nz web application, or megatools-ls(1)'s --export option.

OPTIONS

       --path <path>
              Local directory to download to. Defaults to the current working directory.

              If <path> is -, remote file will be streamed to stdout.

       --no-progress
              Disable download progress reporting. This is implied when streaming.

       --print-names
              Print names/paths of successfully downloaded files (one per line).

       --choose-files
              Print all files in a shared folder and choose which files or subfolders to download. When choosing
              a subfolder, the entire subfolder will be downloaded.

       --disable-resume
              Don’t resume downloads from partially downloaded file. Default is to resume.

       --limit-speed <speed>
              Set maximum allowed upload and download  speed  in  KiB/s.   This  option  overrides  config  file
              settings.  0  means  no limit.  When using ParallelTransfers > 1, upload speed limit is applied to
              each transfer individually.

       --proxy <proxy>
              Use proxy server to connect  to  mega.nz.  This  option  overrides  config  file  settings.   More
              information        can        be        found        in       libcurl       documentation       at
              ⟨https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html⟩.  Some acceptable values are:

              • none : Disable proxy if it was enabled in the config file.

              • socks5://localhost:9050 : Local SOCKSv5 proxy server

              • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS handled by the proxy

       --netif <ifname|ip>
              Network interface or local IP address used for outgoing  connections.   You  have  to  specify  IP
              address bound to some of your local network interfaces, when specifying an IP address.

       --ip-proto <proto>
              Which IP protocol to prefer when connecting to mega.nz (v4, v6, or any).  This is just an advisory
              option.   Megatools  will  resolve  mega.nz  domain, and then use an A or AAAA record based on the
              stated preference.

       --config <path>
              Load configuration from a file

       --ignore-config-file
              Disable loading .megarc

       --debug [<options>]
              Enable debugging of various aspects of the megatools operation. You may enable multiple  debugging
              options separated by commas. (eg. --debug api,fs)

              Available options are:

              • http: Dump HTTP request/response details (can be used to debug connection/proxy issues)

              • api: Dump Mega.nz API calls

              • fs: Dump Mega.nz filesystem (may require --reload to actually print something)

              • cache: Dump cache contents

              • tman: Dump transfer manager events

       --version
              Show version information

       <links>
              File and folder links to download from.

       <filelink>
              Link to exported file to stream.

EXAMPLES

       • Download exported file:

         $ megatools dl 'https://mega.nz/#!7YVWhCzZ!bauBlAkKKvv8hIm-8-qFmGOYS289ToQWN7rGFPzXB_w'

       • Download exported folder:

         $ megatools dl 'https://mega.nz/#F!HIlFDajT!HLiVvQQkSe1d0ogxZuaOJg'

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-dl(1)