Telegram Status (Game Activity Monitor)

English

Türkçe

Description (Supports Windows & Linux)

Telegram Game Status is a Python application that monitors the games you're playing on your computer and automatically updates your Telegram profile status accordingly. With this app, you can showcase your gaming activity to your Telegram contacts, letting them know which game you're currently playing and for how long you've been playing it.

A total of 551 games are supported! Click here (windows) or here (linux) to see the games!

1. Requirements

Firstly, clone the poject to your computer:

git clone https://github.com/phaticusthiccy/Telegram-Activity && cd ./Telegram-Activity

The following libraries are required for the project to run:

• asyncio
• psutil
• tkinter
• telethon
• python-dotenv
• pillow
• requests
• sv_ttk

You can install these dependencies using the requirements.txt file:

pip install -r requirements.txt

2. Environment Variables

To ensure the project runs correctly, you need to set certain environment variables. Copy the sample.env file to .env and fill in the required values:

The following environment variables are required for the application to function correctly:

API_ID: Your Telegram API ID, which is required for authenticating with the Telegram API.

API_HASH: Your Telegram API hash, which is also required for authentication.

DEFAULT_BIO: The default biography that will be set as your Telegram profile status when you're not playing any games.

⚠ Just edit these 3 variables! If you do not know the other variables, please do not change or delete them!

cp sample.env .env

After copying it, start the edit file with this command:

nano .env

3. Usage

To run the GUI application, use the gui.py file:

python gui.py

or

py gui.py

Demo

Before (When you close the game, your bio will be replaced with the default bio!)

After

Contributing

If you want to contribute, please send a pull request or open an issue. Any contributions are welcome!

You can create a request for a new game by clicking here!

⚠ Note :: This project is still in development, so there might be some bugs. Please report them if you find any. Also if you wan to add more games to the game list use method below. Make changes, create pull request and I'll merge it if its ok!

{
    "actual_process_name": ["real game name", "keyword 1", "keyword 2", "keyword n..", "actual_process_name"],
    "my_game.exe": ["My Awsome Game", "awsome game", "mygame", "my_game.exe"]
}

License

This project is licensed under the MIT License.

Quick Start (Windows Desktop Shortcut)

You don't need to open the command line and enter a lot of code every time to run the project! Learn how to create a desktop shortcut by clicking here!

Quick Start (Linux Desktop Shortcut)

You don't need to open the command line and enter a lot of code every time to run the project! Learn how to create a desktop shortcut by clicking here!

Troubleshooting

If you encounter any issues while using the application, you can try the following troubleshooting steps:

1. Check Environment Variables

Ensure that you have correctly set the required environment variables (API_ID, API_HASH, and DEFAULT_BIO). Double-check the values and make sure they are correct.

2. Check Telegram Connection

Make sure you have an active internet connection and that the Telegram servers are accessible. You can try sending a message to another Telegram user or group to verify your connection.

3. Check Game List

If the application is not detecting a game you're playing, ensure that the game is included in the process_mapping.json file. If not, you can add it by following the instructions in the "Contributing" section.

4. Check Permissions

On some systems, the application may require additional permissions to monitor running processes. Try running the application with administrative privileges.

5. Check Logs

The application logs errors and warnings to the console. Check the console output for any error messages or warnings that may provide clues about the issue you're facing.

6. Update Dependencies

Ensure that you have the latest versions of the required dependencies installed. You can update them by running the following command:

pip install -r requirements.txt --upgrade

7. Fix High CPU Usage

CPU usage may be high for 10-30 seconds after the application runs. This may occur because the application is running in a way that requires access to games. Do not worry!

This situation is only temporary. CPU usage will drop within 1 minute. If a persistently high CPU usage occurs, follow the steps here!