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.
-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ção | Descrição | Predefinição |
|---|---|---|
-p, --password P | Palavra-passe de encriptação | interativo |
--password-stdin | Ler a palavra-passe de stdin | |
--password-file F | Ler a palavra-passe de um ficheiro | |
-t, --ttl DUR | Tempo de vida | 7d |
-b, --burn | Eliminar após leitura (uma única transferência) | desativado |
-u, --uploader-only | Só 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 DUR | Tempo limite da transferência | nenhum |
--server URL | URL do servidor | https://ttl.space |
-h3, --http3 | Experimentar HTTP/3 (QUIC), recorrendo a TCP se falhar | desativado |
--json | Saída JSON para stdout (para scripts e agentes de IA) | desativado |
Opções de get
| Opção | Descrição | Predefinição |
|---|---|---|
-p, --password P | Palavra-passe de desencriptação | interativo |
--password-stdin | Ler a palavra-passe de stdin | |
--password-file F | Ler a palavra-passe de um ficheiro | |
-o, --output DIR | Pasta de destino | pasta atual |
--timeout DUR | Tempo limite da transferência | nenhum |
--server URL | Servidor para um token isolado | https://ttl.space |
-h3, --http3 | Experimentar HTTP/3 (QUIC), recorrendo a TCP se falhar | desativado |
--json | Saí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
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
| Estado | Significado |
|---|---|
401 | Chave de API inválida ou expirada |
403 | A funcionalidade requer o plano Orbit |
404 | Ficheiro não encontrado ou não pertence a esta chave |
429 | Limite de pedidos excedido |
500 | Erro interno do servidor, tente novamente mais tarde |
502 | Armazenamento temporariamente indisponível, tente novamente mais tarde |
Limites
| Restrição | Gratuito | Orbit |
|---|---|---|
| Tamanho máximo do ficheiro | 6 GB | 50 GB |
| TTL máximo | 7 dias | 30 dias ou permanente |
| Carregamentos por dia | 4 | Ilimitados |
| Volume de carregamento por dia (por IP) | 6 GB | Ilimitado |
| Carregamentos em simultâneo | 2 por IP | 4 por chave de API |
| Quota de armazenamento | ✗ | 1 TB |
| Listagem de ficheiros | ✗ | ✓ |
| Eliminação antecipada | ✓ | ✓ |
| Ficheiros privados | ✗ | ✓ |
| Comprimento mínimo da palavra-passe | 8 carateres | |
| Pedidos por IP | 300 por 10 segundos | |
| Ligações por IP | 100 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.
| Componente | Algoritmo / Valor |
|---|---|
| Derivação de chave | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Cifra | XChaCha20-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.