https://github.com/ash-codes18/telegram-bot
A multi usage telegram bot written in python using pyrogram
https://github.com/ash-codes18/telegram-bot
anime-api beautifulsoup4 colab-notebook github google-colab leech-bot multi-use music pexels-api piratebay pyrogram spotify telegram-bot videos youtube yt-dlp
Last synced: about 2 months ago
JSON representation
A multi usage telegram bot written in python using pyrogram
- Host: GitHub
- URL: https://github.com/ash-codes18/telegram-bot
- Owner: Ash-codes18
- License: mit
- Created: 2023-12-09T13:02:17.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-13T18:39:00.000Z (over 1 year ago)
- Last Synced: 2025-03-28T22:51:11.074Z (2 months ago)
- Topics: anime-api, beautifulsoup4, colab-notebook, github, google-colab, leech-bot, multi-use, music, pexels-api, piratebay, pyrogram, spotify, telegram-bot, videos, youtube, yt-dlp
- Language: Python
- Homepage: https://t.me/ashmulti_bot
- Size: 305 KB
- Stars: 6
- Watchers: 2
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ใ A Pyrogram based Telegram Bot with multiple features. Access the Live Demo at Botใ
## **๐ก Features**
- Easy To Use With Bot Commands.
- Audio and Video Download support for YouTube and 2000 More Sites ๐
- Search Youtube and Spotify
- Download Songs
- Search Github
- Search Google, Bing, DuckDuckGo, Yandex and the entire web
- Search Images from Google, Bing, DuckDuckGo, Yandex and the entire web
- Search Unsplash and Pexels for images
- Search Pexels for Videos
- Search The Piratebay for Torrents.
- Get several category anime images
- Get image posts from reddit
- And many more...๐ฅ
## **๐ Bot Setup**
To set up this bot, you need to provide your bot credentials, API keys, and other necessary details. Here are the steps:
1. Replace `api_id`, `api_hash`, and `bot_token` with your bot's credentials.
2. Replace `api_key` with your YouTube Data API v3 key.
3. Replace `client_id` and `client_secret` with your Spotify API credentials.
4. Replace `UNSPLASH_ACCESS_KEY` with your Unsplash API access key.
5. Replace `PEXELS_API_KEY` with your Pexels API key.
6. Replace `GAPI_KEY` with your Google Custom Search Engine API key.
7. Replace `SEARCH_ENGINE_ID`, `BING_ENGINE_ID`, `YANDEX_ENGINE_ID`, `DDG_ENGINE_ID`, and `WEB_ENGINE_ID` with your Google Custom Search Engine IDs.
### **๐ฆ Optional**
8. Add Subreddits of your choice for the `/reddit` and `/mreddit` commands
9. Replace `THEPIRATEBAY_URL` with any ThePirateBay URL of your choice or leave as is.
10. Specify count for number of media to send for and search and upload modules as per your requirement.
## **๐ How to Deploy?**
#### **๐ค Bot Commands To Set ยป**
```
start - To get the list of available commands ๐ง.
ping - To check if I am alive ๐ฒ.
general - to get the most used commands ๐ฅ.
anime - to get all anime related commands ๐.
browse - to get all web searching commands ๐.
meme - to get a meme ๐.
reddit - to get something from reddit ๐.
manymeme- to get many memes ๐คก.
mreddit - to fetch many things from reddit ๐.
quote - to get an anime quote ๐.
mquote - to get many anime quotes ๐ง.
```
__NOTE: Bot will work in both private and group chats, so Feel free to add the bot in groups!__
#### **โ๏ธ About The Credentials ยป**
- `API_ID` ยป Your Telegram API ID, Can Be Found [Here.](https://my.telegram.org/auth)
- `API_HASH` ยป Your Telegram API HASH, Can Also Be Found [Here.](https://my.telegram.org/auth)
- `BOT_TOKEN` ยป Create a Telegram Bot From [Here](https://t.me/BotFather), Then Paste The Bot Token
#### **๐ป Local Machine ยป**
1. Open Terminal
2. Clone the repository by running the command
```bash
git clone https://github.com/ash-codes18/Telegram-bot
```
3. Enter the directory by running `cd Telegram-bot`
4. Now, run the following command: `pip install -r requirements.txt`
5. Fill in your details in a `main.py` file as given in the [Bot Setup](https://github.com/Ash-codes18/Telegram-bot#-bot-setup)
6. Run the bot using `python3 main.py`
#### **๐ On Google Colab ยป**
C O M I N G S O O N
## **๐ฅ Benefits**
- No need of VPS or RDP use locally or directly on Google Colab.
- Immersive Network speed in Google Servers
- Unlimited Storage in Telegram
- Upload Files of size up to 2000 MB
## **๐จ Usage**
To use this bot, simply start a chat with it and use the commands as described in the Start Message.
## **๐ Contributing**
Contributions are welcome! Please feel free to submit a pull request.
## โ๏ธ**License**
This bot is licensed under the MIT License.
## **๐ค๐ผ Connect With Me**
Please Leave a ๐ If this repo Helped you