Guia · CLI

Ferramenta de linha de comando

Envie direto do seu terminal. Um comando, saída JSON para scripts e multipart retomável para arquivos enormes. Código-fonte em GitHub.

macOS · Linux · WindowsCódigo abertoGo

Instalar

Homebrew (macOS e Linux)

Shell
$ brew install storageto/tap/storageto

Go

Shell
$ go install github.com/storageto/cli/cmd/storageto@latest

Garanta que ~/go/bin esteja em PATH.

Binários pré-compilados

Baixe o tarball adequado em Releases do GitHub (macOS ARM/Intel, Linux ARM/Intel).

Uso

Arquivo único

Shell
$ storageto upload photo.jpg

URL:     https://storage.to/FQxyz1234
Size:    2.1 MB
Expires: 2026-04-15T12:00:00Z

Vários arquivos

Informe vários caminhos ou um glob - eles são agrupados automaticamente em uma coleção:

Shell
$ storageto upload file1.txt file2.txt file3.txt
$ storageto upload *.log
$ storageto upload src/**/*.go

Arquivos grandes

Arquivos acima de 5 GB são automaticamente divididos em partes (chunked) e enviados em paralelo com multipart retomável. O progresso é exibido na linha:

Output
1.2 GB / 10.0 GB (12.0%)

Pressione Ctrl+C para cancelar - envios parciais são limpos automaticamente no servidor.

Flags

Flag
Descrição
-c, --collection
Forçar uma coleção mesmo para um único arquivo.
-v, --verbose
Mostrar saída detalhada do progresso.
--json
Gerar resultado em JSON (legível por máquina, ótimo para scripts).
--no-token
Envie totalmente de forma anônima - não leia nem escreva o arquivo do token de identidade.
--api <url>
Substituir o endpoint da API (padrão: https://storage.to).
-h, --help
Mostrar ajuda.

Saída em JSON

Shell
$ storageto upload photo.jpg --json
{
  "url": "https://storage.to/FQxyz1234",
  "filename": "photo.jpg",
  "size": 2202009,
  "human_size": "2.1 MB",
  "expires_at": "2026-04-15T12:00:00Z"
}

Token de identidade

A CLI armazena um visitor token aleatório no primeiro uso para que envios repetidos da mesma máquina compartilhem cota e atribuição. Não é um login de conta - é apenas um identificador por máquina.

Sistema operacional (OS)
Caminho
macOS
~/Library/Application Support/storageto/token
Linux
~/.config/storageto/token
Windows
%AppData%\storageto\token

Use --no-token para ignorar o arquivo de token completamente.

DicaOs carregamentos anónimos pela CLI estão limitados a 50 ficheiros por dia e expiram após 3 dias. Use um token de conta gratuita para remover os limites, ou um pago para manter os ficheiros para sempre.

Scripts

Encaminhe a saída --json para jq para extrair a URL:

Shell
URL=$(storageto upload build.zip --json | jq -r '.url')
echo "Uploaded to $URL"

Versão e atualizações

Shell
$ storageto version

Usuários do Homebrew: brew upgrade storageto. Usuários do Go: execute go install novamente com a tag mais recente.