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

# megarc(5)

Configuration file for megatools

## NAME

megarc - Configuration file for megatools

## SYNOPSIS

```
~/.megarc
./.megarc
```

## DESCRIPTION

Megatools use INI configuration file to store commonly used login credentials. This makes it less bothersome to use the tools, as you can simply write

```
FC$ megatools dfF[0]
```

instead of

```
FC$ megatools df --username my@email.com --password mypassF[0]
```

when using the tools.

Configuration file is read either from the current directory or user’s home directory. Exceptions are when FC--ignore-config-fileF\[0\] was passed to the tool, or when explicit path to the config file was given via FC--config \<path\>F\[0\].

## CONFIG FILE SECTIONS

All sections are optional. All names are case sensitive, thus you must write \[Login\], and not \[login\], and so on.

### LOGIN SECTION

- Username

  Your username.

- Password

  Your password. Be aware that back slashes have special meaning. If you have back slash in your password, you must escape it with another backslash. For example: my\\nice\\password would be written as my\\\\nice\\\\password in the config file.

### CACHE SECTION

- Timeout

  Cache timeout in seconds (default is 10 minutes).

### NETWORK SECTION

- DownloadSpeedLimit

  Set maximum allowed download speed in KiB/s. 0 means no limit. Overrides SpeedLimit setting.

- UploadSpeedLimit

  Set maximum allowed upload speed in KiB/s. 0 means no limit. Overrides SpeedLimit setting. When using ParallelTransfers \> 1, upload speed limit is applied to each transfer individually.

- SpeedLimit

  Set maximum allowed upload and download speed in KiB/s. 0 means no limit.

- ParallelTransfers

  Set maximum allowed number of parallel connections when upload or downloading a file. The file is split into chunks of a size between 128 kiB and 1 MiB, and these chunks are uploaded in parallel. The number must be between 1 and 16. Default is 5.

- Proxy

  Use proxy server to connect to mega.nz. More information can be found in libcurl documentation at ⟨https://curl.haxx.se/libcurl/c/CURLOPT\_PROXY.html⟩. Some acceptable values are:

  - •

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

  - •

    FCsocks5h://localhost:9050F\[0\] : Local SOCKSv5 proxy server with DNS handled by the proxy

### UPLOAD SECTION

- CreatePreviews

  Create Previews (see --enable-previews option).

### UI SECTION

- Colors

  Enable color output in the progress reporting. Colors are disabled by default to support all kinds of terminal configurations. Colors are not configurable, yet.

## EXAMPLE

Create ~/.megarc (on linux) or mega.ini file containing these 3 lines:

```
FC[Login]
Username = your@email
Password = yourpassword
[Network]
# 1MiB/s
SpeedLimit = 1024
# Use over TOR
Proxy = socks5://127.0.0.1:9050
ParallelTransfers = 2
[UI]
Colors = trueF[0]
```

Run [**megatools-df**(1)](/megatools-df/1.md) to check that megatools are able to login to your account.

## 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/⟩.