Python library for the Mega.nz API
Supports:
- login
- upload
- download
- delete
- search
- sharing
- renaming
- moving files
Please check src/mega/data_structures.py for details about the objects returned by the API
from mega.client import Megamega = Mega()await mega.login(email, password)
await mega.login() # login using a temporary anonymous accountdetails = await mega.get_user()balance = await mega.get_balance()quota = await mega.get_quota()space = await mega.get_storage_space()files = await mega.get_files()deleted_files = await mega.get_files_in_node(4) # Options: root(2), inbox(3), trashbin (4)fs = await mega.build_file_system()file = await mega.upload('myfile.doc')
link = await mega.get_upload_link(file)
# see client.py for destination and filename optionspublic_exported_web_link = await mega.export('myfile.doc')
public_exported_web_link = await mega.export('my_mega_folder/my_sub_folder_to_share')
# e.g. https://mega.nz/#F!WlVl1CbZ!M3wmhwZDENMNUJoBsdzFngSearch returns every file/folder that contains the search query in its path
If you have these files in your account:
├── dir1
│ ├── file1.txt
│ └── file2.md
├── dir2
│ └── subdir
│ └── file3.log
├── trash_bin
│ └── file4.mov
└── file5.txtresult = await mega.search('file1.txt') # Returns a list with 1 element, dir1/file1.txt
result = await mega.search('file') # Returns a list with 5 elements
result = await mega.search('file', exclude_deleted=True) # Returns a list with 4 elements
result = await mega.search('.txt') # Returns a list with 2 elements
result = await mega.search('dir1/file') # Returns a list with 2 elementsLike search, but the path must start with the search query and only returns the first element (if found)
result = await mega.find('file3.log') # None
result = await mega.find('dir2/file3.log') # None
result = await mega.find('dir2/subdir/file3') # File() at dir2/subdir/file3.log'
result = await mega.find('dir2/subdir/file3.log') # File() at dir2/subdir/file3.log'folder = await mega.find('dir2/subdir')
await mega.upload('myfile.doc', dest_node=folder)file = await mega.find('dir2/subdir/file3.log')
await mega.download(file)
await mega.download(file, dest_path='/home/john-smith/Desktop')
await mega.download(file, dest_path='/home/john-smith/Desktop', dest_filename='my_logs.log')Download will show a progress bar on the terminal. To disable it, create an instance of the mega client with the progress bar disabled
mega = Mega(use_progress_bar=False)You can also disable the progress bar on an existing instance
mega.use_progress_bar = Falseurl = 'https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc'
await mega.download_url(url, dest_filename='my_file.zip')url = 'https://mega.co.nz/#F!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc'
await mega.download_folder_url(url, dest_path ="downloads/my_music")url = 'https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc'
await mega.import_public_url(url)
folder = await mega.find('dir2')
await mega.import_public_url(url, dest_node=folder)await mega.create_folder('new_folder')
await mega.create_folder('new_folder/sub_folder/subsub_folder')file = await mega.find('dir2/subdir/file3.log')
await mega.rename(file, new_name='dir2/subdir/old_logs.log')