Guide d’utilisation

Prise en main rapide

# envoyer un fichier : mot de passe généré automatiquement, affiche le lien et le mot de 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)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mXq7Rt
https://ttl.space/aBcDeFgHiJ

# télécharger : demande le mot de passe de manière interactive
$ ttl get https://ttl.space/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

Le CLI gère le chiffrement, l’envoi, le téléchargement et le déchiffrement. Le serveur ne voit jamais votre mot de passe ni vos données en clair.

Installation

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Binaire précompilé

# télécharger pour votre plateforme depuis les releases
$ curl -Lo ttl.tar.gz \
  https://github.com/tweenietomatoes/ttl/releases/download/v1.6.0/ttl_1.6.0_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

Depuis les sources

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

Vérification

$ ttl version
ttl 1.6.0

Envoyer des fichiers

Envoi simple

# mot de passe généré automatiquement, TTL par défaut 7 j
$ ttl send report.xlsx

Lorsqu’aucun mot de passe n’est fourni dans un terminal, le CLI demande :

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

Appuyez sur Entrée ou tapez y pour générer automatiquement.

Mot de passe personnalisé

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

Détruire après lecture

# invalidé dès que le premier téléchargement commence, et après une coupure seul ce téléchargement peut reprendre
$ ttl send -b photo.jpg

TTL personnalisé

$ ttl send -t 5m temp-credentials.txt   # expire dans 5 minutes
$ ttl send -t 30m meeting-link.txt      # expire dans 30 minutes
$ ttl send -t 6h backup.tar.gz          # expire dans 6 heures
$ ttl send -t 1d daily-report.pdf       # expire dans 1 jour
$ ttl send -t 3d project-archive.zip    # expire dans 3 jours
$ ttl send -t 5d design-assets.zip      # expire dans 5 jours
$ ttl send report.xlsx                  # expire dans 7 jours (défaut)

Télécharger des fichiers

Mode interactif (terminal)

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

Le mot de passe est lu de manière sécurisée, il n’est pas affiché dans le terminal. Le nom de fichier original est préservé ; si un fichier portant ce nom existe déjà dans le répertoire de sortie, le fichier est enregistré sous name (1).ext au lieu de l’écraser.

Jeton seul

# vous pouvez utiliser uniquement le jeton de 10 caractères au lieu de l'URL complète
$ ttl get aBcDeFgHiJ

Répertoire de sortie

$ ttl get -o ~/Downloads aBcDeFgHiJ

Par défaut, les fichiers sont enregistrés dans le répertoire courant. Utilisez -o / --output pour spécifier un autre répertoire.

Avec l’option de mot de passe

$ ttl get -p mySecretPass https://ttl.space/aBcDeFgHiJ

Navigateur

Vous pouvez aussi télécharger et déchiffrer des fichiers dans votre navigateur en visitant le lien directement. L’interface web utilise le même format de fichier et les mêmes algorithmes (Argon2id, XChaCha20-Poly1305) et demande votre mot de passe. Aucune installation requise.

Gestion du mot de passe

Le mot de passe est la graine de la clé de chiffrement. Il ne quitte jamais votre appareil et n’est jamais envoyé au serveur. Il existe six manières de le fournir :

1. Génération automatique (envoi uniquement)

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

Génère un mot de passe aléatoire cryptographiquement sûr de 12 caractères à partir de [0-9A-Za-z]. Disponible uniquement lors de l’envoi (send), de manière interactive ou automatiquement en mode --json.

2. Saisie interactive

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

$ ttl get https://ttl.space/aBcDeFgHiJ
Enter password: ********

Le mot de passe n’est ni affiché ni enregistré dans l’historique du shell. Lors de l’envoi (send), vous choisissez d’abord si le mot de passe doit être généré automatiquement. Lors du téléchargement (get), la saisie est directe.

3. Option : -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttl.space/aBcDeFgHiJ

4. Stdin : --password-stdin

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

# via un gestionnaire de mots de passe
$ pass show ttl/key | ttl send --password-stdin data.zip

# via une variable d'environnement
$ printenv MY_SECRET | ttl get --password-stdin https://ttl.space/aBcDeFgHiJ

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

Lit la première ligne depuis stdin. Utile dans les scripts, les pipelines CI/CD et l’automatisation. Lorsque stdin n’est pas un terminal et qu’aucune source de mot de passe n’est fournie, le CLI s’arrête avec une erreur (sauf avec --json, qui génère automatiquement un mot de passe).

5. Fichier : --password-file

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

Lit la première ligne du fichier (le retour à la ligne final est supprimé). Compatible avec les secrets Docker (/run/secrets/), les fichiers d’agent Vault, et autres mécanismes similaires.

