Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cezary924/telegram-bot
Multifunctional Python Telegram Bot
https://github.com/cezary924/telegram-bot
bot cezary924 python telegram telegram-bot
Last synced: 11 days ago
JSON representation
Multifunctional Python Telegram Bot
- Host: GitHub
- URL: https://github.com/cezary924/telegram-bot
- Owner: Cezary924
- License: mit
- Created: 2023-04-14T11:14:03.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-24T08:25:24.000Z (about 1 month ago)
- Last Synced: 2024-10-17T03:09:37.073Z (22 days ago)
- Topics: bot, cezary924, python, telegram, telegram-bot
- Language: Python
- Homepage:
- Size: 475 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Telegram Bot
🤖
Multifunctional Telegram Bot
## ✨ Main features
- Video downloader ⬇️ (TikTok, Twitter (X), Tumblr, Reddit, YouTube & Instagram)
- Reminders 🔔
- Unit converter 🧮
- Guess Top Spotify Artist ᯤ
- Crystal ball 🔮
- Multilingual responses 🌐 (English & Polish)
- User management 🙋♀️🙋♂️ (Changing roles & Deleting data)
- Device status management ⚙️ (Shutdown & Restart)
## ⚙️ Installation & Configuration
1. Clone this repo.
2. Install required libraries with this code:
```
pip install -r requirements.txt
```
3. Create:
- ```config.yaml``` file in *files* folder and write following code to it:
```
bot_name: your_bot_name
github_repo: your_github_repo_name
github_username: your_github_username
telegram_username: your_telegram_username
```
- ```tokens.yaml``` file in *files* folder and write following code to it:
```
telegram: your_telegram_token
telegram_beta: your_another_telegram_token
rapidapi: your_rapidapi_token
spotify_id: your_spotify_client_id
spotify_secret: your_spotify_client_secret
```
> RapidApi for TikTok media: you have to subscribe to https://rapidapi.com/maatootz/api/tiktok-full-info-without-watermark
> RapidApi for Twitter (X) media: you have to subscribe to https://rapidapi.com/JustMobi/api/twitter-downloader-download-twitter-videos-gifs-and-images
> Spotify Tokens: you have to create an app in the Spotify Developer Dashboard https://developer.spotify.com/dashboard
## 🚀 Starting
1. To start, execute this command in the main directory:
```
python bot/bot.py
```
> You can also add ```beta``` argument at the end of the command shown above to use secondary Telegram token.
2. Enjoy!
## 🧑💻 Basic commands
- ```/start``` - to start conversation with the Bot.
- ```/features``` - to check all Bot features list.
- ```/help``` - to get info about available commands.
- ```/about``` - to get info about the Bot and its Creator.
- ```/settings``` - to get info about available settings.
- ```/admin``` - _(hidden command)_ to get access to the Admin Menu.
- ```/reminder``` - to be reminded of specific events.
- ```/unitconverter``` - To convert common units of measurement.
- ```/tiktok``` - to download video from TikTok.
- ```/twitter``` - to download video from Twitter (X).
- ```/tumblr``` - to download video from Tumblr.
- ```/reddit``` - to download video from Reddit.
- ```/youtube``` - to download video from YouTube.
- ```/instagram``` - to download video from Instagram.
- ```/crystalball``` - to answer your question.
- ```/topspotifyartist``` - to guess one of the top Spotify artists.
- ```/contact``` - to contact the Admin/Creator.
- ```/report``` - to report an issue to the Admin.