node package manager


Cloudup CLI

The cloudup cli up(1) allows you to upload files to the cloud with ease.

Cloudup cli Cloudup interactive mode


Install with npm:

$ npm install -g up


$ 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: up [options] [file ...]
    open                   open matching stream
    copy                   copy matching stream's url
    streams                list streams
    config                 configure up(1)
    help [cmd]             display help for [cmd]
    -h, --help            output usage information
    -V, --version         output the version number
    -t, --title <name>    stream title name
    -s, --stream <id>     upload to the given stream
    -d, --direct          output direct links
    -f, --filename <str>  assign filename to stdin
    -T, --thumb-size <n>  thumbnail size in pixels [600]


Examples illustrating how to use the cloudup command-line tool to upload files and access your account.


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 :

Multiple Files

Upload several files at once by passing multiple filenames:

$ up simon-*.png
              simon-1.png :
              simon-2.png :
              simon-3.png :
              simon-4.png :
              simon-5.png :
              simon-6.png :
              simon-7.png :
              simon-8.png :
    simon-ball-ocean.png… :
    simon-ocean-stick-2.… : 71%… : 55%
          simon-ocean.png : 74%
                   stream :


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.

cloudup cli simon photos

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 :
        stream :


List your cloudup streams:

$ up streams 
                    Art (19)
                      C (2)
                   Cats (3)
        Cloudup - light (5)
                Cluster (3)
                 Design (35)
  Dolphins intelligence (8)
                   EXIF (6)
              Es6 yield (2)

Search for streams:

$ up streams australia
   Australia 2013 (63)

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.

interactive mode


Stream and item links that output to stdout may be opened in the browser by holding down command and double-clicking the url.