Návod na použitie

Slovenčina

Rýchly štart

# odoslanie súboru: heslo sa vygeneruje automaticky, vypíše sa odkaz + heslo
$ 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

# stiahnutie: vypýta si heslo interaktívne
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

CLI zabezpečuje šifrovanie, nahrávanie, sťahovanie a dešifrovanie. Server nikdy nevidí vaše heslo ani nezašifrované údaje.

Inštalácia

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Hotový binárny súbor

# stiahnite verziu pre svoju platformu zo stránky 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/

Inštalácia cez Go

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

Zo zdrojového kódu

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

Overenie

$ ttl version
ttl 1.6.2

Odosielanie súborov

Základné odoslanie

# automaticky vygenerované heslo, predvolené TTL 7d
$ ttl send report.xlsx

Ak v termináli nezadáte heslo, CLI sa opýta:

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

Stlačte Enter alebo napíšte y a heslo sa vygeneruje automaticky.

Vlastné heslo

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

Odstrániť po prečítaní

# odstráni sa po stiahnutí; prerušené sťahovanie môže pokračovať a súbor sa tým nespotrebuje
$ ttl send -b photo.jpg

Vlastné TTL

$ ttl send -t 5m temp-credentials.txt   # vyprší o 5 minút
$ ttl send -t 30m meeting-link.txt      # vyprší o 30 minút
$ ttl send -t 6h backup.tar.gz          # vyprší o 6 hodín
$ ttl send -t 1d daily-report.pdf       # vyprší o 1 deň
$ ttl send -t 3d project-archive.zip    # vyprší o 3 dni
$ ttl send -t 5d design-assets.zip      # vyprší o 5 dní
$ ttl send report.xlsx                  # vyprší o 7 dní (predvolené)

Veľké súbory

Súbor do 16 MiB sa odošle jednou požiadavkou; väčší sa posiela po častiach s veľkosťou 16 MiB, pri ktorých možno pokračovať po prerušení, po dve naraz. Každá požiadavka sa overuje hashom SHA-256 a požiadavka, ktorá cestou zlyhá, sa odošle znova; už odoslané časti zostanú. Ctrl-C zruší prenos čisto.

Sťahovanie súborov

Interaktívne (terminál)

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

Heslo sa v termináli nezobrazuje. Pôvodný názov súboru sa zachová; ak taký názov vo výstupnom adresári už existuje, súbor sa uloží ako name (1).ext namiesto prepísania.

Len s tokenom

# namiesto celej adresy URL môžete použiť iba 10-znakový token
$ ttl get aBcDeFgHiJ

Výstupný adresár

$ ttl get -o ~/Downloads aBcDeFgHiJ

Predvolene sa súbory ukladajú do aktuálneho adresára. Iný adresár určíte pomocou -o / --output.

S prepínačom hesla

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

Prerušené sťahovania

Prerušené sťahovanie pokračuje od posledného prijatého bajtu; každý blok s veľkosťou 64 KiB sa overuje samostatne, takže výsledok je rovnaký ako pri neprerušenom prenose. Jednorazový súbor (odstránenie po prečítaní) sa spotrebuje, keď sa celý stiahne: prerušené sťahovanie pokračuje tam, kde sa zastavilo, a súbor zostane na ďalší pokus.

Prehliadač

Súbory môžete stiahnuť a dešifrovať aj v prehliadači, ak priamo otvoríte odkaz. Webové rozhranie používa rovnaký formát súborov a rovnaké algoritmy (Argon2id, XChaCha20-Poly1305) a vypýta si vaše heslo. Nie je potrebná inštalácia žiadneho softvéru.

Kľúč na správu

Každé nahrávanie má kľúč na správu, ktorý ttl send vypíše iba raz (manage_key v --json). Server uchováva len jeho hash. V ktoromkoľvek pláne vám umožňuje sledovať nahrávanie alebo ho predčasne ukončiť; každý, kto kľúč má, môže nahrávanie odstrániť, preto ho chráňte ako heslo.

# stav, sťahovania a platnosť vášho nahrávania
$ 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)

# predčasné odstránenie
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Stav je jeden z active, expired, burned alebo deleted.

Práca s heslom

Heslo je základ šifrovacieho kľúča. Nikdy neopustí vaše zariadenie a nikdy sa neodosiela na server. Zadať ho možno šiestimi spôsobmi:

