megarc(5)

Table of Contents

1. NAME
2. SYNOPSIS
3. DESCRIPTION
4. CONFIG FILE SECTIONS
4.1. [Login] Section
4.2. [Cache] Section
4.3. [Network] Section
4.4. [Upload] Section
4.5. [UI] Section
5. EXAMPLE
6. SEE ALSO
7. MEGATOOLS
8. BUGS
9. AUTHOR

1. NAME

megarc - Configuration file for megatools

2. SYNOPSIS

~/.megarc
./.megarc

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

$ megatools df

instead of

$ megatools df --username my@email.com --password mypass

when using the tools.

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

4. CONFIG FILE SECTIONS

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

4.1. [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.

4.2. [Cache] Section

Timeout
Cache timeout in seconds (default is 10 minutes).

4.3. [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:

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

4.4. [Upload] Section

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

4.5. [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.

5. EXAMPLE

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

[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 = true

Run megatools-df(1) to check that megatools are able to login to your account.

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

7. MEGATOOLS

Part of the megatools(1) suite of commands.

8. BUGS

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

9. AUTHOR

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

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