TelAnalysis helps you understand your Telegram chat history. It transforms data from your exported chat files into clear charts and graphs. You see patterns in communication, identify key topics, and visualize how your community interacts.
The tool focuses on privacy. It runs locally on your machine, which means your chat data stays on your computer. You keep full control over your information throughout the entire process.
To run TelAnalysis on your Windows computer, you need the following:
- Windows 10 or Windows 11.
- At least 8 gigabytes of RAM.
- A modern web browser like Chrome, Firefox, or Edge.
- A Telegram chat export file in JSON format.
You must visit the project page to download the latest version of the application. The software comes packaged as a convenient installer for Windows.
Visit the releases page to download
- Open the link above in your web browser.
- Find the section labeled Releases on the right sidebar.
- Click the most recent version number.
- Look for the file ending in .exe under the Assets section.
- Click this file to start the download.
- Find the file you downloaded in your Downloads folder.
- Double-click the file to start the installation.
- Follow the prompts on the screen to finish the setup.
- Launch the application from your Start menu or desktop icon.
Before you use the dashboard, you need your chat data. Telegram offers a built-in export feature to help with this.
- Open the Telegram Desktop app on your computer.
- Select the chat you want to analyze.
- Click the three dots icon in the top right corner.
- Select Export chat history.
- Choose the JSON format for the output. This format allows TelAnalysis to read your data accurately.
- Select the path on your computer where you want to save the files.
- Click Export.
Wait for the process to finish. Once done, note the folder location where Telegram saved the files.
- Open TelAnalysis.
- Click the Upload Data button on the main screen.
- Select the folder or files you exported from Telegram.
- Wait for the application to process the information. This might take a few minutes if your chat history is large.
- Once complete, the dashboard loads automatically.
The dashboard displays several panels to help you explore your data:
- Activity Overview: This chart shows when you and other participants talk the most. It highlights busy days and quiet periods.
- Sentiment Tracker: This section analyzes the tone of the conversation. It helps you see if the community feels positive, neutral, or negative about certain topics.
- Word Clouds: This visual tool highlights the most frequent words in your chat. Larger words appear more often in the conversation.
- Network Map: This view displays how people interact with each other. It uses lines to show who talks to whom most frequently.
TelAnalysis runs as a local server on your computer. It does not send your chat logs or personal messages to any external servers. The processing occurs entirely on your hardware. You can safely disconnect your computer from the internet while using this tool to ensure maximum privacy.
If the application fails to load:
- Check your file format: The tool only reads JSON files. If you exported as HTML, you must go back to Telegram and select the JSON option.
- Resource usage: If the dashboard feels slow, close other programs that use a lot of memory.
- Updates: If you experience bugs, check the download link above for a newer version. Developers often release fixes to improve performance.
Does this tool store my messages? No. All data stays on your local drive and disappears when you close the dashboard.
Can I analyze multiple chats? Yes. You can import new data at any time using the settings menu inside the application.
Is this free to use? Yes. This project is open source and free for anyone to use.
What if the application crashes? Restart the application. If the problem continues, delete the temporary cache files in your installation folder and try again.
Where can I report errors? You can visit the main GitHub repository link to open an issue. Provide as much detail as possible about what happened when the crash occurred.
This application uses FastAPI to handle data processing and React to display the visual interface. It employs natural language processing to assign sentiment values to messages. The dashboard uses Echarts for all visual components. This combination of technologies ensures a fast and responsive experience for your data analysis needs.