social-2-telegram

A CLI tool for reposting artworks from social media to Telegram.

Highlights

• 🌎 Multiplatform support: 𝕏, FurAffinity
• 👥 Artists w/ multiple handles
• 🖼️ Multiple images from one post
• 🔖 Additional hashtags on top of the original post's hashtags
• 🆔 Getting artists' usernames from handles
• 🧩 Support external extensions
• 🧬 Extensible: add more platforms by implementing PlatformBase class

Requirements

• Python 3.10+
• pipenv

Installation

• Clone this repository
• Install pipenv if you haven't

  pip install pipenv

• Install dependencies

  pipenv install

Configuration

• Rename config.example.yaml to config.yaml

• Configure Telegram bot API first

  • If you haven't had a bot, create one using BotFather

  • If you already have one, here's how to get the API

  • Place the API in bot_api_key in config.yaml, ignore the chat_id for now (we'll get to that in the next step)

• Configure Telegram chat ID

  • Chat id between you and the bot

    • Set chat_id in config.yaml to empty

      chat_id: ""

    • Run the app

      pipenv run py main.py

    • Send /id to the bot in Telegram
    • The chat id will be messaged back to you

  • Chat id between a channel and the bot: you can use the channel's handle directly

    chat_id: "@your_channel_username"

• Extensions:
  • For 𝕏, use crxextractor or CRX Extractor/Downloader to download Old Twitter Layout (2023) as .crx file; place it in ./local_data/extensions/ folder.
  • Optional: uBlock Origin

Logging in to sites

• Run the app

  pipenv run py main.py

• Logging in, e.g. 𝕏

  |=====[ Enter post url or [/login example.com] ]=====|
  🍨 /login twitter.com