1. Automatické vygenerovanie (len pri odosielaní)

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

Vygeneruje kryptograficky náhodné 12-znakové heslo zo znakov [0-9A-Za-z]. Dostupné iba pri send (interaktívne alebo automaticky v režime --json).

2. Interaktívna výzva

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

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

Heslo sa nezobrazuje. Pri send si vyberiete, či sa vygeneruje automaticky; ak zadáte vlastné, potvrdíte ho. Pri get sa program opýta priamo.

3. Prepínač: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password je viditeľné vo výstupe ps aux a môže sa uložiť do histórie shellu (~/.bash_history). Vyhnite sa mu v zdieľaných prostrediach a skriptoch. Použite namiesto neho --password-stdin alebo --password-file.

4. Štandardný vstup: --password-stdin

# cez rúru z echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# cez rúru zo správcu hesiel
$ pass show ttl/key | ttl send --password-stdin data.zip

# cez rúru z premennej prostredia
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

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

Prečíta prvý riadok zo štandardného vstupu (stdin). Užitočné v skriptoch, CI/CD pipeline a automatizácii. Ak stdin nie je terminál a nie je zadaný žiadny zdroj hesla, CLI skončí s chybou (okrem prípadu, keď sa použije --json, ktoré heslo vygeneruje automaticky).

5. Súbor: --password-file

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

Prečíta prvý riadok súboru (koncový znak nového riadka sa odstráni). Kompatibilné so súbormi Docker secrets (/run/secrets/), súbormi agenta Vault a podobnými postupmi.

6. Automaticky zistený súbor: ttl.password

Ak nie je zadané žiadne explicitné heslo, CLI hľadá súbor ttl.password vedľa binárneho súboru a potom ~/.ttl/password. Ako heslo sa použije prvý riadok.

Naraz možno použiť iba jeden explicitný zdroj hesla. Kombinácia -p / --password, --password-stdin a --password-file je chyba. Automaticky zistený súbor ttl.password sa kontroluje, iba ak nie je zadaný žiadny z nich. Minimálna dĺžka hesla je 8 znakov.

Prehľad možností

Prepínače príkazu send

PrepínačPopisPredvolené
-p, --password PŠifrovacie heslointeraktívne
--password-stdinNačítať heslo zo stdin
--password-file FNačítať heslo zo súboru
-t, --ttl DURDoba platnosti (TTL)7d
-b, --burnOdstrániť po prečítaní (jedno stiahnutie)vypnuté
-u, --uploader-onlyStiahnuť ho môže iba váš účet: stránka vášho účtu alebo ktorýkoľvek z jeho API kľúčov (Orbit; alias --private)vypnuté
--timeout DURČasový limit prenosužiadny
--server URLAdresa URL serverahttps://ttl.space
-h3, --http3Skúsiť HTTP/3 (QUIC), pri zlyhaní prejsť na TCPvypnuté
--jsonVypísať JSON na stdout (pre skripty a AI agentov)vypnuté

Prepínače príkazu get

PrepínačPopisPredvolené
-p, --password PHeslo na dešifrovanieinteraktívne
--password-stdinNačítať heslo zo stdin
--password-file FNačítať heslo zo súboru
-o, --output DIRVýstupný adresáraktuálny adresár
--timeout DURČasový limit prenosužiadny
--server URLServer pre samotný tokenhttps://ttl.space
-h3, --http3Skúsiť HTTP/3 (QUIC), pri zlyhaní prejsť na TCPvypnuté
--jsonVypísať JSON na stdout (pre skripty a AI agentov)vypnuté

Hodnoty TTL

Bezplatný plán: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d

Orbit pridáva: 14d 15d 28d 30d permanent

Časový limit

Predvolene: žiadny. Zastavený prenos sa obnoví sám a vzdá sa, ak nemôže pokračovať. Limit nastavíte pomocou --timeout 30m alebo --timeout 2h.

Príklady

Skript: záloha a nahranie

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

Odkaz do schránky (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Odkaz do schránky (Linux)

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

Odstrániť po prečítaní: jednorazové tajomstvo

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# odkaz funguje presne raz, vyprší o 5 minút

Režim JSON (skripty a AI agenti)

# odoslanie: v režime JSON sa heslo vygeneruje automaticky
$ 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"}

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

# stav pomocou kľúča na správu
$ 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}}

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