6. Fichier détecté automatiquement : ttl.password

Si aucun mot de passe explicite n’est fourni, le CLI recherche un fichier ttl.password à côté du binaire, puis ~/.ttl/password. La première ligne est utilisée comme mot de passe.

Référence des options

Options d’envoi

Options de téléchargement

Valeurs de TTL

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

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

Délai d’attente

Par défaut : sans limite. Un transfert qui se bloque reprend tout seul et s’arrête s’il ne peut plus avancer. Pour fixer une limite : --timeout 30m ou --timeout 2h.

Exemples

Script : sauvegarde et envoi

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

Copier le lien dans le presse-papiers (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Copier le lien dans le presse-papiers (Linux)

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

Destruction : secret à usage unique

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# le lien fonctionne une seule fois, expire dans 5 minutes

Mode JSON (scripts & agents IA)

# envoi : mot de passe généré automatiquement en mode JSON
$ ttl --json send report.pdf
{"ok":true,"link":"https://ttl.space/xK9mQ2vLpA","filename":"report.pdf","size":2097152,"ttl":"7d","burn":false,"uploader_only":false,"is_permanent":false,"password":"aB3kL9mXq7Rt"}

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

# les erreurs retournent ok:false
{"ok":false,"error":"Link not found"}

En mode --json, toute la sortie est du JSON structuré sur stdout. Si aucun mot de passe n’est fourni lors de l’envoi, un mot de passe est généré automatiquement et inclus dans la réponse. Le code de sortie est 0 en cas de succès, 1 en cas d’erreur.

Plan Orbit

Orbit débloque des fichiers plus volumineux (10 Go), une durée de conservation plus longue (30 jours, ou permanente), des fichiers réservés à l’expéditeur (seule votre clé API peut les télécharger) et la gestion des fichiers (liste et suppression). Comparaison complète : Features.

La clé API est détectée automatiquement : variable d’environnement TTL_API_KEY, ttl.key à côté du binaire ou ~/.ttl/key. Utilisez ttl activate pour enregistrer la clé ou écrivez-la manuellement à l’un de ces emplacements.

# activer votre clé : saisie masquée, elle ne figure donc pas dans l'historique du shell
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# non interactif : ttl activate --key-stdin  |  ttl activate --key-file F

# vérifier l'offre et l'utilisation
$ ttl plan
Plan: orbit
Max file size: 10.0 GB
Max TTL: 30 days (or permanent)
Uploads per day: 1000000

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

# envoyer avec TTL étendu
$ ttl send -t 30d large-backup.tar.gz
# fichier permanent (Orbit uniquement) : sans expiration, conservé jusqu'à ce que vous le supprimiez ou que votre abonnement prenne fin
$ ttl send -t permanent archive.tar.gz
# envoyer un fichier privé : seule votre clé API peut le télécharger (Orbit uniquement)
$ ttl send -u payroll.xlsx

# lister les envois récents
$ ttl list
  xK9mQ2vLpA    4.2 MB  2026-03-16 10:30 → 2026-04-15 10:30  [active]
  https://ttl.space/xK9mQ2vLpA
  rT7bNw3KpF  912.0 KB  2026-03-15 14:20 → 2026-03-17 14:20  [active (burn)]
  https://ttl.space/rT7bNw3KpF

# supprimer un fichier
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA

# retirer la clé enregistrée
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Lister les fichiers (Orbit)

$ curl https://ttl.space/v1/files -H "X-API-Key: ttl_orbit_..."
{"files":[{"token":"xK9mQ2vLpA","link":"https://ttl.space/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}

# page suivante : uniquement quand has_more vaut true ; transmettez le next_cursor de la réponse précédente
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Renvoie les fichiers envoyés avec cette clé, du plus récent au plus ancien, 20 par page. Lorsque has_more vaut true, la réponse inclut aussi next_cursor ; transmettez-le via ?cursor= pour obtenir la page suivante. Nécessite l’offre Orbit.

Supprimer un fichier (Orbit)

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

Renvoie 204 No Content en cas de succès. Nécessite l’offre Orbit. Le fichier doit appartenir à cette clé.

Réponses d’erreur

Limites

Chiffrement

Les fichiers sont chiffrés sur votre appareil avant l’envoi. Le serveur ne stocke que le texte chiffré et ne peut pas déchiffrer vos fichiers.

Toute modification du texte chiffré provoque un échec du déchiffrement. Le serveur vérifie que la personne qui télécharge connaît le bon mot de passe avant de lui transmettre le texte chiffré, en utilisant un jeton unidirectionnel dérivé de la clé de chiffrement.