Welcome to the BlissRoms Telegram Bot project! This bot is designed to provide the BlissRoms community with easy access to information about officially supported devices and download links from SourceForge for both vanilla and gapps versions of BlissRoms.
- List officially supported devices for BlissRoms.
- Provide download links for vanilla and gapps versions of BlissRoms from SourceForge.
- User-friendly interface for quick access to information.
- Auto-deletes long messages in private chats and groups (with permission) to avoid cluttering the chat.
To use the BlissRoms Telegram Bot, follow these steps:
-
Invite the Bot: Add the bot to your Telegram group or send it a direct message. You can find the bot by searching for its username in Telegram:
@blissrom_bot
. -
Commands: Use the following commands to interact with the bot:
/start
: Get a welcome message and an overview of available commands./help
: Get a help message about the available commands./list
: View the list of officially supported devices for BlissRoms./bliss [device]
: Get the download links for the specified device./refresh
: Authorized users' only command. Refreshes the locally cached devices.json file.
- To view the list of supported devices:
/list
- To get download links for a specific device:
/bliss obiwan
- Install Python for your distribution
- Run the following command to install pipenv:
pip/pip3 install pipenv
- Clone this repository:
git clone https://github.com/SoapDev2018/BlissRoms_Bot BlissRoms_Bot
- Go into the directory:
cd BlissRoms_Bot/
- Let pipenv install the dependencies (in a virtual environment):
pipenv install
- Rename
sample_config.yml
toconfig.yml
and fill in the values (described below) - Run a pipenv shell:
pipenv shell
and then:python bliss.py
. Alternatively:pipenv run python bliss.py
api_id
: Your Telegram API_ID (from https://my.telegram.org)api_hash
: Your Telegram API_HASH (from https://my.telegram.org)bot_token
: Your bot's token (from https://telegram.dog/BotFather)authorized_ids
: Authorized users, who can use the/refresh
commanddownload_url
: BlissRoms' download URL; do not modify unless you know what you're doing!user_agent
: Custom User-Agent to send to the download serverdefault_user_agent
: The default UA passed, ifuser_agent
is not definedgroup_ids
: Authorized Telegram chats, leave blank to allow all chats
Contributions to this project are welcome! If you'd like to contribute, follow these steps:
- Fork the repository.
- Create a new branch for your changes:
git checkout -b feature/new-feature
- Make your changes and commit them:
git commit -m "Add new feature"
- Push it back up to GitHub:
git push origin feature/new-feature
- Create a pull request from your branch to the main repository.
This project is licensed under the MIT License.
If you have any questions or feedback about the BlissRoms Telegram Bot, you can reach out to the team on Telegram or create an issue in this repository.
Happy chatting and downloading BlissRoms!