Git Product home page Git Product logo

telegram-voice-message-duration-reporter's Introduction

telegram-voice-message-duration-reporter

Reads Telegram conversations exported to JSON and builds a CSV file with a report on total duration of voice messages on a per user per day basis.

Why?

This is a real-world project. The requirement is to be able to produce visual graph reports of students' engagement measured by the length of voice messages they exchange with their tutors over the Telegram app.

Prerequisites

  • Python 3
  • Telegram Desktop

Usage

As standalone script

  1. Export conversations in the JSON format with Telegram Desktop

  2. Put the exported result.json file and the reporter.py script in the same directory

  3. On Windows simply double click reporter.py. On Unix systems open a terminal and run

    ./reporter.py
  4. This will generate a CSV file in the same directory with the following name pattern: report.<timestamp>.csv.

Sample report

Sample report screengrab

As local server

One time setup:

python3 -m venv virtual_env
. virtual_env/bin/activate
pip install -r requirements.txt

Run the server:

python app/main.py

Open http://localhost:5000 and upload result.json.

As Docker cointainer

docker build -t telegram-voice-message-duration-reporter:latest .
docker run -d -p 5000:5000 telegram-voice-message-duration-reporter:latest

Open http://localhost:5000 and upload result.json.

telegram-voice-message-duration-reporter's People

Contributors

chris-kobrzak avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Forkers

craziks-creator

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.