megarc(5)

💖 megarc — the config file glow-up 💖

okay bestie, listen. this is the megarc(5) page — the manual for megatools' config file. it's giving "tiny file, huge time-saver" energy and honestly? we're obsessed. 💅

---

✨ NAME ✨

megarc — Configuration file for megatools 🎀

---

✨ SYNOPSIS ✨

~/.megarc
./.megarc

---

✨ DESCRIPTION ✨

so here's the tea: Megatools uses an INI configuration file to stash your commonly used login credentials. it makes the tools way less bothersome to use, because instead of typing your whole life story every single time, you can just write

$ megatools df

instead of

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

like… the difference is astronomical. no cap. 🌈

the config file gets read either from the current directory or from the user's home directory. the exceptions (the "not today" moments 🙈) are when --ignore-config-file was passed to the tool, or when you handed it an explicit path to the config file via --config <path>.

---

✨ CONFIG FILE SECTIONS ✨

every single section is optional. and heads up — all names are case sensitive, so you must write [Login], and not [login], and so on. yes really. the capitalization matters. periodt. 💀

🔐 LOGIN SECTION

• Username — Your username.
• Password — Your password. ⚠️ Be aware that back slashes have special meaning. If you have a 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. (the double-backslash is the moment, iykyk)

🗄️ 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:
  • socks5://localhost:9050 : Local SOCKSv5 proxy server
  • socks5h://localhost:9050 : 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. (yet!! manifesting future configurable colors for us 🕯️✨)

---

✨ 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

then run megatools-df(1) to check that megatools are able to login to your account. vibe check passed = you're in. 🫶

---

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

(the whole friend group, all iconic, all linked 💜)

---

✨ MEGATOOLS ✨

Part of the megatools(1) 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. (slay, contribute, become the main character of the changelog 🔥)

---

✨ AUTHOR ✨

Megatools was written by Ondrej Jirman < megatools@xff.cz ⟨mailto:megatools@xff.cz⟩ >, 2013-2022.

Official website is ⟨https://xff.cz/megatools/⟩. 🌸

---

and that's the whole page, bestie — megarc(5), dated 11 July 2025 💖 thanks for reading, go configure your login and go live your best command-line life 🦋✨