'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH megarc 5 "14 April 2020" "" ""
.SH NAME
megarc \- Configuration file for megatools
.SH SYNOPSIS
.RS 
.nf
\fI~/.megarc\fR
\fI\&./.megarc\fR
.fi
.RE
.SH 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
.PP
.nf
\*(T<$ megatools df\*(T>
.fi
.PP
instead of
.PP
.nf
\*(T<$ megatools df \-\-username my@email.com \-\-password mypass\*(T>
.fi
.PP
when using the tools.
.PP
Configuration file is read either from the current directory or user\(cqs home
directory. Exceptions are when \*(T<\-\-ignore\-config\-file\*(T> was passed to the tool, or
when explicit path to the config file was given via \*(T<\-\-config <path>\*(T>.
.SH "CONFIG FILE SECTIONS"
All sections are optional. All names are case sensitive, thus you must write
[Login], and not [login], and so on.
.SS "LOGIN SECTION"
.TP 
Username 
Your username.
.TP 
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\enice\epassword would be written as
my\e\enice\e\epassword in the config file.
.SS "CACHE SECTION"
.TP 
Timeout 
Cache timeout in seconds (default is 10 minutes).
.SS "NETWORK SECTION"
.TP 
DownloadSpeedLimit 
Set maximum allowed download speed in KiB/s.
0 means no limit. Overrides SpeedLimit setting.
.TP 
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.
.TP 
SpeedLimit 
Set maximum allowed upload and download speed in KiB/s.
0 means no limit.
.TP 
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.
.TP 
Proxy 
Use proxy server to connect to mega.nz.
More information can be found in libcurl documentation at
\(lahttps://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html\(ra.
Some acceptable values are:
.RS 
.TP 0.2i
\(bu
\*(T<socks5://localhost:9050\*(T> : Local SOCKSv5 proxy server
.TP 0.2i
\(bu
\*(T<socks5h://localhost:9050\*(T> : Local SOCKSv5 proxy server with DNS handled by the proxy
.RE
.SS "UPLOAD SECTION"
.TP 
CreatePreviews 
Create Previews (see --enable-previews option).
.SS "UI SECTION"
.TP 
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.
.SH EXAMPLE
Create ~/.megarc (on linux) or mega.ini file containing these 3 lines:
.PP
.nf
\*(T<[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\*(T>
.fi
.PP
Run \fBmegatools-df\fR(1) to check that megatools are able to login to your account.
.SH "SEE ALSO"
\fBmegatools\fR(1),
\fBmegarc\fR(5),
\fBmegatools-df\fR(1),
\fBmegatools-dl\fR(1),
\fBmegatools-get\fR(1),
\fBmegatools-ls\fR(1),
\fBmegatools-mkdir\fR(1),
\fBmegatools-put\fR(1),
\fBmegatools-reg\fR(1),
\fBmegatools-rm\fR(1),
\fBmegatools-copy\fR(1).
.SH MEGATOOLS
Part of the \fBmegatools\fR(1) suite of commands.
.SH BUGS
Report bugs to 
.URL mailto:megatools@megous.com megatools@megous.com
\&. Your message will end up in a public
archive, so be careful what you say or send.
.SH AUTHOR
Megatools was written by Ondrej Jirman <
.URL mailto:megatools@megous.com megatools@megous.com
>, 2013-2019.
.PP
Official website is \(lahttp://megatools.megous.com\(ra.