TG Manager — Uživatelský manuál
Co je TG Manager
TG Manager je aplikace, která čte zprávy z Telegram kanálů a RSS zdrojů, nechá je zpracovat umělou inteligencí (překlad, shrnutí, tagy, hodnocení důležitosti) a vy pak z připravených příspěvků publikujete vybrané do vlastního Telegram kanálu.
Přihlášení
Aplikaci otevřeš na adrese, kde běží, a klikneš Log in. Na obrazovce jsou dva způsoby přihlášení:
| Způsob | Jak to funguje |
|---|---|
| Phone | Zadáš telefonní číslo, pak ověřovací kód. |
| QR code | Naskenuješ QR kód oficiální aplikací Telegram. |
Přihlášení telefonem + kódem
+420 123 456 789.Přihlášení QR kódem
Dvoufázové ověření (2FA)
Pokud máš zapnuté dvoufázové ověření, aplikace tě vyzve k zadání hesla. Heslo najdeš v Telegramu: Settings → Privacy & Security → Two-step verification. U QR přihlášení platí: zadej heslo a naskenuj nově vygenerovaný QR kód znovu.
Flood Wait — dočasný limit
Pokud Telegram zaznamená příliš mnoho pokusů o přihlášení, zobrazí se oranžové varování s odpočtem. Počkej, než odpočet doběhne — opakované pokusy limit prodlužují.
První spuštění — Onboarding
Po prvním přihlášení tě aplikace provede 5 kroky nastavení. Každý krok má progress bar a odemyká se postupně:
| # | Krok | Co nastavíš |
|---|---|---|
| 1 | Add sources | První zdroj (Telegram kanál nebo RSS) |
| 2 | Feed settings | Řazení, relevance, filtr kanálů |
| 3 | AI analysis | Jazyk AI, témata, váhy skórování |
| 4 | Publishing | Cílový kanál, struktura příspěvku, podpis |
| 5 | URL filter | Blacklist nežádoucích URL |
Odblokování: přidej 1 zdroj, spusť Scan — a po prvním úspěšném syncu můžeš přidávat další bez omezení.
Po posledním kroku dokončíš tlačítkem Done — onboarding se zavře a aplikace je připravená na plné publikování (draft editor, média, odesílání).
Hlavní obrazovka (Dashboard)
| Prvek | Co dělá |
|---|---|
| Nastavení | Otevře Nastavení |
| Účet | Popover s účtem, stavem syncu a rychlými akcemi |
| Status tečka | Zelená = připojeno · modrá = sync běží · červená = chyba |
| AI credits | Zůstatek kreditů (⚡ + číslo) |
| Connectors | Panel zdrojů (ikona kamery + počet zdrojů) |
| My channel | Náhled tvého vlastního kanálu (RadioTower) |
| Scan | Spustí synchronizaci |
| Nový draft | Otevře prázdný draft pro nový příspěvek |
Account popover
Na mobilu se ikony hlavičky sbalí do hamburger menu (Account, Settings, Help) a akce feedu se přesunou do spodní lišty (Sources, My channel, Blocked feed, Settings).
Klikni na ikonu Účet vpravo nahoře: vidíš stav připojení, počty SOURCES / MESSAGES / LAST SYNC a tlačítka Account a Log Out.
Přidání zdrojů — Connectors (Telegram + RSS)
Panel zdrojů otevřeš ikonou Connectors v hlavičce. Má dva taby: Telegram a RSS.
Telegram — přidání kanálu
Nebo rychle: do pole napiš @nazevKanaly (např. @Reuters) nebo odkaz t.me/link a potvrď Enterem / tlačítkem +.
RSS — přidání webu
novinky.cz, nebo přímý odkaz na feed.Synchronizace a AI analýza
Nové zprávy stáhneš tlačítkem Scan v hlavičce:
| Situace | Chování |
|---|---|
| Auto Scan vypnutý | Manuální Scan (s krátkým cooldownem po každém běhu) |
| Auto Scan zapnutý | Scan sám v intervalu (5–60 min), tlačítko ukazuje countdown ring |
Co se děje po Scanu
Stavy karet
| Stav | Co vidíš |
|---|---|
| Pending | Modrý spinner „AI RUN" + „Čeká na AI analýzu" |
| Ready | Karta s headline, AI Summary, tagy a skóre |
| Failed | Červená chyba + tlačítko retry |
| Published | Fialové PUBLISHED + odkaz na publikované příspěvky |
Časový rozsah (Time Range)
Pokud je poslední sync starší než 12 hodin (nebo ještě nikdy neproběhl), aplikace se zeptá, jak hluboko do historie má stahovat.
| Situace | Volby |
|---|---|
| První sync | Pouze 6 hodin — feed zůstane malý na první vyzkoušení |
| Běžný sync | 1 / 3 / 6 / 9 / 12 / 24 hodin |
Feed karty a skórování
Anatomie karty
- Levý sloupec — skóre (otočené číslo 0–100). Barva: modrá = pending, červená = failed, fialová = published, zelená = zvýrazněná.
- Zdroj + čas — kanál a datum.
- Headline — nadpis vytvořený AI.
- AI Summary — shrnutí s modrým okrajem.
- URL karty — odkazy z článku.
- Tagy — zelené = tvé téma, šedé = AI tagy bez shody, černé = blokované téma (v Blocked feedu). Kliknutím na tag otevřeš akce — přidat do témat / blokovat / odebrat / odblokovat.
- Dolní lišta — AI STATUS a tlačítka.
Skóre — jak nastavit váhy
Skóre (0–100) je jen vážený součet dvou věcí: jak zásadní zpráva je pro svět(World impact, hodnotí AI) a jak moc sedí na tvoje témata (Topics).
| Preferuješ… | World impact | Topics | Výsledek |
|---|---|---|---|
| Světové události | Maximum | Výchozí | Velké zprávy se zvýrazní zeleně |
| Vlastní témata | 0 | Maximum | Aplikace preferuje tvoje témata |
Koncové doladění: jeden kombinovaný posuvník Relevance → Highlight (Feed). Levý bod skryje zprávy s nízkým skóre (0 = ALL), pravý bod určí, od jakého skóre se karta zvýrazní zeleně. Highlight je vždy alespoň o 30 bodů vyšší než relevance. Pásma na posuvníku: červená = skryté, šedá = viditelné, zelená = zvýrazněné.
Flip — originál vs. AI
Kliknutím na ikonu odkazu kartu otočíš a uvidíš původní text s badge „ORIGINÁL" a odkazem na původní příspěvek.
Akce na kartě
| Akce | Jak |
|---|---|
| View media | Otevře MediaModal |
| Prepare draft | Načte příspěvek do Draft editoru |
| Hide | Skryje kartu (jen lokálně). U sloučené (story) karty schová celou skupinu jako jednu položku — Undo (Ctrl+Z) vrátí všechny varianty zpět |
| Retry | Znovu spustí AI analýzu |
| Blacklist URL | × u URL → přidá do blacklistu |
| Condense | Zkrátí AI shrnutí — 1 kredit cloud / 0 local. Vypnuté u summary kratších než 350 znaků. Jakmile kondenzace existuje, tlačítko jen přepíná kondenzovanou ↔ plnou verzi (zdarma) |
| Tag chip | Kliknutím otevře akce — přidat do témat / blokovat téma / odebrat z témat / odblokovat |
Blocked feed — příspěvky s blokovanými tématy
Příspěvky, které odpovídají blokovanému tématu (a příspěvky bez smysluplného obsahu — AI dá titulku „Not enough context"), se v hlavním feedu nezobrazí. Patří do Blocked feedu, který otevřeš tlačítkem 🛡 (desktop: horní lišta, mobil: spodní lišta; červený badge ukazuje, kolik je jich skrytých). Karty jsou tmavé a tagy blokovaných témat černé. Kliknutím na černý chip téma Odblokuješ nebo přidáš do témat; kartu můžeš i skrýt košem.
Klávesové zkratky
| Klávesa | Akce |
|---|---|
↓ / ↑ | Další / předchozí karta v compact módu |
PageDown / PageUp | První / poslední karta |
Delete | Hide + posun na další |
← / → | Přepnutí varianty na sloučené (story) kartě |
Ctrl+Z | Undo (obnoví skrytou kartu) |
Enter / Tab | Načte kartu do Draftu |
Ctrl+Enter | Publikuje |
Story cards — sloučené příspěvky
Když více zdrojů (Telegram i RSS) přinese stejnou událost, aplikace je sloučí do jedné karty — feed se nezahltí duplicitami. Sloučená karta má fialový badge ★ N variant(y).
| Prvek | Co dělá |
|---|---|
| ★ N variant(y) | Fialový badge v hlavičce karty — kolik zdrojů událost přineslo. V compact módu je to fialový kroužek s číslem před košem. |
| Publish verze (kompozit) | Výchozí pohled (tlačítko s hvězdičkou mezi avatary): text z nejlépe hodnocené varianty + média z varianty s nejvíce médii. Tohle je verze, kterou tužkou ✏️ pošleš do draftu. |
| Avatary kanálů | Každá varianta má avatar svého zdroje; kliknutím přepneš na originální zprávu daného kanálu. Hvězdička vrací zpět na kompozit. Klávesami ← / → procházíš varianty stejně. |
| Akce | Co dělá |
|---|---|
| Rozpojit skupinu | Když aplikace omylem sloučila dvě různé události — rozpojí skupinu na samostatné karty; tahle dvojice se už nikdy nespojí. |
| Hide | Schová celou skupinu jako jednu položku; Undo (Ctrl+Z) vrátí všechny varianty zpět. |
| Vypnutí slučování | Nastavení → Feed → Story cards (default ON) — sloučené karty se rozpadnou na jednotlivé příspěvky. |
Publikování (Draft)
Klikni na tužku (Prepare draft) na kartě, nebo Nový draft v hlavičce. Otevře se panel Draft zprava:
| Sekce | Co dělá |
|---|---|
| Média | Správa médií z původní zprávy + vlastní soubory |
| Text | Headline, editor, AI/Original, Topics, URL |
| Publish to | Výběr cílového kanálu (per-post override) |
| Pending High-Priority | Fronta důležitých čekajících zpráv — rychlé LOAD |
AI zpracování textu
Tlačítko ✏️✨ v hlavičce Text sekce je kontextové:
| Volba | Výsledek |
|---|---|
| Translate only | Plný překlad + headline, tagy, URL |
| Summarize | Stručné shrnutí + headline, tagy, URL (vytvoří AI Compact i AI Full) |
Načtení z odkazu (ikona Download ⬇️)
Ikona ⬇️ v hlavičce Text sekce otevře pole LOAD FROM LINK. Vlož odkaz a klikni Load — aplikace sama pozná, o co jde:
https://t.me/kanal/12345 → Telegram (beze změny): stáhne zprávu rovnou do draftu — užitečné pro vlastní starší příspěvky.Publikování
URL z příspěvku
V Nastavení → Publishing nastavíš, jestli a jak se odkazy článku vytisknou do publikovaného příspěvku. V režimech Numbered / Domain / Template cestují skutečné URL uvnitř odkazové entity Telegramu, takže se nepočítají do limitu 4096/1024 znaků – počítá se jen viditelný popisek. Režim Full vytiskne každou URL jako prostý viditelný text a limit tím spotřebovává.
Překlad a titulkování videa přes SublyAI (Beta)
Chceš k videu z feedu přidat titulky nebo překlad? TG Manager se propojuje s aplikací SublyAI (samostatná aplikace) přes bezpečné postMessagespojení — video odešleš k překladu a titulkované video se ti vrátí zpět do draftu.
SUBLYAI_HANDOFF_URL (výchozí: lokální vývojová instance).Zpět v TG Manageru:
| Odesláno z… | Co se stane |
|---|---|
| Editoru draftu (MediaManager) | Titulkované video se objeví rovnou v MediaManageru (bez tlačítka SublyAI). |
| Prohlížeče ve feedu (MediaModal) | Modal zůstane otevřený, krátce zobrazí načítání Loading translated video… a pak odhalí vrácené video se zeleným tlačítkem Use translated video. Zavření modalu, dokud je přeložené video přítomné, se zeptá, zda ho zahodit, nebo použít v aktuálním příspěvku. |
Use translated video otevře vydavatele na AI view, přidá titulkované video do MediaManageru (opět bez tlačítka SublyAI) a vyloučí původní video, pokud ho lze přesně identifikovat. Tak publikuješ čistě titulkované video. Pokud původní nelze jednoznačně určit (např. album), zůstane vše živé a ty si v MediaManageru ručně vybereš, která média ponechat (tlačítko Remove/Restore na každé položce).
Kde co najít
Nastavení otevřeš ikonou ⚙️ v hlavičce, přes Account popover nebo ze stránky Account. Panel má 5 sekcí:
FEED
| Nastavení | Co dělá |
|---|---|
| Relevance → Highlight | Skrytí pod relevance (0 = ALL) → zelené zvýraznění; highlight ≥ relevance + 30 |
| Source / Order / Sort by score | Filtr zdrojů, řazení, řazení podle skóre |
| Compact mode / Show media | Kompaktní seznam / náhledy médií |
| Story cards | Sloučí příspěvky o stejné události do jedné karty (default ON). Vypnutí ukáže každou variantu zvlášť |
| Auto-open compact card | Po skrytí karty nebo publikování automaticky rozbalí další kartu (default OFF). Vypnuto = feed zůstane sbalený |
| Auto Scan | Automatická synchronizace (5–60 min) |
AI
| Nastavení | Co dělá |
|---|---|
| AI Output Language | Jazyk všech AI výstupů — 100+ jazyků. Select s hledáním: piš název nebo kód (funguje i cz, jp, ua) |
| World impact weight | Váha AI hodnocení světové důležitosti |
| Relevance weight | Body za každý topic |
| Topics | Tvé témata — chips (max 20) |
| Topics | Blocked topics | Topics = co chceš číst (zelené chips). Blocked = co nechceš vidět vůbec — příspěvky s tímto tématem mizí do Blocked feedu (viz Feed a skóre). Vzájemně vyloučené s Topics, max 20. Zkratka: klik na tag chip → Block |
| Suggest topics | AI doporučí nová témata z kanálu |
PUBLISHING
| Nastavení | Co dělá |
|---|---|
| Target Channel | Kanál, do kterého se publikuje |
| Headline symbol / List symbol | Symbol před headline (jen bez médií) · náhrada odrážek |
| Publish headline / Show source | Headline tučně · odkaz na originál |
| Signature | Vlastní podpis (tučné, kurzíva, odkazy) |
| Link preview TG/RSS + Hide after publish | Náhled odkazu · skrytí karty po publikaci |
| Publish guard | Upozorní, když cílový kanál už obsahuje podobný příspěvek (téměř identický text nebo sdílená URL se označí jako duplicita) – default ON |
| Block on duplicate | Zastaví publish při nalezení duplicity – po vypnutí se modal ukáže jen informačně a publish nikdy nezastaví (default ON) |
| URLs from post | Přepínač – když je ON, přidají se zdrojové URL příspěvku (výchozí ON). OFF = žádné URL z pole url |
| URL display mode | Jak se URL zobrazí (výchozí Numbered): Full (každá URL na vlastní řádek, počítá se do limitu) · Numbered ([1][2]… za textem, URL skryté v entitě odkazu – nepočítají se) · Domain (domény na jeden řádek, URL skryté) · Template (tvoje štítky se slovem [word], ke kterému se přidá číslo, URL skryté) |
| URL template | Jen pro režim Template – výchozí 🔗 Source: [link]; slovo v […] je základ, ke kterému se připojí číslo (můžeš přeložit/upravit) |
BLACKLISTED URLS a OTHER
Blacklisted URLs — blokuje nežádoucí URL (substring-based). Other — Model Provider (Google Gemini vs Local LM Studio/Ollama), diagnostika a App Reset.
Účet a kredity
Stránku účtu otevřeš: hlavička → ikona uživatele → Account.
| Sekce | Obsah |
|---|---|
| Telegram | User ID, status, připojení cloudu |
| Credits & Usage | Graf spotřeby (30 dní) + Log kreditů |
| Quick actions | Settings, Export dat, App Reset, Log Out, Delete |
Jak fungují kredity
GDPR / data
| Akce | Co udělá |
|---|---|
| Download My Data | JSON export všech tvých dat (GDPR) |
| Delete My Account | Natrvalo smaže účet i lokální data — nelze vrátit |
| Log Out | Jen vymaže přihlášení v tomto prohlížeči |
Troubleshooting a tipy
Přihlášení
| Problém | Řešení |
|---|---|
| „Kód nepřišel" | Kód je jen v oficiální aplikaci Telegram (service chat) |
| „Flood Wait" | Počkej na odpočet — opakování limit prodlužuje |
| QR nefunguje | Počkej na obnovení QR · u 2FA naskenuj nový QR |
Zdroje (RSS)
| Problém | Řešení |
|---|---|
| „Nenašli jsme feed" | Zkus jinou doménu nebo RSSHub |
| Bot-blocked web | Aplikace automaticky zkusí Google News fallback |
AI
| Problém | Řešení |
|---|---|
/chat/completions → 404 | Aplikace doplní /v1 sama |
| CORS u lokální AI | Povol CORS pro přesný origin (Vercel / localhost) |
| Model vrací neplatný JSON | Zvol model s lepší JSON podporou, nebo Gemini |
Feed
| Problém | Řešení |
|---|---|
| Dva příspěvky se sloučily do jedné karty | Je to Story card — varianty přepínáš avatary nebo šipkami ←/→; omylem sloučené události rozpojíš „Rozpojit skupinu“. Slučování vypneš v Nastavení → Feed → Story cards |
| Proč mají varianty stejný titulek? | AI překládá všechny zdroje téže události do stejného jazyka — titulky se sjednotí, ale detaily v textu se liší. Kompozit (★) spojuje nejlepší text s nejbohatšími médii |
| Kam zmizely příspěvky o blokovaném tématu? | Jsou v Blocked feedu — otevřeš ho tlačítkem 🛡 (desktop: horní lišta, mobil: spodní lišta). Téma odblokuješ kliknutím na černý chip → Unblock |
| Jak blokovat téma? | Klikni na tag na kartě → Block, nebo Nastavení → AI → tab Blocked |