Guia de utilização

Português (Portugal)

Início rápido

# enviar um ficheiro: palavra-passe gerada automaticamente, mostra o link e a palavra-passe
$ ttl send secret.pdf
No password provided. Generate one? [Y/n]:
Generated password: aB3kL9mXq7Rt
·✧★◉ Thank goodness, secret.pdf is in orbit (1.2 MB, expires 2026-10-08 12:00)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mXq7Rt
Manage key: k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz (ttl status / ttl delete -k)
https://ttlspaceusercontent.com/aBcDeFgHiJ

# transferir: pede a palavra-passe de forma interativa
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

A CLI trata da encriptação, do carregamento, da transferência e da desencriptação. O servidor nunca vê a sua palavra-passe nem os dados em texto simples.

Instalação

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl
$ scoop install ttl

Binário pré-compilado

# transfira a versão para a sua plataforma a partir de releases
$ curl -Lo ttl.tar.gz \
  https://github.com/tweenietomatoes/ttl/releases/download/v1.6.2/ttl_1.6.2_linux_amd64.tar.gz
$ tar xzf ttl.tar.gz && sudo mv ttl /usr/local/bin/

Instalar com Go

$ go install github.com/tweenietomatoes/ttl/cmd/ttl@latest

A partir do código-fonte

$ git clone https://github.com/tweenietomatoes/ttl
$ cd ttl && go build -o ttl ./cmd/ttl/
$ sudo mv ttl /usr/local/bin/

Verificar

$ ttl version
ttl 1.6.2

Enviar ficheiros

Envio básico

# gera a palavra-passe automaticamente, TTL predefinido de 7d
$ ttl send report.xlsx

Quando não é indicada nenhuma palavra-passe num terminal, a CLI pergunta:

No password provided. Generate one? [Y/n]:

Prima Enter ou escreva y para gerar automaticamente.

Palavra-passe personalizada

$ ttl send -p mySecretPass -t 1h document.pdf

Eliminar após leitura

# eliminado depois de transferido; uma transferência interrompida pode ser retomada e não o consome
$ ttl send -b photo.jpg

TTL personalizado

$ ttl send -t 5m temp-credentials.txt   # expira em 5 minutos
$ ttl send -t 30m meeting-link.txt      # expira em 30 minutos
$ ttl send -t 6h backup.tar.gz          # expira em 6 horas
$ ttl send -t 1d daily-report.pdf       # expira em 1 dia
$ ttl send -t 3d project-archive.zip    # expira em 3 dias
$ ttl send -t 5d design-assets.zip      # expira em 5 dias
$ ttl send report.xlsx                  # expira em 7 dias (predefinição)

Ficheiros grandes

Um ficheiro até 16 MiB segue num único pedido; um maior segue em partes retomáveis de 16 MiB, duas de cada vez. Cada pedido é verificado com um resumo SHA-256 e um que falhe pelo caminho é enviado novamente; as partes já enviadas mantêm-se. Ctrl-C cancela de forma limpa.

Transferir ficheiros

Interativo (terminal)

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)

A palavra-passe não é mostrada no terminal. O nome original do ficheiro é preservado; se esse nome já existir na pasta de destino, o ficheiro é guardado como name (1).ext em vez de ser substituído.

Apenas com o token

# pode usar apenas o token de 10 carateres em vez do URL completo
$ ttl get aBcDeFgHiJ

Pasta de destino

$ ttl get -o ~/Downloads aBcDeFgHiJ

Por predefinição, os ficheiros são guardados na pasta atual. Utilize -o / --output para indicar outra pasta.

Com a opção de palavra-passe

$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ

Transferências interrompidas

Uma transferência interrompida retoma a partir do último byte recebido; cada bloco de 64 KiB é autenticado individualmente, pelo que o resultado é idêntico ao de uma transferência sem interrupções. Um ficheiro de utilização única (eliminar após leitura) é consumido quando uma transferência o obtém por inteiro: uma interrompida retoma onde parou e o ficheiro fica disponível para nova tentativa.

