---
name: "megatools-df"
section: "1"
platform: "linux"
package: "megatools"
version: "1.11.5-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/megatools-df"
---

# megatools-df(1)

Show total available, used, or free space in the cloud

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

  - •

    FCnoneF\[0\] : Disable proxy if it was enabled in the config file.

  - •

    FCsocks5://localhost:9050F\[0\] : Local SOCKSv5 proxy server

  - •

    FCsocks5h://localhost:9050F\[0\] : 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. FC--debug api,fsF\[0\])

  Available options are:

  - •

    FChttpF\[0\]: Dump HTTP request/response details (can be used to debug connection/proxy issues)

  - •

    FCapiF\[0\]: Dump Mega.nz API calls

  - •

    FCfsF\[0\]: Dump Mega.nz filesystem (may require FC--reloadF\[0\] to actually print something)

  - •

    FCcacheF\[0\]: Dump cache contents

  - •

    FCtmanF\[0\]: Dump transfer manager events

- \--version

  Show version information

## EXAMPLES

- •

  Show overall human readable space usage information:

  ```
  FC$ megatools df -h
  Total: 50.0 GiB
  Used:  6.4 GiB
  Free:  43.6 GiBF[0]
  ```

- •

  Check free space from a script:

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

## KNOWN BUGS

Megadf can’t determine available space for premium accounts.

## SEE ALSO

[**megatools**(1)](/megatools/1.md), [**megarc**(5)](/megarc/5.md), [**megatools-df**(1)](/megatools-df/1.md), [**megatools-dl**(1)](/megatools-dl/1.md), [**megatools-get**(1)](/megatools-get/1.md), [**megatools-ls**(1)](/megatools-ls/1.md), [**megatools-mkdir**(1)](/megatools-mkdir/1.md), [**megatools-put**(1)](/megatools-put/1.md), [**megatools-reg**(1)](/megatools-reg/1.md), [**megatools-rm**(1)](/megatools-rm/1.md), [**megatools-copy**(1)](/megatools-copy/1.md).

## MEGATOOLS

Part of the [**megatools**(1)](/megatools/1.md) 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/⟩.