1megatools-put(1) megatools-put(1)
2
6 megatools put - upload files to your Mega.nz account
7
9 megatools put [--no-progress] [--path <remotepath>] <paths>...
10
12 Uploads files to your Mega.nz account.
13 NOTE: If you want to upload entire directories, use megatools-copy(1).
15
17 --path <remotepath>
18 Remote path to upload to. If this path is a directory, files are
19 placed into the directory. If this path doesn’t exist, and it’s
20 parent directory does, the file will be uploaded to a specified
21 path (this only works if you specify exactly one file).
22 --no-progress
24 Disable upload progress reporting.
25 --enable-previews
27 Generate and upload file previews, when uploading new files.
28 This is the default, unless you changed it in the configuration
29 file. Use this to override the option from the configuration
30 file.
31 --disable-previews
33 Don’t generate and upload file previews. Default is to generate
34 previews.
35 -u <email> , --username <email>
37 Account username (email)
38 -p <password> , --password <password>
40 Account password
41 --no-ask-password
43 Never ask interactively for a password
44 --reload
46 Reload filesystem cache
47 --limit-speed <speed>
49 Set maximum allowed upload and download speed in KiB/s. This
50 option overrides config file settings. 0 means no limit. When
51 using ParallelTransfers > 1, upload speed limit is applied to
52 each transfer individually.
53 --proxy <proxy>
55 Use proxy server to connect to mega.nz. This option overrides
56 config file settings. More information can be found in libcurl
57 documentation at ⟨https://curl.haxx.se/libcurl/c/CUR‐
58 LOPT_PROXY.html⟩. Some acceptable values are:
59 • none : Disable proxy if it was enabled in the config file.
61 • socks5://localhost:9050 : Local SOCKSv5 proxy server
63 • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
65 handled by the proxy
66 --netif <ifname|ip>
68 Network interface or local IP address used for outgoing connec‐
69 tions. You have to specify IP address bound to some of your lo‐
70 cal network interfaces, when specifying an IP address.
71 --ip-proto <proto>
73 Which IP protocol to prefer when connecting to mega.nz (v4, v6,
74 or any). This is just an advisory option. Megatools will re‐
75 solve mega.nz domain, and then use an A or AAAA record based on
76 the stated preference.
77 --config <path>
79 Load configuration from a file
80 --ignore-config-file
82 Disable loading .megarc
83 --debug [<options>]
85 Enable debugging of various aspects of the megatools operation.
86 You may enable multiple debugging options separated by commas.
87 (eg. --debug api,fs)
88 Available options are:
90 • http: Dump HTTP request/response details (can be used to debug
92 connection/proxy issues)
93 • api: Dump Mega.nz API calls
95 • fs: Dump Mega.nz filesystem (may require --reload to actually
97 print something)
98 • cache: Dump cache contents
100 • tman: Dump transfer manager events
102 --version
104 Show version information
105 <paths>
107 One or more local files to upload.
108
110 • Upload file to the /Root:
111 $ megatools put README
113 $ megatools ls /Root
114 /Root
116 /Root/README
117 • Upload file, while naming it differently:
119 $ megatools put --path /Root/README.TXT README
121 $ megatools ls /Root
122 /Root
124 /Root/README.TXT
125
127 Mega.nz filesystem is represented as a tree of nodes of various types.
128 Nodes are identified by a 8 character node handles (eg. 7Fdi3ZjC).
129 Structure of the filesystem is not encrypted.
130 Megatools maps node tree structure to a traditional filesystem paths
132 (eg. /Root/SomeFile.DAT).
133 NOTE: By the nature of Mega.nz storage, several files in the directory
135 can have the same name. To allow access to such files, the names of
136 conflicting files are extended by appending dot and their node handle
137 like this:
138 /Root/conflictingfile
140 /Root/conflictingfile.7Fdi3ZjC
141 /Root/conflictingfile.mEU23aSD
142 You need to be aware of several special folders:
144 /Root Writable directory representing the root of the filesystem.
146 /Trash Trash directory where Mega.nz web client moves deleted files.
148 This directory is not used by megatools when removing files.
149 /Inbox Not sure.
151 /Contacts
153 Directory containing subdirectories representing your contacts
154 list. If you want to add contacts to the list, simply create
155 subdirectory named after the contact you want to add.
156 /Contacts/<email>
158 Directories representing individual contacts in your contacts
159 list. These directories contain folders that others shared with
160 you. All shared files are read-only, at the moment.
161
163 megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-
164 get(1), megatools-ls(1), megatools-mkdir(1), megatools-put(1), mega‐
165 tools-reg(1), megatools-rm(1), megatools-copy(1).
166
168 Part of the megatools(1) suite of commands.
169
171 Report bugs to megatools@megous.com ⟨mailto:megatools@megous.com⟩ .
172 Your message will end up in a public archive, so be careful what you
173 say or send.
174
176 Megatools was written by Ondrej Jirman < megatools@megous.com
177 ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
178 Official website is ⟨http://megatools.megous.com⟩.
180 20 July 2023 megatools-put(1)