Navegador

Também pode transferir e desencriptar ficheiros no navegador, acedendo diretamente ao link. A interface web utiliza o mesmo formato de ficheiro e os mesmos algoritmos (Argon2id, XChaCha20-Poly1305) e pede a palavra-passe. Não é necessário instalar software.

Chave de gestão

Cada carregamento vem com uma chave de gestão, apresentada uma só vez por ttl send (manage_key em --json). O servidor guarda apenas o respetivo hash. Em qualquer plano, permite acompanhar o carregamento ou terminá-lo mais cedo; quem tiver a chave pode eliminar o carregamento, por isso guarde-a como a palavra-passe.

# estado, transferências e expiração do seu próprio carregamento
$ ttl status aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Token:      aBcDeFgHiJ
State:      active
Size:       4.2 MB
Created:    2026-10-01 12:00
Expires:    2026-10-08 12:00
Downloads:  1 (last 2026-10-02 09:12)

# eliminar mais cedo
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

O estado pode ser active, expired, burned ou deleted.

Gestão da palavra-passe

A palavra-passe é a semente da chave de encriptação. Nunca sai do seu dispositivo e nunca é enviada ao servidor. Há seis formas de a indicar:

1. Gerar automaticamente (apenas no envio)

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: y
Generated password: aB3kL9mXq7Rt

Gera uma palavra-passe criptograficamente aleatória de 12 carateres a partir de [0-9A-Za-z]. Só disponível durante send (de forma interativa ou automaticamente no modo --json).

2. Pedido interativo

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: n
Enter password: ********
Confirm password: ********

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********

A palavra-passe não é mostrada ao escrever. Durante send, escolhe se quer gerá-la automaticamente; se escrever a sua, tem de a confirmar. Durante get, é-lhe pedida diretamente.

3. Opção: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password é visível na saída de ps aux e pode ficar guardada no histórico da shell (~/.bash_history). Evite-a em ambientes partilhados e em scripts. Utilize antes --password-stdin ou --password-file.

4. Stdin: --password-stdin

# a partir de echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# a partir de um gestor de palavras-passe
$ pass show ttl/key | ttl send --password-stdin data.zip

# a partir de uma variável de ambiente
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

# here-string
$ ttl send --password-stdin report.pdf <<<"mySecretPass"

Lê a primeira linha de stdin. Útil em scripts, pipelines de CI/CD e automação. Quando stdin não é um terminal e não é indicada nenhuma origem da palavra-passe, a CLI termina com um erro (a menos que se utilize --json, que gera uma palavra-passe automaticamente).

5. Ficheiro: --password-file

$ ttl send --password-file /run/secrets/key report.xlsx
$ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ

Lê a primeira linha do ficheiro (sem a mudança de linha final). Compatível com segredos do Docker (/run/secrets/), ficheiros do agente Vault e padrões semelhantes.

6. Ficheiro detetado automaticamente: ttl.password

Se não for indicada nenhuma palavra-passe explícita, a CLI procura um ficheiro ttl.password junto ao binário e, depois, ~/.ttl/password. A primeira linha é utilizada como palavra-passe.

Só pode ser utilizada uma origem explícita de palavra-passe de cada vez. Combinar -p / --password, --password-stdin e --password-file é um erro. O ficheiro ttl.password detetado automaticamente só é verificado quando nenhuma destas for indicada. O comprimento mínimo da palavra-passe é de 8 carateres.

Referência de opções

Opções de send

