MEGATOOLS(7)

📦 version 1.10.3, in ubuntu jammy

💖 MEGATOOLS 💖 (that's the manual page, section 7, bestie)

okay so welcome to the megatools manual — it lives in section 7 of the manual, and it's basically the group chat hub for the whole squad of Mega.nz command line tools. pull up a chair. 🫶

✨ NAME ✨

megatools — Mega.nz command line tools. that's it, that's the vibe. 👑

🌸 SYNOPSIS 🌸

megadf [--free|--total|--used] [--mb|--gb|-h]
megals [-e] [-h] [--header] [-l] [-R] [-n] [<remotepaths>...]
megaput [--no-progress] [--path <remotepath>] <paths>...
megamkdir <remotepaths>...
megamkdir /Contacts/<contactemail>
megaget [--no-progress] [--path <path>] <remotepaths>...
megaget --path - <remotefile>
megarm <remotepaths>...
megarm /Contacts/<contactemail>
megadl [--no-progress] [--path <path>] <links>...
megadl --path - <filelink>
megareg [--scripted] --register --email <email> --name <realname> --password <password>
megareg [--scripted] --verify <state> <link>

like. look at all of them. a whole friend group. 💅

🦋 DESCRIPTION 🦋

Megatools is a lil collection of programs that let you talk to the Mega service straight from the command line of your desktop or your server. no browser, no fuss, no drama. ✨

With Megatools you can copy individual files, but also entire directory trees, to and from the cloud. and — this is the part that's giving main character energy — you can do streaming downloads, so you can preview videos and audio files without downloading the whole entire file first. iconic behavior tbh. 🎬

Megatools is robust and optimized for fast operation — as fast as Mega servers allow, which, ok, it's their speed limit not ours. Memory requirements and CPU utilization are kept at minimum. lowkey the most considerate tool in your whole $PATH. 🌱

You can register an account using the megareg(1) tool, and the perk is that you get true control of your encryption keys. yes bestie, YOUR keys. 🔑

The Mega website can be found at http://mega.nz. 🏠

Megatools can be downloaded at http://megatools.megous.com. 📦

👑 TOOLS OVERVIEW 👑

  • megareg(1) — Register and verify a new mega account. the origin story. 🌱
  • megadf(1) — Show your cloud storage space usage/quota. your storage vibe check. 📊
  • megals(1) — List all remote files. window shopping, but make it filesystem. 🛍️
  • megamkdir(1) — Create remote directory. build the folder bestie. 🏗️
  • megarm(1) — Remove remote file or directory. goodbye era. 👋
  • megaput(1) — Upload individual files. yeet them into the cloud. ☁️
  • megaget(1) — Download individual files. bring them home. 🏡
  • megadl(1) — Download file from a "public" Mega link (doesn't require login). no account? no problem. 🙈
  • megacopy(1) — Upload or download a directory tree. the whole tree. all of it. 🌳

🎀 CONFIGURATION FILES 🎀

See megarc(5) for info about the mega configuration file. that's where the settings live, iykyk. 📝

Each of the individual tools has help that you can access using the --help parameter. so if you're ever lost, just ask politely with --help and it'll spill. 💬

💜 SESSION CACHE 💜

okay this one matters: if you modify your cloud filesystem from the Mega.nz website or from another computer, you'll need to refresh your session cache. ✨

how? two ways, pick your fighter:

  • use the --reload option with any tool 🌀
  • or just wait for a cache timeout — the default timeout is set to 10 minutes ⏳

🌈 REMOTE FILESYSTEM 🌈

Mega.nz filesystem is represented as a tree of nodes of various types. Nodes are identified by a 8 character node handles (eg. 7Fdi3ZjC). Structure of the filesystem is not encrypted. 🗂️

Megatools maps that node tree structure onto traditional filesystem paths (eg. /Root/SomeFile.DAT). cute, right? 🌸

NOTE: by the nature of Mega.nz storage, several files in the same directory can have the exact same name. 😭 to let you actually get to all of them, the names of conflicting files get extended by appending a dot and their node handle, like this:
/Root/conflictingfile
/Root/conflictingfile.7Fdi3ZjC
/Root/conflictingfile.mEU23aSD

You need to be aware of several special folders:

  • /Root — Writable directory representing the root of the filesystem. the mothership. 🏠
  • /Trash — Trash directory where the Mega.nz web client moves deleted files. This directory is not used by megatools when removing files. so don't expect your megarm deletions to show up in there, bestie. 🗑️
  • /Inbox — Not sure. honestly? same. 🤷‍♀️
  • /Contacts — Directory containing subdirectories representing your contacts list. If you want to add contacts to the list, simply create a subdirectory named after the contact you want to add. adding friends by making a folder is SO unhinged and I'm obsessed. 🫶
  • /Contacts/<email> — Directories representing individual contacts in your contacts list. These directories contain folders that others shared with you. All shared files are read-only, at the moment. 👀

⭐ SEE ALSO ⭐

megatools(7), megarc(5), megadf(1), megadl(1), megaget(1), megals(1), megamkdir(1), megaput(1), megareg(1), megarm(1), megacopy(1). the whole squad, linked together. 🔗

🧚 MEGATOOLS 🧚

Part of the megatools(7) suite. yes, this page is part of itself. she's self-referential, she contains multitudes. 💅

💀 BUGS 💀

Report bugs at https://github.com/megous/megatools or megous@megous.com. found a gremlin? tell on it. 🐛

🌟 AUTHOR 🌟

Megatools was written by Ondrej Jirman <megous@megous.com>, 2013-2016. thank you for your service king. 🫡

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

and that's the whole page bestie!! this was megatools 1.10.2, dated 04/15/2020 — the megatools(7) suite, forever iconic, no cap. go forth and upload responsibly. 💖✨🎀🦋🌸

📦 where this page comes from