Skip to content

converter from telegram json to jekyll md

License

Notifications You must be signed in to change notification settings

la-ninpre/tg2md

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tg2md

This script parses output from Telegram channel and converts each post to jekyll-applicable post in markdown.

Telegram Desktop creates JSON file, as well as different directories containing multimedia, photos, etc. This script creates new directory and populates it with formatted posts ready to publish.

basic usage

Firstly you need to export your channel history from Telegram Desktop app. This could be done from three dots menu. Then popup menu appears, where you can choose what data you want to export. The script currently supports only photos, voice messages and audio files.

tg-export

In format menu you should specify 'Machine-readable JSON' file and then locate to directory of your desire.

To convert your posts to markdown files you need to run tg2md.py program which takes path to your result.json file as first argument.

$ python tg2md.py path/to/result.json

By default it will create formatted_posts directory in your current directory and populate it with markdown files. If you want to specify other location, use --out-dir flag

$ python tg2md.py result.json --out-dir path/to/post/output

Also if your jekyll directory storing media files in folders other than photos and files, you should specify their location with --photo-dir and --media-dir flags respectively. Note that they only change links in the markdown files.

todo's

  • replies
  • single/muliple tags
  • forwarded posts
  • custom post header