OpçãoDescriçãoPredefinição
-p, --password PPalavra-passe de encriptaçãointerativo
--password-stdinLer a palavra-passe de stdin
--password-file FLer a palavra-passe de um ficheiro
-t, --ttl DURTempo de vida7d
-b, --burnEliminar após leitura (uma única transferência)desativado
-u, --uploader-onlySó a sua conta o pode transferir: a página da sua conta ou qualquer uma das chaves de API dela (Orbit; alias --private)desativado
--timeout DURTempo limite da transferêncianenhum
--server URLURL do servidorhttps://ttl.space
-h3, --http3Experimentar HTTP/3 (QUIC), recorrendo a TCP se falhardesativado
--jsonSaída JSON para stdout (para scripts e agentes de IA)desativado

Opções de get

OpçãoDescriçãoPredefinição
-p, --password PPalavra-passe de desencriptaçãointerativo
--password-stdinLer a palavra-passe de stdin
--password-file FLer a palavra-passe de um ficheiro
-o, --output DIRPasta de destinopasta atual
--timeout DURTempo limite da transferêncianenhum
--server URLServidor para um token isoladohttps://ttl.space
-h3, --http3Experimentar HTTP/3 (QUIC), recorrendo a TCP se falhardesativado
--jsonSaída JSON para stdout (para scripts e agentes de IA)desativado

Valores de TTL

Gratuito: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d

O Orbit acrescenta: 14d 15d 28d 30d permanent

Tempo limite

Predefinição: nenhum. Uma transferência parada retoma por si e desiste se não puder continuar. Defina um limite com --timeout 30m ou --timeout 2h.

Exemplos

Script: cópia de segurança e carregamento

#!/bin/bash
tar czf /tmp/backup.tar.gz /data
echo "$BACKUP_KEY" | ttl send --password-stdin -t 6h /tmp/backup.tar.gz
rm /tmp/backup.tar.gz

