https://github.com/phaticusthiccy/telegram-activity
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.
https://github.com/phaticusthiccy/telegram-activity
activity game game-monitor telegram-api telegram-desktop telegram-status telethon
Last synced: 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/phaticusthiccy/telegram-activity
- Owner: phaticusthiccy
- License: mit
- Created: 2024-05-29T14:49:31.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-01T16:38:05.000Z (3 months ago)
- Last Synced: 2025-04-01T17:47:16.932Z (3 months ago)
- Topics: activity, game, game-monitor, telegram-api, telegram-desktop, telegram-status, telethon
- Language: Python
- Homepage:
- Size: 1.75 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Telegram Status (Game Activity Monitor)
[
English](README.md)
[
Türkçe](README.tr.md)
## 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 970 games are supported! Click [here (windows)](https://github.com/phaticusthiccy/Telegram-Activity/blob/master/games/games.csv) or [here (linux)](https://github.com/phaticusthiccy/Telegram-Activity/blob/master/games/games_linux.csv) to see the games!
## 1. Requirements
Firstly, clone the poject to your computer:
```bash
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`
- `matplotlib`
- `GPUtil`
- `numpy`
You can install these dependencies using the [`requirements.txt`](./requirements.txt) file:
```bash
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!
```bash
cp sample.env .env
```
After copying it, start the edit file with this command:
```bash
nano .env
```
## 3. Usage
To run the GUI application, use the gui.py file:
> ```bash
> python gui.py
> ```
> or
> ```bash
> 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!](https://github.com/phaticusthiccy/Telegram-Activity/issues/new?assignees=phaticusthiccy&labels=enhancement%2C+game+request&projects=&template=new-game-request.md&title=%5BREQUEST%5D+New+Game+Request)
⚠ 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!
```json
{
"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](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](https://github.com/phaticusthiccy/Telegram-Activity/wiki/How-to-Create-Windows-Desktop-Shortcut)!
## 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](https://github.com/phaticusthiccy/Telegram-Activity/wiki/How-to-Create-Linux-Desktop-Shortcut)!
## 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`](./games/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:
```bash
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!](https://github.com/phaticusthiccy/Telegram-Activity/wiki/High-CPU-Usage-Solution)