https://github.com/karlicoss/telegram2org

Tool to create TODO tasks from Telegram messages in one tap
https://github.com/karlicoss/telegram2org

org-mode orger productivity telegram todo

Last synced: 3 days ago
JSON representation

Tool to create TODO tasks from Telegram messages in one tap

• Host: GitHub
• URL: https://github.com/karlicoss/telegram2org
• Owner: karlicoss
• Created: 2018-06-12T23:06:48.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-10-11T00:02:56.000Z (about 1 year ago)
• Last Synced: 2024-05-30T01:15:25.214Z (5 months ago)
• Topics: org-mode, orger, productivity, telegram, todo
• Language: Python
• Homepage: https://beepb00p.xyz/orger-todos.html
• Size: 39.1 KB
• Stars: 17
• Watchers: 4
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.org

Awesome Lists containing this project

README

        
# -*- org-confirm-babel-evaluate: nil; -*-

* Description

#+begin_src python :exports results :results output drawer replace :python "with_secrets python3"

import telegram2org; print(telegram2org.__doc__)

#+end_src

#+name: telegram2org_doc

#+RESULTS:

:results:

Imagine a friend asked you for something, or sent you a link or a video, but you don't have time to process that right at the moment.

Normally I'd share their message to my TODO list app so I can process it later.

However, official Android app for Telegram doesn't have sharing capabilities.

This is a tool that allows you to overcome this restriction by forwarding messages you want to

remember about to a special private channel. Then it grabs the messages from this private channel and creates TODO items from it!

That way you keep your focus while not being mean ignoring your friends' messages.

:end:

* Setting up

** Setup for telegram2org

#+begin_src bash

  # Install dependencies

  pip install -r requirements.txt

  # Configure

  cp config.py.example config.py

  edit config.py # follow comments in the file to set up

#+end_src

** Creating your "Todos" empty group

   Telegram requires you to add at least one person in a new group. To satisfy this requirement and also avoid spamming a random contact, you can [[https://www.reddit.com/r/Telegram/comments/l4p5me/how_to_create_a_groupchat_without_adding_any/][add a bot instead]].

   I don't know of any no-op bots around waiting to be added, but you can create your own bot. I'll summarize the process, based on the [[https://core.telegram.org/bots#3-how-do-i-create-a-bot][bot documentation]] page:

   - open a chat with [[https://t.me/botfather][@BotFather]]

   - send it these two simple commands

   #+begin_src

   # Start the bot creation flow

   /start

   # Create a new bot

   /newbot

   # Enter a name for your bot, ending in "...Bot" and you're done.

   # Here's a python username gen: pip install random-username; random_username

   #+end_src

   Now you can create your group by inviting your newborn bot. You can also remove the bot from the group after this process.

* Running

#+begin_src bash

  ./telegram2org.py

  # Please enter your phone (or bot token): +1123567890

  # Please enter the code you received: 12345

#+end_src

The telegram client will ask for your phone number. After you enter the number, you'll receive a verification code in your Telegram app. Use that code in the second prompt.

* Dependencies

- [[https://telethon.readthedocs.io/en/latest][Telethon]] as Telegram clinet

- [[https://github.com/karlicoss/orger][Orger]] for rendering