Enviar o link para a área de transferência (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Enviar o link para a área de transferência (Linux)

$ ttl send -p mypass123 file.pdf | xclip -sel clip

Eliminar após leitura: segredo de utilização única

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# o link funciona exatamente uma vez e expira em 5 minutos

Modo JSON (scripts & agentes de IA)

# send: palavra-passe gerada automaticamente no modo JSON
$ ttl --json send report.pdf
{"ok":true,"link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"ttl":"7d","expires_in":604800,"expires_at":1760011200,"burn":false,"uploader_only":false,"is_permanent":false,"manage_key":"k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz","password":"aB3kL9mXq7Rt"}

# transferir (get)
$ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA
{"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"}

# estado com a chave de gestão
$ ttl --json status xK9mQ2vLpA -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
{"ok":true,"token":"xK9mQ2vLpA","status":{"state":"active","size_bytes":2097152,"created_at":1759406400,"expires_at":1760011200,"permanent":false,"burn":false,"note":false,"uploader_only":false,"downloads":1,"last_download_at":1759492800,"part_reads":0,"last_part_at":0}}

# os erros devolvem ok:false
{"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}

No modo --json, toda a saída é JSON estruturado em stdout. Se não for indicada nenhuma palavra-passe durante o envio, é gerada uma automaticamente e incluída na resposta. O código de saída é 0 em caso de sucesso e 1 em caso de erro.

Plano Orbit

O Orbit desbloqueia ficheiros maiores (50 GB), retenção mais longa (30 dias, ou permanente com a subscrição), ficheiros exclusivos da sua conta (só a sua conta os pode transferir) e gestão de ficheiros (listar & eliminar). Comparação completa: Funcionalidades.

A chave de API é detetada automaticamente a partir da variável de ambiente TTL_API_KEY, de ttl.key junto ao binário ou de ~/.ttl/key. Utilize ttl activate para guardar a chave ou escreva-a manualmente num destes locais.

# ativar a chave: pedida sem eco, para não ficar no histórico da shell
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# não interativo: ttl activate --key-stdin  |  ttl activate --key-file F

# ver o plano e a utilização
$ ttl plan
Plan: orbit
Max file size: 50.0 GB
Max TTL: 30 days (or permanent)
Uploads per day: 1000000
Storage quota: 1024.0 GB

Usage:
  Uploads today: 3
  Active storage: 1.2 GB / 1024.0 GB

# enviar com TTL alargado
$ ttl send -t 30d large-backup.tar.gz
# ficheiro permanente (só Orbit): sem expiração, mantido até o eliminar ou a subscrição terminar
$ ttl send -t permanent archive.tar.gz
# enviar um ficheiro privado: só a sua conta o pode transferir (só Orbit)
$ ttl send -u payroll.xlsx

# listar os carregamentos recentes
$ ttl list
  xK9mQ2vLpA    4.2 MB  2026-03-16 10:30 → 2026-04-15 10:30  [active]
  https://ttlspaceusercontent.com/xK9mQ2vLpA
  rT7bNw3KpF  912.0 KB  2026-03-15 14:20 → 2026-03-17 14:20  [active (burn)]
  https://ttlspaceusercontent.com/rT7bNw3KpF

# eliminar um ficheiro mais cedo (ttl list percorre todas as páginas; -n 5 para ao fim de cinco ficheiros)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# ou com a chave de gestão do carregamento, em qualquer plano: ttl delete xK9mQ2vLpA -k KEY

# remover a chave guardada
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

API HTTP

Carregar e transferir exigem o pipeline de encriptação da CLI (Argon2id + XChaCha20-Poly1305 + AEAD em blocos). Utilize ttl send / ttl get ou o modo --json para automatizar. Os endpoints abaixo servem para a gestão de ficheiros do Orbit.

Listar ficheiros (Orbit)

$ curl https://ttl.space/v1/files -H "X-API-Key: ttl_orbit_..."
{"files":[{"token":"xK9mQ2vLpA","link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","size_bytes":1048576,"created_at":1711800600,"expires_at":1714392600,"burn":false,"expired":false,"uploader_only":false,"is_permanent":false,"is_note":false,"perm_grace_until":0}],"has_more":false}

# página seguinte: só quando has_more é true; passe next_cursor da resposta anterior
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Devolve os ficheiros carregados com esta chave, os mais recentes primeiro, 20 por página. Quando has_more é true, a resposta inclui também next_cursor; passe-o como ?cursor= para obter a página seguinte. Requer o plano Orbit.

Eliminar ficheiro (Orbit)

$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."

Devolve 204 No Content em caso de sucesso. Requer o plano Orbit. O ficheiro tem de pertencer à chave indicada.

Respostas de erro

EstadoSignificado
401Chave de API inválida ou expirada
403A funcionalidade requer o plano Orbit
404Ficheiro não encontrado ou não pertence a esta chave
429Limite de pedidos excedido
500Erro interno do servidor, tente novamente mais tarde
502Armazenamento temporariamente indisponível, tente novamente mais tarde

Limites

RestriçãoGratuitoOrbit
Tamanho máximo do ficheiro6 GB50 GB
TTL máximo7 dias30 dias ou permanente
Carregamentos por dia4Ilimitados
Volume de carregamento por dia (por IP)6 GBIlimitado
Carregamentos em simultâneo2 por IP4 por chave de API
Quota de armazenamento✗1 TB
Listagem de ficheiros✗✓
Eliminação antecipada✓✓
Ficheiros privados✗✓
Comprimento mínimo da palavra-passe8 carateres
Pedidos por IP300 por 10 segundos
Ligações por IP100 em simultâneo

Encriptação

Os ficheiros são encriptados no seu dispositivo antes de serem carregados. O servidor guarda apenas texto cifrado e não consegue desencriptar os seus ficheiros.

ComponenteAlgoritmo / Valor
Derivação de chaveArgon2id (time=3, memory=64 MiB, parallelism=1)
CifraXChaCha20-Poly1305 AEAD

Qualquer alteração ao texto cifrado faz a desencriptação falhar. O servidor verifica que quem transfere conhece a palavra-passe correta antes de entregar o texto cifrado, através de um token unidirecional derivado da chave de encriptação.