NAME

       megatools df - Show total available, used, or free space in the cloud

SYNOPSIS

              megatools df [--free|--total|--used] [--mb|--gb|-h]

DESCRIPTION

       Shows available, used and free space in the cloud in machine or human readable formats.

OPTIONS

       --total
              Show only total available space (free + used).

       --free Show only free space.

       --used Show only used space.

       --human , -h
              Display file sizes in a human readable format.

       --mb   Show in MiB units.

       --gb   Show in GiB units.

       -u <email> , --username <email>
              Account username (email)

       -p <password> , --password <password>
              Account password

       --no-ask-password
              Never ask interactively for a password

       --reload
              Reload filesystem cache

       --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

EXAMPLES

       • Show overall human readable space usage information:

         $ megatools df -h
         Total: 50.0 GiB
         Used:  6.4 GiB
         Free:  43.6 GiB

       • Check free space from a script:

         $ test `megatools df --free --gb` -lt 1 && \
           echo "You have less than 1 GiB of available free space"

KNOWN BUGS

       Megadf can’t determine available space for premium accounts.

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