V režime --json je všetok výstup štruktúrovaný JSON na stdout. Ak sa pri odosielaní nezadá heslo, vygeneruje sa automaticky a zahrnie sa do odpovede. Návratový kód je 0 pri úspechu a 1 pri chybe.

Plán Orbit

Orbit odomyká väčšie súbory (50 GB), dlhšie uchovávanie (30 dní, s predplatným aj natrvalo), súbory viazané na váš účet (stiahnuť ich môže iba váš účet) a správu súborov (zoznam a odstraňovanie). Úplné porovnanie: Funkcie.

API kľúč sa automaticky zistí z premennej prostredia TTL_API_KEY, zo súboru ttl.key vedľa binárneho súboru alebo z ~/.ttl/key. Kľúč uložíte pomocou ttl activate alebo ho zapíšete ručne do ktoréhokoľvek z týchto umiestnení.

# aktivácia kľúča: zadáva sa bez zobrazenia, takže sa nedostane do histórie shellu
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# neinteraktívne: ttl activate --key-stdin  |  ttl activate --key-file F

# kontrola plánu a využitia
$ 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

# odoslanie s predĺženým TTL
$ ttl send -t 30d large-backup.tar.gz
# trvalý súbor (len Orbit): bez vypršania, uchováva sa, kým ho neodstránite alebo neskončí predplatné
$ ttl send -t permanent archive.tar.gz
# odoslanie súkromného súboru: stiahnuť ho môže iba váš účet (len Orbit)
$ ttl send -u payroll.xlsx

# zoznam posledných nahrávaní
$ 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

# predčasné odstránenie súboru (ttl list prechádza všetky stránky; -n 5 sa zastaví po piatich súboroch)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# alebo pomocou kľúča na správu nahrávania, v ktoromkoľvek pláne: ttl delete xK9mQ2vLpA -k KEY

# odstránenie uloženého kľúča
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Nahrávanie a sťahovanie vyžadujú šifrovací postup CLI (Argon2id + XChaCha20-Poly1305 + AEAD po blokoch). Na skriptovanie použite ttl send / ttl get alebo režim --json. Nižšie uvedené koncové body slúžia na správu súborov Orbit.

Zoznam súborov (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}

# ďalšia stránka: iba ak je has_more true; použite next_cursor z predchádzajúcej odpovede
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Vráti súbory nahrané týmto kľúčom, najnovšie ako prvé, 20 na stránku. Keď je has_more true, odpoveď obsahuje aj next_cursor; odovzdajte ho ako ?cursor= a získate ďalšiu stránku. Vyžaduje plán Orbit.

Odstránenie súboru (Orbit)

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

Pri úspechu vráti 204 No Content. Vyžaduje plán Orbit. Súbor musí patriť zadanému kľúču.

Chybové odpovede

StavVýznam
401Neplatný alebo expirovaný API kľúč
403Funkcia vyžaduje plán Orbit
404Súbor sa nenašiel alebo nepatrí tomuto kľúču
429Prekročený limit požiadaviek
500Vnútorná chyba servera, skúste to neskôr
502Úložisko je dočasne nedostupné, skúste to neskôr

Limity

ObmedzenieZadarmoOrbit
Max. veľkosť súboru6 GB50 GB
Max. TTL7 dní30 dní alebo natrvalo
Nahrania za deň4Neobmedzene
Objem nahrávania za deň (na IP)6 GBNeobmedzene
Súbežné nahrávania2 na IP4 na API kľúč
Kvóta úložiska✗1 TB
Zoznam súborov✗✓
Predčasné odstránenie✓✓
Súbory len pre odosielateľa✗✓
Min. dĺžka hesla8 znakov
Požiadavky na IP300 za 10 sekúnd
Pripojenia na IP100 súbežne

Šifrovanie

Súbory sa šifrujú vo vašom zariadení pred nahraním. Server ukladá iba šifrový text a nemôže vaše súbory dešifrovať.

SúčasťAlgoritmus / hodnota
Odvodenie kľúčaArgon2id (time=3, memory=64 MiB, parallelism=1)
ŠifraXChaCha20-Poly1305 AEAD

Akákoľvek úprava šifrového textu spôsobí zlyhanie dešifrovania. Server pred vydaním šifrového textu overí, že sťahujúci pozná správne heslo, pomocou jednosmerného tokenu odvodeného zo šifrovacieho kľúča.