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.
-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ón | Descripción | Predeterminado |
|---|---|---|
-p, --password P | Contraseña de cifrado | interactivo |
--password-stdin | Leer la contraseña desde la entrada estándar | |
--password-file F | Leer la contraseña desde un archivo | |
-t, --ttl DUR | Tiempo de vida | 7d |
-b, --burn | Eliminar después de leer (una sola descarga) | desactivado |
-u, --uploader-only | Solo tu cuenta puede descargarlo: la página de tu cuenta o cualquiera de sus claves de API (Orbit; alias --private) | desactivado |
--timeout DUR | Tiempo límite de la transferencia | ninguno |
--server URL | URL del servidor | https://ttl.space |
-h3, --http3 | Probar HTTP/3 (QUIC) y volver a TCP si falla | desactivado |
--json | Imprimir JSON en la salida estándar (para scripts y agentes de IA) | desactivado |
Opciones de descarga
| Opción | Descripción | Predeterminado |
|---|---|---|
-p, --password P | Contraseña de descifrado | interactivo |
--password-stdin | Leer la contraseña desde la entrada estándar | |
--password-file F | Leer la contraseña desde un archivo | |
-o, --output DIR | Directorio de salida | directorio actual |
--timeout DUR | Tiempo límite de la transferencia | ninguno |
--server URL | Servidor para un token suelto | https://ttl.space |
-h3, --http3 | Probar HTTP/3 (QUIC) y volver a TCP si falla | desactivado |
--json | Imprimir 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
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
| Estado | Significado |
|---|---|
401 | Clave de API inválida o vencida |
403 | La función requiere el plan Orbit |
404 | Archivo no encontrado o no pertenece a esta clave |
429 | Se superó el límite de solicitudes |
500 | Error interno del servidor, intentá más tarde |
502 | Almacenamiento no disponible por el momento, intentá más tarde |
Límites
| Restricción | Gratis | Orbit |
|---|---|---|
| Tamaño máx. de archivo | 6 GB | 50 GB |
| TTL máx. | 7 días | 30 días o permanente |
| Subidas por día | 4 | Ilimitadas |
| Volumen de subida por día (por IP) | 6 GB | Ilimitado |
| Subidas simultáneas | 2 por IP | 4 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ña | 8 caracteres | |
| Solicitudes por IP | 300 cada 10 segundos | |
| Conexiones por IP | 100 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.
| Componente | Algoritmo / Valor |
|---|---|
| Derivación de clave | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Algoritmo de cifrado | XChaCha20-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.