Guía de uso

Español (Argentina)

Inicio rápido

# enviar un archivo: contraseña generada automáticamente, imprime el enlace y la contraseña
$ 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

# descargar: pide la contraseña de forma interactiva
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

La CLI se encarga del cifrado, la subida, la descarga y el descifrado. El servidor nunca ve tu contraseña ni los datos sin cifrar.

Instalación

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Binario precompilado

# descargá la versión para tu plataforma desde 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/

Go install

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

Desde el código fuente

$ 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

Envío de archivos

Envío básico

# contraseña generada automáticamente, TTL predeterminado de 7d
$ ttl send report.xlsx

Cuando en una terminal no se indica una contraseña, la CLI pregunta:

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

Presioná Enter o escribí y para generarla automáticamente.

Contraseña propia

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

Eliminar después de leer

# se elimina al descargarse; una descarga que se corta puede reanudarse y no lo consume
$ ttl send -b photo.jpg

TTL personalizado

$ ttl send -t 5m temp-credentials.txt   # vence en 5 minutos
$ ttl send -t 30m meeting-link.txt      # vence en 30 minutos
$ ttl send -t 6h backup.tar.gz          # vence en 6 horas
$ ttl send -t 1d daily-report.pdf       # vence en 1 día
$ ttl send -t 3d project-archive.zip    # vence en 3 días
$ ttl send -t 5d design-assets.zip      # vence en 5 días
$ ttl send report.xlsx                  # vence en 7 días (predeterminado)

Archivos grandes

Un archivo de hasta 16 MiB se envía en una sola solicitud; uno más grande, en partes reanudables de 16 MiB, de a dos por vez. Cada solicitud se verifica con un resumen SHA-256, y la que falla en el camino se vuelve a enviar; las partes ya enviadas se conservan. Ctrl-C cancela de forma limpia.

Descarga de archivos

Interactivo (terminal)

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

La contraseña no se muestra en la terminal. Se conserva el nombre original del archivo; si ese nombre ya existe en el directorio de salida, el archivo se guarda como name (1).ext en lugar de sobrescribirlo.

Solo con el token

# podés usar solo el token de 10 caracteres en lugar de la URL completa
$ ttl get aBcDeFgHiJ

Directorio de salida

$ ttl get -o ~/Downloads aBcDeFgHiJ

De forma predeterminada, los archivos se guardan en el directorio actual. Usá -o / --output para indicar otro directorio.

Con la opción de contraseña

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

Descargas interrumpidas

Una descarga que se corta se reanuda desde el último byte recibido; cada bloque de 64 KiB se autentica por separado, así que el resultado es idéntico al de una transferencia sin cortes. Un archivo de un solo uso (eliminar después de leer) se consume cuando una descarga lo obtuvo completo: una que se corta retoma desde donde quedó, y el archivo se conserva para otro intento.

Navegador

También podés descargar y descifrar archivos en tu navegador entrando directamente al enlace. La interfaz web usa el mismo formato de archivo y los mismos algoritmos (Argon2id, XChaCha20-Poly1305) y te pide la contraseña. No hace falta instalar ningún software.

Clave de gestión

Cada subida viene con una clave de gestión, que ttl send imprime una sola vez (manage_key en --json). El servidor guarda solo su hash. En cualquier plan te permite seguir la subida o terminarla antes de tiempo; quien tenga la clave puede eliminar la subida, así que cuidala como cuidás la contraseña.

# estado, descargas y vencimiento de tu propia subida
$ 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)

# eliminarla antes de tiempo
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

El estado es uno de estos: active, expired, burned o deleted.

Manejo de la contraseña

La contraseña es la semilla de la clave de cifrado. Nunca sale de tu dispositivo y nunca se envía al servidor. Hay seis maneras de indicarla:

1. Generación automática (solo al enviar)

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

