## megatools-df(1)

## 1. NAME

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

## 2. SYNOPSIS

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

## 3. DESCRIPTION

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

## 4. 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

## 5. 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"

## 6. KNOWN BUGS

Megadf can’t determine available space for premium accounts.

## 7. 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).

## 8. MEGATOOLS

Part of the megatools(1) suite of commands.

## 9. BUGS

Report bugs to megatools@megous.com. Your message will end up in a public archive, so be careful what you say or send.

## 10. AUTHOR

Megatools was written by Ondrej Jirman <megatools@megous.com>, 2013-2022.

Official website is http://megatools.megous.com.