Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Automattic/cloudup-cli
cloudup command-line executable
https://github.com/Automattic/cloudup-cli
Last synced: 18 days ago
JSON representation
cloudup command-line executable
- Host: GitHub
- URL: https://github.com/Automattic/cloudup-cli
- Owner: Automattic
- License: mit
- Created: 2013-02-07T00:23:18.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2023-03-02T08:51:36.000Z (over 1 year ago)
- Last Synced: 2024-10-08T11:16:55.972Z (about 1 month ago)
- Language: JavaScript
- Homepage: https://cloudup.com
- Size: 105 KB
- Stars: 83
- Watchers: 109
- Forks: 17
- Open Issues: 24
-
Metadata Files:
- Readme: Readme.md
- Changelog: History.md
- License: LICENSE
Awesome Lists containing this project
README
# Cloudup CLI
The cloudup cli `up(1)` allows you to upload files to the cloud with ease.
## Installation
Install with npm:
```
$ npm install -g Automattic/cloudup-cli
```
Authenticate:
```
$ up config
Cloudup up(1) one-time configuration requires your
password, however it is transfered via https
and is not stored locally. Subsequent operations
use the auth token generated from this process.
Username: tobi
Password: ******
```
## Usage
```
Usage: up [options] [file ...]
Commands:
open open matching stream
copy copy matching stream's url
streams list streams
config configure up(1)
help [cmd] display help for [cmd]
Options:
-h, --help output usage information
-V, --version output the version number
-t, --title stream title name
-s, --stream upload to the given stream
-d, --direct output direct links
-f, --filename assign filename to stdin
-T, --thumb-size thumbnail size in pixels [600]
```
## Examples
Examples illustrating how to use the cloudup command-line tool
to upload files and access your account.
### Uploading
Upload a single file, the stream url is copied to your clipboard _immediately_
for sharing, even before the upload has completed.
```
$ up reflection.png
reflection.png : 92%
stream : https://cloudup.com/cHFtYYeB8fJ
```
#### Multiple Files
Upload several files at once by passing multiple filenames:
```
$ up simon-*.png
simon-1.png : https://cloudup.com/iqd4NLa13ZV
simon-2.png : https://cloudup.com/iCxBKJZAm36
simon-3.png : https://cloudup.com/iEzTZXvVRYP
simon-4.png : https://cloudup.com/iRYA6bLp70E
simon-5.png : https://cloudup.com/ilMqsXxtTsV
simon-6.png : https://cloudup.com/ilVngVMMeSd
simon-7.png : https://cloudup.com/i1Tx8vkIbCC
simon-8.png : https://cloudup.com/ifUKcaz5I3A
simon-ball-ocean.png… : https://cloudup.com/iCA5N2PCJJS
simon-ocean-stick-2.… : 71%
simon-ocean-stick.pn… : 55%
simon-ocean.png : 74%
stream : https://cloudup.com/c7WwhIwSl6Y
```
#### Thumbnails
`up(1)` delivers thumbnails when possible before the files are uploaded, so viewers can
see what they're getting before-hand, and progress is updated in real-time.
#### STDIN
When no filenames are given `up(1)` reads from __stdin__:
```
$ echo 'hello world' | up
```
A filename can be passed to help cloudup interpret the content:
```
$ echo 'hello __world__' | up --filename hello.md
```
#### Upload Options
You may optionally provide a stream `--title` upon upload, otherwise Cloudup
will generate one for you based on the content:
```
$ up ferrets/*.png --title Ferrets
```
You may also upload to an existing stream by passing `--stream`:
```
$ up simon.png --stream c7WwhIwSl6Y
```
If you prefer direct links you may use `--direct`:
```
$ up example.jpeg --direct
example.jpeg : http://i.cloudup.com/uBuZVUk80lK/SXSc1V.jpeg
stream : https://cloudup.com/c1rAycLAdHo
```
### Streams
List your cloudup streams:
```
$ up streams
Art (19) https://cloudup.com/cQD5fdgPrU1
C (2) https://cloudup.com/c4f5h12Ti1T
Cats (3) https://cloudup.com/cVeLe7dWdEH
Cloudup - light (5) https://cloudup.com/ce4R6fdsQo
Cluster (3) https://cloudup.com/cQJg8sdf7qO
Design (35) https://cloudup.com/c7nHCsd30hhF
Dolphins intelligence (8) https://cloudup.com/c5Hy71w2fWe
EXIF (6) https://cloudup.com/coRcOdfXXiom
Es6 yield (2) https://cloudup.com/cJWXLX1af2t
```
Search for streams:
```
$ up streams australia
Australia 2013 (63) https://cloudup.com/c_nzIQcjCWo
```
Copy the first matching stream to the clipboard:
```
$ up copy australia
```
Open the first matching stream in your default browser:
```
$ up open australia
```
### Interactive Mode
The `-i` or `--interactive` flag may be used to list streams in an
interactive list using the arrow keys to traverse the list. Pressing
_return_ will open the stream or item in your default browser.
The `up` / `down` arrows for navigating the list, and `left` / `right`
to view the items or go back to the stream list.
## Tips
Stream and item links that output to stdout may be opened
in the browser by holding down __command__ and double-clicking
the url.
## License
(The MIT License)
Copyright (c) 2014 Automattic, Inc and contributors <[email protected]>
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.