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.
-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č | Popis | Predvolené |
|---|---|---|
-p, --password P | Šifrovacie heslo | interaktívne |
--password-stdin | Načítať heslo zo stdin | |
--password-file F | Načítať heslo zo súboru | |
-t, --ttl DUR | Doba platnosti (TTL) | 7d |
-b, --burn | Odstrániť po prečítaní (jedno stiahnutie) | vypnuté |
-u, --uploader-only | Stiahnuť 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 URL | Adresa URL servera | https://ttl.space |
-h3, --http3 | Skúsiť HTTP/3 (QUIC), pri zlyhaní prejsť na TCP | vypnuté |
--json | Vypísať JSON na stdout (pre skripty a AI agentov) | vypnuté |
Prepínače príkazu get
| Prepínač | Popis | Predvolené |
|---|---|---|
-p, --password P | Heslo na dešifrovanie | interaktívne |
--password-stdin | Načítať heslo zo stdin | |
--password-file F | Načítať heslo zo súboru | |
-o, --output DIR | Výstupný adresár | aktuálny adresár |
--timeout DUR | Časový limit prenosu | žiadny |
--server URL | Server pre samotný token | https://ttl.space |
-h3, --http3 | Skúsiť HTTP/3 (QUIC), pri zlyhaní prejsť na TCP | vypnuté |
--json | Vypí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
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
| Stav | Význam |
|---|---|
401 | Neplatný alebo expirovaný API kľúč |
403 | Funkcia vyžaduje plán Orbit |
404 | Súbor sa nenašiel alebo nepatrí tomuto kľúču |
429 | Prekročený limit požiadaviek |
500 | Vnútorná chyba servera, skúste to neskôr |
502 | Úložisko je dočasne nedostupné, skúste to neskôr |
Limity
| Obmedzenie | Zadarmo | Orbit |
|---|---|---|
| Max. veľkosť súboru | 6 GB | 50 GB |
| Max. TTL | 7 dní | 30 dní alebo natrvalo |
| Nahrania za deň | 4 | Neobmedzene |
| Objem nahrávania za deň (na IP) | 6 GB | Neobmedzene |
| Súbežné nahrávania | 2 na IP | 4 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 hesla | 8 znakov | |
| Požiadavky na IP | 300 za 10 sekúnd | |
| Pripojenia na IP | 100 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ľúča | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Šifra | XChaCha20-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.