{"id":23740108,"url":"https://github.com/cobbzilla/mobiletto-cli","last_synced_at":"2026-03-03T21:30:21.377Z","repository":{"id":58116976,"uuid":"529700122","full_name":"cobbzilla/mobiletto-cli","owner":"cobbzilla","description":"Command-line interface (CLI) for mobiletto storage","archived":false,"fork":false,"pushed_at":"2023-05-03T03:40:02.000Z","size":1135,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T14:35:24.687Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cobbzilla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-08-27T21:25:10.000Z","updated_at":"2023-03-05T03:15:15.000Z","dependencies_parsed_at":"2024-01-13T04:22:46.934Z","dependency_job_id":null,"html_url":"https://github.com/cobbzilla/mobiletto-cli","commit_stats":{"total_commits":73,"total_committers":1,"mean_commits":73.0,"dds":0.0,"last_synced_commit":"41fbdd1182367c63aefed6500653e4fb0d359f2d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobbzilla%2Fmobiletto-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobbzilla%2Fmobiletto-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobbzilla%2Fmobiletto-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobbzilla%2Fmobiletto-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cobbzilla","download_url":"https://codeload.github.com/cobbzilla/mobiletto-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239886381,"owners_count":19713475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-31T09:47:04.915Z","updated_at":"2026-03-03T21:30:21.305Z","avatar_url":"https://github.com/cobbzilla.png","language":"JavaScript","funding_links":["https://www.patreon.com/cobbzilla"],"categories":[],"sub_categories":[],"readme":"mobiletto-cli\n=============\nA command-line interface (CLI) for [mobiletto](https://www.npmjs.com/package/mobiletto)\nstorage.\n\nMobiletto supports connections to Amazon S3, Backblaze B2, and local filesystems.\n\n# Read this in another language\nThis README.md document has been translated, via [hokeylization](https://github.com/cobbzilla/hokeylization), into\n**[every language supported by Google Translate](https://cloud.google.com/translate/docs/languages)!**\n\nI'm certain it's not perfect, but I hope it's better than nothing!\n\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇸🇦 Arabic](docs/ar/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇧🇩 Bengali](docs/bn/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇩🇪 German](docs/de/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇺🇸 English](docs/en/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇪🇸 Spanish](docs/es/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇫🇷 French](docs/fr/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇹🇩 Hausa](docs/ha/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇮🇳 Hindi](docs/hi/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇮🇩 Indonesian](docs/id/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇮🇹 Italian](docs/it/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇯🇵 Japanese](docs/ja/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇰🇷 Korean](docs/ko/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇮🇳 Marathi](docs/mr/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇵🇱 Polish](docs/pl/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇧🇷 Portuguese](docs/pt/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇷🇺 Russian](docs/ru/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇰🇪 Swahili](docs/sw/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇵🇭 Tagalog](docs/tl/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇹🇷 Turkish](docs/tr/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇵🇰 Urdu](docs/ur/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇻🇳 Vietnamese](docs/vi/README.md)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;[🇨🇳 Chinese](docs/zh/README.md)\n\u003cbr/\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;**[📚 ... All Languages ...](docs/README.md)**\n----\n\n### Is there a problem with this translation of the README?\nThis particular translation of the original [README](https://github.com/cobbzilla/mobiletto-cli/blob/master/README.md)\nmay be flawed -- *corrections are very welcome!* Please send a [pull request on GitHub](https://github.com/cobbzilla/mobiletto-cli/pulls),\nor if you're not comfortable doing that, [open an issue](https://github.com/cobbzilla/mobiletto-cli/issues)\n\nWhen you create a new GitHub issue about a translation, please do:\n* include the page URL (copy/paste from browser address bar)\n* include the exact text that is wrong (copy/paste from browser)\n* please describe what is wrong -- is the translation incorrect? is the formatting broken somehow?\n* kindly offer a suggestion of a better translation, or how the text should be properly formatted\n* **Thank you!**\n\n# Contents\n* [Source](#Source)\n* [Support and Funding](#Support-and-Funding)\n* [Installation and usage](#Installation-and-usage)\n  * [npm package](#npm-package)\n  * [From source](#From-source)\n* [Connections](#Connections)\n  * [Create a connection](#Create-a-connection)\n  * [List connections](#List-connections)\n  * [Dump connection JSON config](#Dump-connection-JSON-config)\n  * [Remove a connection](#Remove-a-connection)\n  * [Remove all connections](#Remove-all-connections)\n* [Working with storage](#Working-with-storage)\n  * [List files](#List-files)\n  * [Write a file to stdout](#Write-a-file-to-stdout)\n  * [Copy files](#Copy-files)\n  * [Delete files](#Delete-files)\n  * [View metadata](#View-metadata)\n  * [Mirror directories](#Mirror-directories)\n\n### Source\n* [mobiletto-cli on GitHub](https://github.com/cobbzilla/mobiletto-cli)\n* [mobiletto-cli on npm](https://www.npmjs.com/package/mobiletto-cli)\n\n## Support and Funding\nI would be sincerely grateful for any [contribution via Patreon](https://www.patreon.com/cobbzilla)\n\n## Installation and usage\nYou can install and run `mobiletto-cli` via npm or directly from source.\n\n### npm package\n    # install globally with npm\n    npm i -g mobiletto-cli\n\n    # install globally with yarn\n    yarn global add mobiletto-cli\n\n    # Now the 'mo' command should be on your PATH\n    mo -h\n    mo --help\n\n### From source\nTo run from source, you'll need nodejs v16+ and yarn\n\n    # Clone source and install dependencies\n    git clone https://github.com/cobbzilla/mobiletto-cli.git\n    cd mobiletto-cli\n    yarn install\n\n    # Use the 'mo' command from the git repo\n    ./mo -h\n    ./mo --help\n\n## Connections\nAll mobiletto storage is accessed through a connection.\n\nMobiletto currently supports connections to the local filesystem storage and Amazon S3 buckets.\n\nConnections are specified by a JSON object that looks like this:\n\n    {\n        \"name\": \"name-of-connection\",\n        \"type\": \"s3\",            # one of \"s3\", \"b2\", or \"local\"\n        \"opts\": {\n            \"readOnly\": false,   # optional, default false\n            \"cacheSize\": 100,    # optional, \n            ... other type-specific options ...\n        },\n        \"encryption\": {          # optional, default is no encryption\n            \"key\": \"enc-key\",    # required if encryption is enabled\n            \"iv\": \"enc-IV\",      # optional, derived from key if omitted\n            \"algo\": \"enc-algo\"   # optional, default is aes-256-cbc\n        }\n    }\n\nFor full details on all the options and their values and meanings, see the\n[mobiletto docs](https://www.npmjs.com/package/mobiletto#Basic-usage).\n\n### Create a connection\nTo create a new connection, we need one of these JSON objects.\n\nWe can create one interactively, or supply one via a file or JSON literal:\n\n    # Create JSON via interactive prompts\n    mo connect \n\n    # Create via interactive prompts, but force name `my-conn` to be used\n    mo connect -c my-conn \n    mo connect --create my-conn     # long-form option\n\n    # Create from JSON config\n    mo connect my-conn.json\n\n    # Create from JSON config, but force name `renamed` to be used\n    mo connect -c renamed my-conn.json\n\n    # Create from literal JSON object\n    mo connect '{\n        \"name\": \"my-conn\",\n        \"type\": \"local\",\n        \"key\": \"/tmp/basedir\"\n    }'\n\n### List connections\nList available connections:\n\n    mo connect -l\n    mo connect --list\n\n### Dump connection JSON config\nShow the full JSON config for a connection. **WARNING** this will print keys and secrets to stdout.\n\n    mo connect -d my-conn\n    mo connect --dump my-conn\n\n    # pretty-print JSON\n    mo connect --verbose --dump my-conn\n    mo connect -vd my-conn\n\n### Remove a connection\nRemove a single connection:\n\n    mo connect -r my-conn\n    mo connect --remove my-conn\n\n### Remove all connections\nRemove ALL connections:\n\n    mo connect -R\n    mo connect --remove-all\n\n## Working with storage\nOnce you have created some connections, use the `ls`, `cp`, `rm`, `meta` and `mirror` operations\nto work with them.\n\nEvery file path that you provide to a command must be prefixed with the name of the connection\nit refers to. In the examples below, we assume two connections exist named `conn1` and `conn2`\n\n### List files\nThe output of a list command is a series of JSON objects, one per line, representing the files\nfound. These objects will have a `name` and `type`, and possibly other fields.\n\n    mo ls conn1/some/path\n\nList files recursively:\n\n    mo ls -r conn1/some/path\n    mo ls --recursive conn1/some/path\n\n**Encrypted storage note**: Recursive listing is not yet supported for encrypted connections.\nYou can only list one directory of files at a time.\n\nList files verbosely (pretty-print JSON):\n\n    mo ls -v conn1/some/path\n    mo ls --verbose conn1/some/path\n\nList files recursively and verbosely:\n\n    mo ls -vr conn1/some/path\n    mo ls --verbose --recursive conn1/some/path\n\nView help for `ls` command, describes all options:\n\n    mo ls -h\n    mo ls --help\n\n### Write a file to stdout\nThe `cat` command will print a file to stdout:\n\n    mo cat conn1/some/file                         # print to terminal\n    mo cat conn1/some/file | some-other-command    # use in command pipeline\n\nIn the true UNIX spirit *(yet certainly not the practice!)* mobiletto's `cat` command **takes no options**\nother than `-h`/`--help` to display helpful information.\n\n### Copy files\nCopy a single file from one mobiletto to another:\n\n    mo cp conn1/some/path/to/file conn2/some/dest/path/\n\nCopy a single file from one mobiletto to another, renaming it at the destination:\n\n    mo cp conn1/some/path/to/file conn2/some/dest/path/file2\n\nRecursively copy a directory:\n\n    mo cp -r conn1/some/directory conn2/some/dest/\n\nView help for `cp` command, describes all options:\n\n    mo cp -h\n    mo cp --help\n\nNote: File copying is not very fast, because it currently requires an intermediary temp file. \n\n### Delete files\nDelete a single file:\n\n    mo rm conn1/some/file.txt\n\nDelete a single file and don't complain about any errors:\n\n    mo rm -f conn1/some/file.txt\n    mo rm --force conn1/some/file.txt\n\nDelete a directory:\n\n    mo rm -r conn1/some/directory\n    mo rm --recursive conn1/some/directory\n\nDelete a directory and don't complain about any errors:\n\n    mo rm -rf conn1/some/directory\n    mo rm --recursive --force conn1/some/directory\n\n### View metadata\nIt's often useful to know the metadata for a file, without downloading the whole file.\n\nMobiletto is able to report the file size and last modified time, in addition to name and type.\n\nTo view metadata:\n\n    mo meta conn1/some/file.txt\n\n### Mirror directories\nMirroring is more than a special case of `cp`, it is a separate mobiletto command that wraps the\ncopy operation; it continues even when errors occur, and counts the number of successes and errors.\n\nTo mirror everything from conn1 into conn2:\n\n    mo mirror conn1 conn2\n\nTo mirror a subdirectory: \n\n    mo mirror conn1/some/subdir conn2\n\nTo mirror a subdirectory into another subdirectory: \n\n    mo mirror conn1/some/subdir conn2/another/dir\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobbzilla%2Fmobiletto-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcobbzilla%2Fmobiletto-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobbzilla%2Fmobiletto-cli/lists"}