1megarc(5) megarc(5)
2
3
4
6 megarc - Configuration file for megatools
7
9 ~/.megarc
10 ./.megarc
11
13 Megatools use INI configuration file to store commonly used login cre‐
14 dentials. This makes it less bothersome to use the tools, as you can
15 simply write
16
17 $ megatools df
18
19 instead of
20
21 $ megatools df --username my@email.com --password mypass
22
23 when using the tools.
24
25 Configuration file is read either from the current directory or user’s
26 home directory. Exceptions are when --ignore-config-file was passed to
27 the tool, or when explicit path to the config file was given via --con‐
28 fig <path>.
29
31 All sections are optional. All names are case sensitive, thus you must
32 write [Login], and not [login], and so on.
33
34 LOGIN SECTION
35 Username
36 Your username.
37
38 Password
39 Your password. Be aware that back slashes have special meaning.
40 If you have back slash in your password, you must escape it with
41 another backslash. For example: my\nice\password would be writ‐
42 ten as my\\nice\\password in the config file.
43
44 CACHE SECTION
45 Timeout
46 Cache timeout in seconds (default is 10 minutes).
47
48 NETWORK SECTION
49 DownloadSpeedLimit
50 Set maximum allowed download speed in KiB/s. 0 means no limit.
51 Overrides SpeedLimit setting.
52
53 UploadSpeedLimit
54 Set maximum allowed upload speed in KiB/s. 0 means no limit.
55 Overrides SpeedLimit setting. When using ParallelTransfers > 1,
56 upload speed limit is applied to each transfer individually.
57
58 SpeedLimit
59 Set maximum allowed upload and download speed in KiB/s. 0 means
60 no limit.
61
62 ParallelTransfers
63 Set maximum allowed number of parallel connections when upload
64 or downloading a file. The file is split into chunks of a size
65 between 128 kiB and 1 MiB, and these chunks are uploaded in par‐
66 allel. The number must be between 1 and 16. Default is 5.
67
68 Proxy Use proxy server to connect to mega.nz. More information can be
69 found in libcurl documentation at
70 ⟨https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html⟩. Some ac‐
71 ceptable values are:
72
73 • socks5://localhost:9050 : Local SOCKSv5 proxy server
74
75 • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
76 handled by the proxy
77
78 UPLOAD SECTION
79 CreatePreviews
80 Create Previews (see --enable-previews option).
81
82 UI SECTION
83 Colors Enable color output in the progress reporting. Colors are dis‐
84 abled by default to support all kinds of terminal configura‐
85 tions. Colors are not configurable, yet.
86
88 Create ~/.megarc (on linux) or mega.ini file containing these 3 lines:
89
90 [Login]
91 Username = your@email
92 Password = yourpassword
93
94 [Network]
95 # 1MiB/s
96 SpeedLimit = 1024
97 # Use over TOR
98 Proxy = socks5://127.0.0.1:9050
99 ParallelTransfers = 2
100
101 [UI]
102 Colors = true
103
104 Run megatools-df(1) to check that megatools are able to login to your
105 account.
106
108 megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-
109 get(1), megatools-ls(1), megatools-mkdir(1), megatools-put(1), mega‐
110 tools-reg(1), megatools-rm(1), megatools-copy(1).
111
113 Part of the megatools(1) suite of commands.
114
116 Report bugs to megatools@megous.com ⟨mailto:megatools@megous.com⟩ .
117 Your message will end up in a public archive, so be careful what you
118 say or send.
119
121 Megatools was written by Ondrej Jirman < megatools@megous.com
122 ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
123
124 Official website is ⟨http://megatools.megous.com⟩.
125
126
127
128 20 July 2023 megarc(5)