Skip to content

agentHits/telelore

 
 

Repository files navigation

TeleLore

TeleLore is a free, open-source Telegram export to NotebookLM converter. It turns a Telegram Desktop result.json chat history into clean Markdown (.md) chunks that can be uploaded to Google NotebookLM as sources.

Built for huge Telegram chats, pet-project writeups, research communities, work archives, and any chat history you want to query with NotebookLM.

Live app

What it does

  • Converts Telegram Desktop JSON exports into NotebookLM-ready Markdown files.
  • Splits large chats by word budget: 50k to 500k words per .md file.
  • Keeps useful message context: date/time, author, forwards, reactions, polls, and media metadata.
  • Runs in a browser Web Worker, so the UI stays responsive while processing big JSON files.
  • Creates one ZIP archive with all .md chunks plus a small README.
  • Does not upload your chat anywhere. Processing is local in the browser.

Why Markdown for NotebookLM

NotebookLM supports many file types, including pdf, txt, md, docx, csv, pptx, epub, images, audio, and video. For Telegram chats, Markdown is the simplest source format: it stays readable, searchable, easy to split, and light enough for large text histories.

How to export from Telegram

  1. Open Telegram Desktop.
  2. Open the chat or channel.
  3. Choose Export chat history.
  4. Select Machine-readable JSON.
  5. Export and use the generated result.json in TeleLore.

Local development

npm install
npm run dev

Open http://localhost:3000.

Verification

npm run lint
npm run typecheck
npm run test
npm run build

To run the real large-export test locally, set a path to a Telegram Desktop result.json:

$env:TELELORE_SAMPLE_JSON="C:\Users\bahti\Downloads\Telegram Desktop\ChatExport_2026-04-29 (1)\result.json"
npm run test

Tech stack

  • Next.js App Router
  • React
  • TypeScript
  • Tailwind CSS
  • JSZip
  • Vitest
  • Vercel

SEO keywords

Telegram export to NotebookLM, Telegram JSON converter, Telegram chat to Markdown, result.json to md, Google NotebookLM sources, Telegram history converter, NotebookLM Markdown chunks.

License

MIT

About

Free local Telegram JSON to Google NotebookLM Markdown converter

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 87.3%
  • CSS 11.7%
  • JavaScript 1.0%