Genera una contraseña aleatoria criptográficamente segura de 12 caracteres tomados de [0-9A-Za-z]. Solo está disponible al usar send (de forma interactiva, o automáticamente en el modo --json).

2. Pregunta interactiva

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

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

La contraseña no se muestra mientras la escribís. Con send, elegís si querés generarla automáticamente; si escribís la tuya, tenés que confirmarla. Con get, te la pide directamente.

3. Opción: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password se ve en la salida de ps aux y puede quedar guardada en el historial del shell (~/.bash_history). Evitala en entornos compartidos y en scripts. Usá --password-stdin o --password-file en su lugar.

4. Entrada estándar: --password-stdin

# canalizar desde echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# canalizar desde un gestor de contraseñas
$ pass show ttl/key | ttl send --password-stdin data.zip

# canalizar desde una variable de entorno
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

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

Lee la primera línea de la entrada estándar. Sirve para scripts, pipelines de CI/CD y automatización. Cuando la entrada estándar no es una terminal y no se indica ninguna fuente de contraseña, la CLI termina con un error (salvo que se use --json, que genera una contraseña automáticamente).

5. Archivo: --password-file

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

Lee la primera línea del archivo (sin el salto de línea final). Es compatible con Docker secrets (/run/secrets/), con los archivos del agente de Vault y con esquemas similares.

6. Archivo detectado automáticamente: ttl.password

Si no se indica una contraseña de forma explícita, la CLI busca un archivo ttl.password junto al binario y después ~/.ttl/password. La primera línea se usa como contraseña.

Solo se puede usar una fuente explícita de contraseña a la vez. Combinar -p / --password, --password-stdin y --password-file es un error. El archivo ttl.password detectado automáticamente solo se revisa cuando no se indicó ninguna de ellas. La longitud mínima de la contraseña es de 8 caracteres.

Referencia de opciones

Opciones de envío

OpciónDescripciónPredeterminado
-p, --password PContraseña de cifradointeractivo
--password-stdinLeer la contraseña desde la entrada estándar
--password-file FLeer la contraseña desde un archivo
-t, --ttl DURTiempo de vida7d
-b, --burnEliminar después de leer (una sola descarga)desactivado
-u, --uploader-onlySolo tu cuenta puede descargarlo: la página de tu cuenta o cualquiera de sus claves de API (Orbit; alias --private)desactivado
--timeout DURTiempo límite de la transferencianinguno
--server URLURL del servidorhttps://ttl.space
-h3, --http3Probar HTTP/3 (QUIC) y volver a TCP si falladesactivado
--jsonImprimir JSON en la salida estándar (para scripts y agentes de IA)desactivado

Opciones de descarga

OpciónDescripciónPredeterminado
-p, --password PContraseña de descifradointeractivo
--password-stdinLeer la contraseña desde la entrada estándar
--password-file FLeer la contraseña desde un archivo
-o, --output DIRDirectorio de salidadirectorio actual
--timeout DURTiempo límite de la transferencianinguno
--server URLServidor para un token sueltohttps://ttl.space
-h3, --http3Probar HTTP/3 (QUIC) y volver a TCP si falladesactivado
--jsonImprimir JSON en la salida estándar (para scripts y agentes de IA)desactivado

Valores de TTL

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

Orbit suma: 14d 15d 28d 30d permanent

Tiempo límite

Predeterminado: ninguno. Una transferencia detenida se reanuda sola, y se rinde si no puede continuar. Podés fijar un límite con --timeout 30m o --timeout 2h.

Ejemplos

Script: copia de seguridad y subida

#!/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

Canalizar el enlace al portapapeles (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Canalizar el enlace al portapapeles (Linux)

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

Eliminar después de leer: secreto de un solo uso

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# el enlace funciona una sola vez y vence en 5 minutos

Modo JSON (scripts y agentes de IA)

# enviar: la contraseña se genera automáticamente en 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"}

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

# estado con la clave de gestión
$ 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}}

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

En el modo --json, toda la salida es JSON estructurado por la salida estándar. Si al enviar no se indica una contraseña, se genera una automáticamente y se incluye en la respuesta. El código de salida es 0 si salió bien y 1 si hubo un error.

Plan Orbit

Orbit habilita archivos más grandes (50 GB), mayor tiempo de conservación (30 días, o permanente con la suscripción), archivos reservados a tu cuenta (solo tu cuenta puede descargarlos) y administración de archivos (listar y eliminar). Comparación completa: Funciones.

La clave de API se detecta automáticamente desde la variable de entorno TTL_API_KEY, desde ttl.key junto al binario o desde ~/.ttl/key. Usá ttl activate para guardar la clave, o escribila a mano en cualquiera de esos lugares.

# activá tu clave: se pide sin mostrarla, así no queda en el historial del shell
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# no interactivo: ttl activate --key-stdin  |  ttl activate --key-file F

# ver el plan y el uso
$ 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 con un TTL extendido
$ ttl send -t 30d large-backup.tar.gz
# archivo permanente (solo Orbit): no vence, se conserva hasta que lo elimines o termine tu suscripción
$ ttl send -t permanent archive.tar.gz
# enviar un archivo privado: solo tu cuenta puede descargarlo (solo Orbit)
$ ttl send -u payroll.xlsx

# listar las subidas recientes
$ 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 un archivo antes de tiempo (ttl list recorre todas las páginas; -n 5 se detiene después de cinco archivos)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# o con la clave de gestión de la subida, en cualquier plan: ttl delete xK9mQ2vLpA -k KEY

# quitar la clave guardada
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

API HTTP

Subir y descargar requieren el proceso de cifrado de la CLI (Argon2id + XChaCha20-Poly1305 + AEAD por bloques). Para automatizar, usá ttl send / ttl get o el modo --json. Los endpoints de abajo son para la administración de archivos de Orbit.

Listar archivos (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 siguiente: solo cuando has_more es true; pasá next_cursor de la respuesta anterior
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Devuelve los archivos subidos con esta clave, los más nuevos primero, 20 por página. Cuando has_more es true, la respuesta también incluye next_cursor; pasalo como ?cursor= para obtener la página siguiente. Requiere el plan Orbit.

Eliminar un archivo (Orbit)

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

Devuelve 204 No Content si salió bien. Requiere el plan Orbit. El archivo tiene que pertenecer a la clave indicada.

Respuestas de error

EstadoSignificado
401Clave de API inválida o vencida
403La función requiere el plan Orbit
404Archivo no encontrado o no pertenece a esta clave
429Se superó el límite de solicitudes
500Error interno del servidor, intentá más tarde
502Almacenamiento no disponible por el momento, intentá más tarde

Límites

RestricciónGratisOrbit
Tamaño máx. de archivo6 GB50 GB
TTL máx.7 días30 días o permanente
Subidas por día4Ilimitadas
Volumen de subida por día (por IP)6 GBIlimitado
Subidas simultáneas2 por IP4 por clave de API
Cuota de almacenamiento✗1 TB
Listado de archivos✗✓
Eliminación anticipada✓✓
Archivos que solo descarga quien los subió✗✓
Longitud mínima de la contraseña8 caracteres
Solicitudes por IP300 cada 10 segundos
Conexiones por IP100 simultáneas

Cifrado

Los archivos se cifran en tu dispositivo antes de subirse. El servidor guarda solo texto cifrado y no puede descifrar tus archivos.

ComponenteAlgoritmo / Valor
Derivación de claveArgon2id (time=3, memory=64 MiB, parallelism=1)
Algoritmo de cifradoXChaCha20-Poly1305 AEAD

Cualquier modificación del texto cifrado hace que el descifrado falle. El servidor verifica que quien descarga conozca la contraseña correcta antes de entregar el texto cifrado, usando un token unidireccional derivado de la clave de cifrado.